maestro-flow 0.3.42 → 0.3.44

package/.codex/skills/manage-learn/SKILL.md

@@ -6,7 +6,7 @@ allowed-tools: Read, Write, Edit, Bash, Glob, Grep
 ---
 
 <purpose>
-Pure file-operation CRUD skill for the workflow learning library. No agent spawning, no CLI calls, no LLM inference — just parse-infer-append-confirm. Complements `quality-retrospective`: where retrospective extracts insights in bulk from completed phases, `manage-learn` captures one timeless insight at a time during active work. Both write to the same `lessons.jsonl` store, disambiguated by `source` and `lens` fields.
+Pure file-operation CRUD skill for the workflow knowhow library. No agent spawning, no CLI calls, no LLM inference — just parse-infer-append-confirm. Complements `quality-retrospective`: where retrospective extracts insights in bulk from completed phases, `manage-learn` captures one timeless insight at a time during active work. Both write to the same `specs/learnings.md` store, disambiguated by `source` and `lens` fields.
 
 ```
 Parse Mode  →  Bootstrap Store  →  Execute Mode  →  Confirm
@@ -42,14 +42,14 @@ $manage-learn "\"Zod v4 breaks z.object().strict() API\" --category gotcha --tag
 - `--limit <N>` — Row limit (default 20)
 
 **Storage**:
-- `.workflow/learning/lessons.jsonl` — append-only JSONL (shared with `quality-retrospective`)
-- `.workflow/learning/learning-index.json` — searchable index
+- `.workflow/specs/learnings.md` — append-only store (shared with `quality-retrospective`)
+- Index auto-maintained by WikiIndexer (no manual index file needed)
 </context>
 
 <invariants>
 1. **No LLM or CLI calls**: This skill is pure file I/O — parse, infer, append, confirm. No `exec_command`, no `spawn_agent`.
-2. **Bootstrap on demand**: Create `.workflow/learning/` structure on first use; do not require it to exist.
-3. **Append-only lessons.jsonl**: Never rewrite or delete existing rows.
+2. **Bootstrap on demand**: Create `.workflow/knowhow/` structure on first use; do not require it to exist.
+3. **Append-only learnings.md**: Never rewrite or delete existing entries.
 4. **Stable INS-ids**: `INS-{8hex}` from `hash(insightText + timestamp)` — same text at different times gets different ids.
 5. **Source field**: Always `"manual"` for captures from this skill; `"retrospective"` is reserved for `quality-retrospective`.
 6. **Phase auto-link**: Read `state.json` automatically; `--phase 0` is the only way to force null.
@@ -74,7 +74,7 @@ Validate `--category` if provided (allowed: pattern, antipattern, decision, tool
 
 ### Step 2: Bootstrap Learning Store (on first use)
 
-Verify `.workflow/` exists (E001 if not). If `.workflow/learning/lessons.jsonl` missing: create directory, empty `lessons.jsonl`, and initialize `learning-index.json` with `{"version":1,"entries":[]}`.
+Verify `.workflow/` exists (E001 if not). If `.workflow/specs/learnings.md` missing: create `.workflow/specs/` directory and empty `learnings.md` with header.
 
 ### Step 3: Execute Mode
 
@@ -94,16 +94,16 @@ Verify `.workflow/` exists (E001 if not). If `.workflow/learning/lessons.jsonl`
 2. **Auto-link phase** from `state.json` artifact registry. `--phase 0` forces null.
 3. **Generate INS-id**: `INS-{8 hex}` from `hash(insightText + timestamp)`.
 4. **Build row** with fields: id, title (first 80 chars), summary, source="manual", lens=null, category, tags (includes "manual"), phase, phase_slug, confidence, routed_to=null, created_at.
-5. **Append** JSON line to `lessons.jsonl` (append-only, never rewrite).
-6. **Update** `learning-index.json`: push entry with id, title, category, tags, phase, created_at.
+5. **Append** entry to `specs/learnings.md` (append-only, never rewrite).
+6. WikiIndexer auto-indexes the new entry (no manual index update needed).
 
 #### List Mode
 
-Read `learning-index.json`, apply filters (`--tag`, `--category`, `--phase`, `--lens`), sort newest-first, display up to `--limit` rows (default 20) as table.
+Read `learnings.md` entries, apply filters (`--tag`, `--category`, `--phase`, `--lens`), sort newest-first, display up to `--limit` rows (default 20) as table.
 
 #### Search Mode
 
-Grep `lessons.jsonl` for query. Rank by field weight: title (3) > tags (2) > summary (1). Display top matches.
+Grep `learnings.md` for query. Rank by field weight: title (3) > tags (2) > summary (1). Display top matches.
 
 #### Show Mode
 
@@ -120,16 +120,16 @@ Capture mode: display ID, category, phase, confidence, tags, and next-step comma
 | E001 | error | `.workflow/` not initialized — run `$maestro-init` first | parse_input |
 | E002 | error | Unknown `--category` value | parse_input |
 | E003 | error | `show` mode requires INS-id argument | show |
-| E004 | error | INS-id not found in lessons.jsonl | show |
+| E004 | error | INS-id not found in learnings.md | show |
 | W001 | warning | Auto-phase detection: no matching artifact directory found; phase set to null | capture |
-| W002 | warning | `learning-index.json` row count differs from `lessons.jsonl`; offer to rebuild index | list/search |
+| W002 | warning | Entry count differs from `learnings.md`; offer to rebuild index | list/search |
 </error_codes>
 
 <success_criteria>
 - [ ] Mode parsed correctly (capture, list, search, show)
 - [ ] Learning store bootstrapped on first use
 - [ ] Capture: category inferred from keywords, phase auto-linked, INS-id generated
-- [ ] Capture: row appended to lessons.jsonl (append-only), index updated
+- [ ] Capture: entry appended to specs/learnings.md (append-only)
 - [ ] List: filters applied, newest-first, respects --limit
 - [ ] Search: grep with weighted ranking across title/tags/summary
 - [ ] Show: full record displayed for valid INS-id

package/.codex/skills/manage-wiki/SKILL.md

@@ -27,7 +27,7 @@ $ARGUMENTS — subcommand and optional flags.
 | `stats` | Graph statistics — type distribution, tag frequency, growth |
 
 **Flags:**
-- `--type <type>` — Filter: spec, knowhow, note, lesson, issue
+- `--type <type>` — Filter: spec, knowhow, note, issue
 - `--fix` — Auto-fix issues during cleanup
 - `--json` — JSON output
 </context>