/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`