Files
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

839 B

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.