chore: add project memory at .claude/memory, document convention in CLAUDE.md

- Create .claude/memory/ as canonical project memory location
- Add MEMORY.md index and first entry: TODO for inter-agent JSON schema
- Document project memory convention in CLAUDE.md (path, format, commit policy)
This commit is contained in:
Bryan Ramos 2026-04-01 22:13:18 -04:00
parent e9262c6aca
commit 41c31a2a85
3 changed files with 22 additions and 0 deletions

5
.claude/memory/MEMORY.md Normal file
View file

@ -0,0 +1,5 @@
# Project Memory
Index of persistent memory for the agent-team project.
- [TODO: inter-agent JSON schema](todo_inter_agent_schema.md) — formal typed schema for all inter-agent messages to replace freetext signals

View file

@ -0,0 +1,11 @@
---
name: TODO — formal JSON schema for inter-agent communication
description: Planned work to replace informal signal/text conventions with a typed JSON schema for all inter-agent messages
type: project
---
Define a formal JSON schema for all inter-agent communication in the agent team.
**Why:** Current protocol relies on freetext signals (RFR, LGTM, REVISE, VERDICT: PASS, etc.) and unstructured prose output. A typed schema would make messages machine-readable, easier to validate, and more reliable for orchestrator parsing — especially as parallelism increases and the orchestrator is managing multiple concurrent agent outputs.
**How to apply:** Design the schema before any further changes to the orchestrate skill or agent protocols. All agent output formats (reviewer verdict, auditor verdict, worker RFR, architect triage response, etc.) should conform to it. Consider whether the schema lives as a skill, a standalone JSON Schema file, or embedded in agent frontmatter.

View file

@ -5,6 +5,12 @@
- The CLAUDE.md hierarchy is the only source of persistent context
- If something needs to carry forward across sessions, it belongs in a CLAUDE.md file, not in session memory
## Project Memory
- Project-specific memory lives in `.claude/memory/` at the project root
- Use `MEMORY.md` in that directory as the index (one line per entry pointing to a file)
- Memory files use frontmatter: `name`, `description`, `type` (user/feedback/project/reference)
- Commit `.claude/memory/` with the repo so memory persists across machines and sessions
## Commits & Git Workflow
- Make many small, tightly scoped commits — one logical change per commit