122 lines
3.0 KiB
Markdown
122 lines
3.0 KiB
Markdown
# Agent Memory Template
|
|
|
|
This template defines the format for agent memory files in `.agent-memory/`.
|
|
|
|
## File Structure
|
|
|
|
Each agent maintains its own memory file: `.agent-memory/<agent-name>.md`
|
|
|
|
## Format
|
|
|
|
```markdown
|
|
# Agent Memory: <agent-name>
|
|
|
|
## Purpose
|
|
[One-line description of what this agent learns and tracks]
|
|
|
|
## Learnings
|
|
|
|
### YYYY-MM-DDTHH:MM:SSZ
|
|
- **Pattern**: [What pattern/issue was observed]
|
|
- **Action**: [What to do differently next time]
|
|
- **Context**: [Stage/gate/task where this occurred]
|
|
|
|
### YYYY-MM-DDTHH:MM:SSZ
|
|
- **Pattern**: [Description]
|
|
- **Action**: [Actionable change]
|
|
- **Context**: [Where/when]
|
|
```
|
|
|
|
## Guidelines
|
|
|
|
### What to Track
|
|
- ✅ Recurring patterns (ambiguities, gaps, errors)
|
|
- ✅ Successful solutions to problems
|
|
- ✅ Project-specific standards
|
|
- ✅ Common failure modes
|
|
- ✅ Actionable insights
|
|
|
|
### What NOT to Track
|
|
- ❌ One-off issues
|
|
- ❌ Vague observations
|
|
- ❌ Non-actionable information
|
|
- ❌ Code snippets (specs handle that)
|
|
- ❌ General knowledge (agents already have this)
|
|
|
|
### Entry Format
|
|
- **Timestamp**: ISO 8601 format (YYYY-MM-DDTHH:MM:SSZ)
|
|
- **Pattern**: Concise description of what was observed
|
|
- **Action**: Specific, actionable change for future iterations
|
|
- **Context**: Where in the flow this occurred (stage, gate, task)
|
|
|
|
### Maintenance
|
|
- Max 50 entries per file
|
|
- When limit reached, archive oldest entries
|
|
- Keep most impactful learnings
|
|
- Remove outdated patterns
|
|
|
|
## Examples
|
|
|
|
### Good Entry
|
|
```markdown
|
|
### 2025-01-12T14:30:00Z
|
|
- **Pattern**: Requirements missing authentication method specification
|
|
- **Action**: Always explicitly ask "What authentication method?" in initial validation
|
|
- **Context**: Stage 0, loop #3 - user assumed OAuth but wanted JWT
|
|
```
|
|
|
|
### Bad Entry
|
|
```markdown
|
|
### 2025-01-12T14:30:00Z
|
|
- **Pattern**: Something was unclear
|
|
- **Action**: Be more careful
|
|
- **Context**: Somewhere
|
|
```
|
|
|
|
## Agent-Specific Examples
|
|
|
|
### requirements-refiner.md
|
|
```markdown
|
|
# Agent Memory: requirements-refiner
|
|
|
|
## Purpose
|
|
Track common ambiguities and clarification patterns for this project
|
|
|
|
## Learnings
|
|
|
|
### 2025-01-12T14:30:00Z
|
|
- **Pattern**: "API" mentioned without specifying REST vs GraphQL vs gRPC
|
|
- **Action**: Add API protocol to standard clarification questions
|
|
- **Context**: Gate 0 failure, requirements unclear
|
|
```
|
|
|
|
### security-expert.md
|
|
```markdown
|
|
# Agent Memory: security-expert
|
|
|
|
## Purpose
|
|
Track vulnerability patterns and security fixes applied in this project
|
|
|
|
## Learnings
|
|
|
|
### 2025-01-12T15:45:00Z
|
|
- **Pattern**: SQL queries built with string concatenation in persistence layer
|
|
- **Action**: Enforce parameterized queries check in all persistence.py files
|
|
- **Context**: Stage 6, found in user module persistence
|
|
```
|
|
|
|
### team-lead.md
|
|
```markdown
|
|
# Agent Memory: team-lead
|
|
|
|
## Purpose
|
|
Track task assignment patterns and dependency learnings
|
|
|
|
## Learnings
|
|
|
|
### 2025-01-12T16:00:00Z
|
|
- **Pattern**: Database models must be complete before API endpoints
|
|
- **Action**: Always assign Python Expert for models before FastAPI Expert for routes
|
|
- **Context**: Stage 5, FastAPI expert blocked without complete models
|
|
```
|