extract-learningslisted

<purpose> Extract decisions, lessons learned, patterns discovered, and surprises encountered from completed phase artifacts into a structured LEARNINGS.md file. Captures institutional knowledge that would otherwise be lost between phases. Overwrites any previous LEARNINGS.md — does not append. Only extracts what is explicitly documented in artifacts — never fabricates. </purpose> <process> ## 0. Initialize ```bash set -euo pipefail INIT=$(maxvision-sdk query init.phase-op "${PHASE_ARG:-$ARGUMENTS}") if [[ "$INIT" == @file:* ]]; then INIT=$(cat "${INIT#@file:}"); fi ``` Parse JSON for: `phase_dir`, `phase_number`, `phase_name`, `padded_phase`, `phase_found`, `project_name`. **If `phase_found` is false:** Exit — "Phase not found." Display: ``` ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ MaxVision ► EXTRACT LEARNINGS — PHASE {N}: {phase_name} ━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━ ``` ## 1. Collect Artifacts **Required artifacts — exit if either is missing:** ```bash set -euo pipefail PLAN_FILES=$(ls "${phase_dir}"/*-PLAN.md 2>/dev/null) SUMMARY_FILES=$(ls "${phase_dir}"/*-SUMMARY.md 2>/dev/null) ``` If PLAN_FILES or SUMMARY_FILES is empty: ``` ⛔ Required artifacts missing for Phase {N}. PLAN.md and SUMMARY.md are both required for learning extraction. Run /maxvision:execute-phase {N} first, then re-run. ``` Exit. **Optional artifacts — read if available, skip gracefully if not:** ```bash set -euo pipefail VERIFICATION_FILES=$(ls "${phase_dir}