gh-jsell-rh-agentic-development-plugins-agentic-development/skills/orchestrator/memory-template.md

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

# 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

### 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

### 2025-01-12T14:30:00Z
- **Pattern**: Something was unclear
- **Action**: Be more careful
- **Context**: Somewhere

Agent-Specific Examples

requirements-refiner.md

# 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

# 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

# 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