forgelisted

# Forge Skill **Typically runs automatically via SessionEnd hook.** > **Loop position:** capture sub-step of move 7 in the [operating loop](../../docs/architecture/operating-loop.md). Extracts candidate learnings from transcripts; the [promotion ratchet](../../docs/architecture/operating-loop.md#the-promotion-ratchet) decides which ones survive (one-offs die at handoff; repeats promote to `.agents/learnings/`). Forge is the funnel, not the filter. Extract knowledge from session transcripts. ## How It Works The SessionEnd hook runs: ```bash ao forge transcript --last-session --queue --quiet ``` This queues the session for knowledge extraction. ## Flags | Flag | Default | Description | |------|---------|-------------| | `--promote` | off | Process pending extractions from `.agents/knowledge/pending/` and promote to `.agents/learnings/`. Absorbs the former extract skill. | ## Promote Mode Given `$forge --promote`: ### Promote Step 1: Find Pending Files ```bash ls -lt .agents/knowledge/pending/*.md 2>/dev/null ls -lt .agents/ao/pending.jsonl 2>/dev/null ``` If no pending files found, report "No pending extractions" and exit. ### Promote Step 2: Process Each Pending File For each file in `.agents/knowledge/pending/`: 1. Read the file content 2. Validate it has required fields (`# Learning:`, `**Category**:`, `**Confidence**:`) 3. Copy to `.agents/learnings/` (preserving filename) 4. Remove the source file from `.agents/knowledge/pending/` ### Promote Step 3: Proces