codify-lesson

name	codify-lesson
description	Detect recurring P2/P3 audit patterns across recent rounds and promote them into lesson cards. Use after round boundaries or when repeated findings appear.

codify-lesson

Scans recent audit handoffs for recurring P2/P3 patterns in structured findings tables and promotes repeated clusters into lesson cards.

When to invoke

• After round-boundary-lesson-scan reports a promotable cluster
• User invokes /codify-lesson
• 3+ rounds show the same structured finding pattern

Workflow

1. Shell out to the toolkit:

   arcgentic codify-lesson \
     --audit-dir docs/audits \
     --lessons-dir lessons \
     --amendments-dir mandates/amendments
   

2. Read stdout:

   • lessons: N
   • amendments: N
   • streak_updates: N

3. Inspect every generated lesson card before accepting it.

4. If an amendment proposal is generated, stop for founder review before applying mandate/rule changes.

The scanner ignores reference scans, author notes, forward-debt prose, and other unstructured markdown even when those sections mention P2 or P3.

Output contract

• New lesson card: lessons/lesson-{N}-{slug}.md
• Formal-threshold amendment proposal: mandates/amendments/amendment-{slug}.md
• Existing lesson streak updates when a lesson was preserved

See also

• agents/lesson-codifier.md
• toolkit/src/arcgentic/skills_impl/codify_lesson.py
• toolkit/src/arcgentic/utils/pattern_detection.py