| name | Record Learning |
| description | Record a learning or insight gained during task execution for team knowledge sharing. |
| version | 1.0.0 |
| category | memory |
| skillType | claude-skill |
| assignableRoles | ["developer","qa","tpm","designer","frontend-developer","backend-developer","fullstack-dev","qa-engineer","product-manager","architect","generalist","sales","support"] |
| triggers | ["record learning","learned that","new insight","knowledge share"] |
| tags | ["memory","learning","knowledge","insight"] |
| execution | {"type":"script","script":{"file":"execute.sh","interpreter":"bash","timeoutMs":15000}} |
Record Learning
Record a learning or insight gained during task execution. These learnings are shared with the team and accumulated over time to improve future work.
Parameters
| Flag | JSON Field | Required | Description |
|---|
--agent / -a | agentId | Yes | Your agent ID / session name |
--role / -r | agentRole | Yes | Your role (e.g., developer, qa) |
--project / -p | projectPath | Yes | Absolute path to the project |
--learning / -l | learning | Yes | The learning or insight (or pipe via stdin) |
--learning-file | — | No | Read learning from a file path |
Mandated Format: Karpathy-lite (Entity-Centric)
To support future automated knowledge synthesis, all new learnings MUST follow the Entity-Centric format. This moves from "logging what happened" to "building a compounding wiki."
Formatting Rules:
- Entity First: Start with the primary entity (concept, file, function, or component) in brackets:
[[Entity Name]].
- Concise: 1-3 sentences maximum. No fluff.
- Linked: Reference related entities or components.
- Sourced: Reference the specific Task ID, PR, or Log line where this was learned.
Examples:
✅ CORRECT (Entity-Centric):
[[Fts5IndexService]] SQLite FTS5 rank is a negative double (more-negative = more-relevant). Invert to 100 - rank for score consistency. Learned during PR #320.
✅ CORRECT (Component Relationship):
[[LearningReferenceModule]] injects memory usage instructions via PromptAssemblyService. Related to [[record-learning]] skill. Ref: backend/src/services/ai/prompt-modules/index.ts.
