Files
Sauci/docs/agents/learnings.md
jjbrunton 01bb8225ae chore(harness): make repository agent-ready
Add concise routed context, task-aware agent roles, focused skills, and structured learning promotion.\n\nUnify local development and workspace tooling, add layered test and E2E verification, harden MCP authentication, and gate deployment behind verification and explicit production promotion.
2026-08-27 20:58:48 +01:00

20 lines
839 B
Markdown

# Learning promotion
Raw activity is not durable guidance. A lesson becomes agent context only after a
reproducible observation is reviewed and promoted.
## Lifecycle
1. Record a structured observation in `.agents/learnings/inbox/`.
2. Include symptom, reproduction, cause, remediation, evidence, and scope.
3. `npm run learn:check` validates the record.
4. A reviewer promotes it into exactly one maintained surface: documentation,
skill, test fixture, invariant lint, or scoped `AGENTS.md` rule.
5. Move it to `.agents/learnings/promoted/` and include its destination.
Do not promote speculation, transient provider failures, or one-off workarounds.
Prefer executable enforcement over prose. Review guidance on its expiry date.
`.ralph/runs` and activity logs are historical evidence and are not loaded into
normal task context.