aget-record-lesson

/aget-record-lesson

Record lessons learned as structured L-docs in the git repo. Each lesson is classified to determine storage location and ID scheme.

Purpose

Capture learnings in a persistent, searchable format that survives context windows and session boundaries. Enables knowledge accumulation across sessions.

Input

$ARGUMENTS - Optional lesson description or trigger context

Execution

Step 1: Gather Context

Identify what triggered the lesson:

• Session observation
• User feedback
• Error encountered
• Pattern discovered
• Process improvement

Step 2: Classify the Lesson

Ask the user:

Classification Required

Would this lesson help another AGET (different principal, different domain)?

• Framework → Reusable across AGETs → .aget/evolution/L###_*.md
• Domain → Helps this principal → knowledge/patterns/*.md

Decision Tree:

Would this help another AGET?
├── YES → Framework → .aget/evolution/L###_{name}.md (gets L-number)
└── NO  → Would this help the principal without an AGET?
    ├── YES → Domain → knowledge/patterns/{category}/{name}.md
    └── UNCLEAR → Ask user to clarify

Step 3: Get Next ID (Framework only)

# Read next_id from index.json
jq '.next_id' .aget/evolution/index.json

Step 4: Create Lesson Document

Framework Template (.aget/evolution/L{ID}_{name}.md):

# L{ID}: {Title}

**Date**: {YYYY-MM-DD}
**Type**: Lesson Learned
**Category**: {category}
**Status**: complete

---

## Summary

{One paragraph summary of the lesson}

---

## Context

{What triggered this lesson? What were you doing?}

---

## Key Finding

{The core insight or learning}

---

## Implications

{What should change as a result?}

---

## Traceability

| Link | Reference |
|------|-----------|
| Session | {session file if applicable} |
| Project | {project plan if applicable} |
| Trigger | {what prompted this lesson} |

---

*L{ID}: {Title}*
*Category: {category}*

Domain Template (knowledge/patterns/{category}/{name}.md):