maestro-flow 0.5.35 → 0.5.36

package/workflows/agy-instructions.md

@@ -1,7 +1,5 @@
 # Maestro for Antigravity CLI
 
-Workflow orchestration CLI with MCP endpoint support and extensible architecture, adapted for Antigravity CLI tooling.
-
 - **Coding Philosophy**: @~/.maestro/workflows/coding-philosophy.md
 
 ## Delegate & CLI
@@ -11,8 +9,6 @@ Workflow orchestration CLI with MCP endpoint support and extensible architecture
 
 **Strictly follow the cli-tools.json configuration**
 
-Available CLI endpoints are dynamically defined by the config file. Use `maestro delegate --to agy` to dispatch tasks to the Antigravity CLI.
-
 ## Antigravity Tool Priority
 
 When choosing between equivalent tools, prefer the agy native primitives over shell fallbacks:

package/workflows/analyze.md

@@ -163,11 +163,13 @@ Parse $ARGUMENTS to determine mode and flags:
    - `constraints[status=open]` → prioritize for analysis
    - `open_questions[]` → seed discussion topics
 6. Load project specs: `specs_content = maestro spec load --category arch`
+7. Load domain glossary: read `.workflow/domain/glossary.yaml`（如存在）— 分析过程中使用 canonical term names 保持术语一致性；新发现的术语候选记入 `context-package.json#domain.terminology[]`
 
 **Load prior context** (adhoc/standalone scope):
 1. Read `.workflow/project.md` (if exists) — project vision, Validated requirements, Active requirements, Key Decisions
 2. Read `.workflow/state.json` (if exists) → `accumulated_context` (key_decisions, deferred, blockers)
 3. Load project specs: `specs_content = maestro spec load --category arch`
+4. Load domain glossary: read `.workflow/domain/glossary.yaml`（如存在）
 
 **Quick mode routing**: If QUICK_MODE, skip to Step 8 (Decision Extraction) after loading context.
 
@@ -525,8 +527,6 @@ Implementer's choice. Research suggests: {relevant finding from researchContext}
 (e.g., "Standard Stack recommends React Query for server state. Common pitfall: avoid mixing with Redux for async.")
 ```
 
-This makes research findings visible to the planner through context.md without imposing hard constraints.
-
 **8.5: Write context.md**
 
 Write to `OUTPUT_DIR/context.md`:

package/workflows/boundary-grill.md

@@ -0,0 +1,50 @@
+# Boundary Grill — Embedded Mini-Review Protocol
+
+
+## Conflict Types
+
+| ID | Signal | Example |
+|----|--------|---------|
+| `RSC` | Decision outside command's scope guard | analyze outputs task-level details (plan scope) |
+| `MOD` | Changes cross 2+ module boundaries | task touches `commands/` and `hooks/` without declaring cross-module |
+| `DEC` | Upstream locked decision contradicts code | locked "use EventEmitter" but code uses Subject at `file:line` |
+
+## Trigger
+
+Run boundary grill when ANY of:
+- **RSC**: produced decision matches another command's scope guard keywords
+- **MOD**: `ARCHITECTURE.md` exists AND changes touch 2+ top-level modules
+- **DEC**: upstream Locked decisions AND code grep shows contradicting patterns
+
+Priority when >3 conflicts: DEC > RSC > MOD.
+
+## Protocol
+
+Per conflict (max 3 conflicts × 3 questions = 9 total):
+1. State the conflict with `file:line` evidence
+2. Ask 2-3 adversarial questions via AskUserQuestion — challenge with code reality
+3. Resolve: RESOLVED (evidence-based) / DEFERRED (needs escalation) / ACCEPTED_RISK
+
+**Auto mode (`-y`)**: skip questions, resolve via code evidence weighting:
+- RSC → defer to target scope
+- MOD → follow existing cross-module pattern (or flag as risk)
+- DEC → code wins (current code = ground truth)
+
+## Output
+
+Append to calling command's primary output:
+
+```markdown
+## Boundary Grill Results
+
+| # | Type | Conflict | Resolution | Evidence |
+|---|------|----------|------------|----------|
+```
+
+Feed into `context.md`: resolved DEC → amend Locked; unresolved → Deferred with `boundary_grill: true`.
+
+## Constraints
+
+- Non-blocking — warnings + resolutions, never hard stops
+- Evidence MUST include `file:line` — generic assertions invalid
+- Results visible in command output — no silent swallowing

package/workflows/brainstorm.md

@@ -1,7 +1,5 @@
 # Workflow: Brainstorm
 
-Dual-mode brainstorming: auto pipeline (full multi-role analysis) or single role analysis.
-
 ## Architecture
 
 ```
@@ -202,9 +200,12 @@ Pass into Steps 2 and 3.
 
 ### Step 2: Terminology & Boundary Definition (Auto Mode)
 
-1. Extract 5-10 core domain terms (merge upstream locked terms if available)
-2. AskUserQuestion for Non-Goals (multiSelect, include "其他" option)
-3. Store terminology + non_goals to session
+1. Load existing domain terms: read `.workflow/domain/glossary.yaml` 中已注册术语，避免重复定义
+2. Extract 5-10 core domain terms (merge upstream locked terms + existing glossary terms)
+3. AskUserQuestion for Non-Goals (multiSelect, include "其他" option)
+4. Store terminology + non_goals to session
+
+新候选术语仅存入 `context-package.json#domain.terminology[]`，不直接写 glossary.yaml。由 chain 末尾 `manage-harvest --auto` 触发 finish-work Step 3.5 统一提升为正式术语。
 
 **Skip if**: `--yes` (auto-generate terms, empty non-goals)
 

package/workflows/claude-instructions.md

@@ -5,10 +5,22 @@
 ## Delegate & CLI
 
 - **Delegate Usage**: @~/.maestro/workflows/delegate-usage.md
+- **Explore Usage**: @~/.maestro/workflows/explore-usage.md
 - **CLI Endpoints Config**: @~/.maestro/cli-tools.json
 
 **Strictly follow the cli-tools.json configuration**
 
+## Explore Priority
+
+Commands with codebase exploration/search steps should prefer `maestro explore` over inline Grep/Read:
+- **odyssey-\*** (archaeology, explore, discover phases)
+- **analyze, blueprint, grill** (discovery/scan phases)
+- **learn-investigate** (evidence gathering)
+- **issue-discover** (multi-perspective scan)
+- **impeccable teach/explore** (codebase scan)
+
+Use structured prompt format (`FIND/SCOPE/EXCLUDE/ATTENTION/EXPECTED`) for targeted searches. Multi-prompt parallel for multi-angle scans.
+
 ## Knowledge System
 
 **Gate rule: On any coding/modification/debugging task, run `maestro search` BEFORE reading code or editing files. Use targeted queries — multiple short searches beat one long one.**

package/workflows/codebase-rebuild.md

@@ -204,7 +204,6 @@ Uses the native `maestro kg index` command (`src/graph/analyzers/fs-analyzer.ts`
 maestro kg index --src "$PROJECT_ROOT/src"
 ```
 
-This single command performs:
   - File system scan and code entity extraction (nodes, edges)
   - Import/call graph analysis and test pairing (tested_by edges)
   - Layer classification and topological tour generation

package/workflows/codex-instructions.md

@@ -2,10 +2,22 @@
 
 
 - **Delegate Usage**: @~/.maestro/workflows/delegate-usage.md
+- **Explore Usage**: @~/.maestro/workflows/explore-usage.md
 - **CLI Endpoints Config**: @~/.maestro/cli-tools.json
 
 **Strictly follow the cli-tools.json configuration**
 
+## Explore Priority
+
+Commands with codebase exploration/search steps should prefer `maestro explore` over inline Grep/Read:
+- **odyssey-\*** (archaeology, explore, discover phases)
+- **analyze, blueprint, grill** (discovery/scan phases)
+- **learn-investigate** (evidence gathering)
+- **issue-discover** (multi-perspective scan)
+- **impeccable teach/explore** (codebase scan)
+
+Use structured prompt format (`FIND/SCOPE/EXCLUDE/ATTENTION/EXPECTED`) for targeted searches. Multi-prompt parallel for multi-angle scans.
+
 # Coding Philosophy
 
 ## Core Beliefs

package/workflows/debug.md

@@ -1,9 +1,5 @@
 # Debug Workflow
 
-Scientific method debugging with subagent isolation. Three modes: **Standalone** (user describes issue), **From UAT** (`--from-uat`, pre-filled symptoms), **Parallel** (`--parallel`, concurrent agents per gap cluster).
-
-Output: `understanding.md` + `evidence.ndjson` per investigation.
-
 ---
 
 ## Iron Law

package/workflows/domain-add.md

@@ -0,0 +1,115 @@
+---
+name: domain-add
+alias: domain-add
+---
+
+# Workflow: domain-add
+
+Register a domain term into `.workflow/domain/glossary.yaml`.
+
+## Arguments
+
+```
+$ARGUMENTS: "<canonical> <definition>"
+
+canonical -- kebab-case term name (e.g. "auth-token", "event-bus")
+definition -- one-line definition (≤200 chars)
+```
+
+## Prerequisites
+
+- `.workflow/domain/` directory must exist (run `maestro domain init` if missing)
+
+## Execution Steps
+
+### Step 1: Parse Arguments
+
+```
+Parse $ARGUMENTS:
+  1. canonical = first token (kebab-case, e.g. "auth-token")
+  2. definition = remaining text
+Validate:
+  - canonical is non-empty, kebab-case (lowercase, hyphens only)
+  - definition is non-empty, ≤200 chars
+On failure: show usage `domain-add <canonical> "<definition>"`, exit
+```
+
+### Step 2: Check Glossary State
+
+Verify `.workflow/domain/glossary.yaml` exists. If not, create via `maestro domain init`.
+
+Read existing glossary and check for:
+- **Exact duplicate**: same canonical name already registered → report existing entry, exit
+- **Near match**: Levenshtein distance ≤ 2 or alias overlap → warn, ask to confirm or merge
+
+### Step 3: Extract Metadata
+
+Auto-derive from the definition and codebase context:
+
+- **aliases** (1-3): common abbreviations, Chinese translations, or alternate forms the term is known by
+- **keywords** (3-5): search terms for discovery
+- **tier**: `core` (fundamental project concept) | `extended` (secondary) | `peripheral` (rarely referenced)
+- **relationships**: scan existing glossary for related terms (semantic overlap or dependency)
+
+### Step 4: Register Term
+
+Write via `maestro domain add`:
+
+```bash
+maestro domain add "<canonical>" "<definition>" --tier <tier>
+```
+
+If aliases or relationships identified, update immediately:
+
+```bash
+maestro domain update "<canonical>" --aliases "alias1,alias2" --keywords "kw1,kw2,kw3" --relationships "related-term-1,related-term-2"
+```
+
+Records `source.kind = 'manual'`, `source.registered_at = now`.
+
+### Step 5: Verify Injection
+
+Confirm the term is injectable by checking:
+
+```bash
+maestro domain show "<canonical>"
+```
+
+Display: canonical name, definition, aliases, tier, relationships, and verify command:
+```
+maestro domain list
+```
+
+### Step 6: Report
+
+```
+=== DOMAIN TERM REGISTERED ===
+Term:      {canonical}
+Definition: {definition}
+Aliases:   {alias1, alias2}
+Tier:      {tier}
+Related:   {rel1, rel2}
+Injection: domain-compact (always) + domain-expanded (on keyword match)
+Next:      maestro domain list | maestro domain discover (find more candidates)
+```
+
+## Auto-Discovery Alternative
+
+For batch registration from codebase scanning:
+
+```bash
+maestro domain discover    # scan codebase for term candidates
+maestro domain import      # batch import from external source
+```
+
+## Domain Term Lifecycle
+
+```
+discover/manual → register → active → (optional) deprecated → removed
+                                ↑
+                          update aliases/keywords/relationships
+```
+
+## Output
+
+One domain term entry added to `.workflow/domain/glossary.yaml`.

package/workflows/execute.md

@@ -589,6 +589,13 @@ Append unique entries to .workflow/specs/learnings.md using <spec-entry> closed-
   category="learning", keywords (3-5 terms), date, source="execute"
 
 Mark artifact.harvested = true; write state.json (atomic)
+
+// Domain knowledge note:
+// E5 仅提取 incremental learnings (spec category=learning)。
+// 完整的知识提取（constraints → spec, decisions → knowhow, terminology → domain glossary）
+// 由 chain 末尾的 manage-harvest --auto 触发 finish-work 统一处理。
+// Domain compact/expanded 注入是 hook 自动行为，execute 期间无需手动加载——
+// 已注册术语通过 keyword-spec-injector 自动注入到 agent context 中。
 ```
 
 ---

package/workflows/explore-usage.md

@@ -0,0 +1,128 @@
+# Explore Usage
+
+```bash
+maestro explore "<PROMPT>" [more prompts...] [options]
+```
+
+## When to Use
+
+| Scenario | Example |
+|----------|---------|
+| Multi-angle codebase scan | 3 prompts scanning DB/API/error patterns in parallel |
+| Quick code lookup | Single prompt, foreground |
+| Per-prompt endpoint routing | JSON file with different endpoints per prompt |
+| Lightweight read-only analysis | Where delegate is overkill (no session, no history) |
+
+**Not for**: write-mode tasks, long sessions, interactive follow-ups — use `delegate` instead.
+
+## Options
+
+| Option | Description | Default |
+|--------|-------------|---------|
+| `-e, --endpoint <names>` | Endpoint name(s), comma-separated | First available |
+| `--all` | Fan out each prompt to all endpoints | — |
+| `--parallel <n>` | Max concurrent endpoint queues | Config or `4` |
+| `--ep-concurrency <n>` | Max concurrent jobs per endpoint | `1` (serial) |
+| `--max-turns <n>` | Max agent turns per job | Config or `6` |
+| `-f, --file <path>` | Load prompts from JSON or text file | — |
+| `--cd <dir>` | Working directory | Current |
+| `-o, --output-dir <dir>` | Custom session save directory | `.workflow/explore/` |
+| `--no-save` | Skip session save | — |
+| `--json` | Output results as JSON | — |
+
+**1 prompt = 1 agent**. Endpoint resolution: `--endpoint` > `--all` > first available.
+
+## Prompt Template
+
+```
+FIND: [what to search for — the core query]
+SCOPE: [file patterns, directories, or modules]
+EXCLUDE: [what to skip — files, patterns, false positives]
+ATTENTION: [caveats, edge cases, things to watch for]
+EXPECTED: [output format — evidence list, summary, JSON]
+```
+
+Only `FIND` required. Plain text (no `FIND:` prefix) also works.
+
+| Field | Role | Example |
+|-------|------|---------|
+| `FIND` | What to search for | `All database query patterns that could cause N+1` |
+| `SCOPE` | Where to look | `src/db/**/*.ts`, `src/api/` |
+| `EXCLUDE` | What to skip | `test files, generated code, node_modules` |
+| `ATTENTION` | What to watch for | `ORM lazy-loading traps, raw SQL in service layer` |
+| `EXPECTED` | Output format | `file:line evidence list with severity` |
+
+## Execution Model
+
+**Serial within endpoint, parallel across endpoints.**
+
+Same API → jobs queue and run one-by-one (avoids rate limits).
+Different APIs → queues run concurrently.
+
+```
+Endpoint A:  [job1] → [job2] → [job3]    (serial)
+Endpoint B:  [job4] → [job5]              (serial)
+                                           ↑ parallel ↑
+```
+
+Raise per-endpoint parallelism with `--ep-concurrency 2` when the API allows it.
+
+## Multi-Prompt Input
+
+**Inline**: `maestro explore "prompt1" "prompt2" "prompt3"`
+
+**JSON file** (`-f prompts.json`):
+
+```json
+[
+  "simple string prompt",
+  { "prompt": "FIND: auth bypass\nSCOPE: src/api/", "endpoint": "deepseek" }
+]
+```
+
+Per-prompt `endpoint` overrides global `--endpoint`.
+
+**Text file** (`-f prompts.txt`): paragraphs separated by blank lines.
+
+**Mixed**: `maestro explore "inline" -f file.json`
+
+## Session
+
+Results auto-save to `.workflow/explore/{session-id}.json` per workspace.
+
+```bash
+maestro explore show                  # list sessions
+maestro explore output <id>           # view session results
+maestro explore output <id> --json    # JSON output
+```
+
+## Endpoint Config
+
+File: `~/.maestro/api-explore.json`
+
+```json
+{
+  "endpoints": {
+    "qwen": { "baseUrl": "https://...", "apiKey": "sk-xxx", "model": "Qwen/Qwen3-8B" },
+    "deepseek": { "baseUrl": "https://...", "apiKey": "sk-yyy", "model": "deepseek-chat" }
+  },
+  "maxTurns": 6,
+  "concurrency": 4
+}
+```
+
+Proxy auto-inherited from `~/.maestro/cli-tools.json`. Legacy single-endpoint and env vars also supported.
+
+## Execution Rules
+
+Multi-prompt — **background**:
+
+```
+Bash({ command: "maestro explore \"p1\" \"p2\" --json", run_in_background: true })
+```
+
+Single quick lookup — foreground is fine:
+
+```
+Bash({ command: "maestro explore \"Where is X defined?\"" })
+```

package/workflows/finish-work.md

@@ -1,7 +1,5 @@
 # Workflow: finish-work
 
-Last step of session commands. Inline-extracts spec/knowhow from this single session, then writes `archive.json` so the session enters `wiki search` (strategy 2: only sealed/archived sessions are indexed).
-
 ## Inputs
 
 Caller passes: `SESSION_DIR`, `SESSION_TYPE` (grill | brainstorm | analyze | blueprint | plan | execute | verify), `SESSION_ID`, `LINKED_MILESTONE` (optional).
@@ -78,10 +76,10 @@ Source priority:
 
 Process:
   1. 从 session 产物中收集术语候选
-  2. 过滤已注册的 `glossary.json` terms
+  2. 过滤已注册的 `glossary.yaml` terms
   3. 0 个新候选 → 跳过（静默）
   4. ≥ 1 个新候选 → 交互确认（domain 注册始终需要用户确认，`-y` 对 domain 无效）
-  5. 确认的术语写入 `glossary.json` via `maestro domain add`
+  5. 确认的术语写入 `glossary.yaml` via `maestro domain add`
   6. 记录到 `archive.json` 的 `extraction.domain_ids[]`
 
 Skip conditions:
@@ -130,8 +128,6 @@ Next: /maestro-milestone-complete will flip lifecycle.status → archived and pr
 
 ## Idempotency
 
-Re-running on same session: archive.json overwritten with fresh timestamps. Steps 2-3 skipped when existing `archive.json.extraction.harvested == true` (avoids duplicate spec/knowhow). Force re-extract: delete `archive.json` first.
-
 ## Boundary
 
 - Does NOT flip `archived_at` or move files — that is milestone-complete Step 2.3.

package/workflows/fork.md

@@ -1,9 +1,5 @@
 # Workflow: fork
 
-Create a git worktree for an entire milestone, enabling inter-milestone parallel development. Copies `.workflow/` context into the worktree since `.workflow/` is gitignored.
-
-Worktrees operate at the **milestone level** — all phases within a milestone are owned by one worktree and executed sequentially inside it. Per-phase parallelism within a milestone is not supported.
-
 ---
 
 ## Step 1: Parse Arguments and Flags

package/workflows/grill.md

@@ -451,7 +451,20 @@ Write `{output_dir}/context-package.json`:
 }
 ```
 
-### 7.2: Completion Report
+### 7.2: Domain Knowledge Flow
+
+Grill 产出的领域术语通过以下路径沉淀到项目知识库：
+
+```
+terminology.md (locked terms)  ──→  finish-work Step 3.5  ──→  .workflow/domain/glossary.yaml
+context-package.json#domain.terminology[]  ──→  finish-work Step 3.5  ──→  glossary.yaml
+```
+
+- Grill 期间**不应**直接调用 `maestro domain add` — 术语在 grilling 过程中可能被修改或推翻
+- 所有术语经 Step 5 synthesis 锁定后，由 chain 末尾的 `manage-harvest --auto` 自动触发 finish-work 提取
+- finish-work Step 3.5 的 domain extraction 始终交互确认（`-y` 对 domain 注册无效）
+
+### 7.3: Completion Report
 
 ```
 Grill session {artifact_id} completed.

package/workflows/harvest.md

@@ -1,6 +1,5 @@
 # Harvest Workflow
 
-Extract knowledge from **any workflow artifact** (analysis, brainstorm, debug, lite-plan/fix, scratchpad, sessions) and route into wiki / spec / issue stores.
 
 ---
 
@@ -260,8 +259,6 @@ For each routed item, record in `.workflow/harvest/harvest-log.jsonl`:
 }
 ```
 
-This log prevents duplicate harvesting in future runs.
-
 ---
 
 ## Stage 7: dedup_check

package/workflows/impeccable/audit.md

@@ -1,7 +1,5 @@
 Run systematic **technical** quality checks and generate a comprehensive report. Don't fix issues; document them for other commands to address.
 
-This is a code-level audit, not a design critique. Check what's measurable and verifiable in the implementation.
-
 ## Diagnostic Scan
 
 Run comprehensive checks across 5 dimensions. Score each dimension 0-4 using the criteria below.

package/workflows/impeccable/codex.md

@@ -1,9 +1,5 @@
 # Codex: Visual Direction & Asset Production
 
-This file is loaded by `/maestro-impeccable craft` when the harness has native image generation (currently Codex via `image_gen`). Other harnesses skip it. It covers the two craft steps that depend on real image generation: landing the visual direction, and producing the raster assets the implementation will compose.
-
-Read this *before* generating any images. The order matters, and the per-step user pauses are what keep generated imagery from drifting away from the brief.
-
 ### Four stop points before code
 
 Steps A through D each end with the user. Do not advance past any of them on your own read of the situation.

package/workflows/init.md

@@ -113,6 +113,14 @@ If `.workflow/specs/` does not exist:
    - Skip spec-setup (nothing to scan)
    - Note: Specs will be progressively populated as pipeline stages produce knowledge
 
+## Step 2.5: Domain Init (first-run only)
+
+If `.workflow/domain/` does not exist:
+
+1. Run `Bash("maestro domain init")` — creates `.workflow/domain/glossary.yaml` with empty terms array
+2. If brownfield project (has source files): run `maestro domain discover --auto` to scan codebase for initial term candidates, present top 5 for confirmation
+3. If greenfield project: skip discovery (no codebase to scan); domain terms will be populated by grill/brainstorm sessions via finish-work extraction
+
 
 ---
 
@@ -126,6 +134,7 @@ Verify all required directories and files exist:
   state.json         ✓
   config.json        ✓
   specs/             ✓
+  domain/            ✓ (glossary.yaml)
   research/          ✓ (if research enabled)
   scratch/           ✓ (create empty)
   milestones/        ✓ (create empty)

package/workflows/interview-mechanics.md

@@ -3,5 +3,6 @@
 - **One decision per turn** via AskUserQuestion, 2-4 options, first marked `(Recommended)`. User can redirect via `Other`.
 - **Search-first**: resolve via state.json → session artifacts → `maestro spec/wiki` → Glob/Grep/Read → Agent(Explore) / delegate. Never ask what code can answer.
 - **Writeback**: each decision **immediately written to disk** before the next question. No batching.
-- **Skip**: auto mode (`-y`), resume (`-c`), or unambiguous input → skip entire interview.
-- **Decision table**: `| # | Decision | Choice | Source (user / code / default) |`
+- **Skip**: auto mode (`-y`) → 逐问题 Search-first 代答（不跳过整段 interview）；仅当代码给出高置信答案时跳过该问题。**例外**：broad intent 的边界澄清永不跳过（即使 `-y`）；phase 歧义永不跳过。resume (`-c`) → 跳过已答问题。unambiguous 单一答案输入 → 仅跳过该问题。
+- **Decision table**: `| # | Decision | Choice | Source (user / code / default) | Confidence (high / medium / LOW) |`
+  - `code` source：Search-first 派生（state.json / spec / Glob / Grep）。`code` + 非 broad → 可自动定；`code` + broad → 标 `LOW CONFIDENCE` 需用户确认；`default` source → 一律标 `LOW CONFIDENCE`。

package/workflows/issue-analyze.md

@@ -3,8 +3,6 @@
 > **DEPRECATED**: Superseded by `issue-gaps-analyze.md` which adds batch support and context.md output.
 > Use `maestro-analyze --gaps [ISS-ID]` instead.
 
-This workflow's executable steps have been removed to prevent divergent implementations.
-
 ## Migration
 
 | Old usage | New usage |
@@ -20,6 +18,3 @@ This workflow's executable steps have been removed to prevent divergent implemen
 - `issue-execute.md` — downstream execution after planning
 
 ## Notes
-
-- Issue records analyzed by the new pipeline still write to `.workflow/issues/issues.jsonl` with `analysis` field (root_cause, impact, related_files, confidence, suggested_approach, analyzed_at, analyzed_by).
-- Status is unchanged by analysis (non-destructive enrichment).

package/workflows/issue-gaps-analyze.codex.md

@@ -1,11 +1,5 @@
 # Workflow: Issue Gaps Analysis (Codex — CSV Wave)
 
-Root cause analysis for issues via `spawn_agents_on_csv` wave execution.
-Supports single issue (ISS-ID) or batch with classification and parallel analysis.
-Produces analysis records in issues.jsonl and context.md for downstream `plan --gaps`.
-
-**Invoked by**: `maestro-analyze --gaps [ISS-ID]` (codex SKILL.md)
-
 ## Pipeline
 
 ```

package/workflows/knowledge-audit.md

@@ -1,9 +1,5 @@
 # Knowledge Audit Workflow
 
-审查 spec / knowhow / artifact 三大知识存储，识别矛盾、失效、老化、孤儿，通过 keep/deprecate/delete 三态决策淘汰。
-
-与 `harvest.md` 对称：harvest 写入知识 → knowledge-audit 清理知识。与 `harvest --prune`（Stage 9）的区别：prune 做物理 GC（孤儿指针、格式损坏），audit 做语义审查（逻辑矛盾、生命周期决策）。
-
 ---
 
 ## Prerequisites

package/workflows/learn.md

@@ -1,15 +1,9 @@
 # Learn Workflow
 
-Atomic insight capture, search, and retrieval. Lightweight gstack-style "eureka moment" log that complements the retrospective workflow: where retrospective extracts insights from completed phases in bulk, `manage-learn` captures one insight at a time during active work.
-
 Storage:
 - `.workflow/specs/learnings.md` — append-only container of `<spec-entry>` sub-entries (shared with retrospective output)
 - Auto-indexed by WikiIndexer (no manual index required)
 
-**Shared store rationale:** Manual captures (`source: "manual"`), tips (`source: "tip"`), retrospective-distilled insights (`source: "retrospective"`, `lens: <name>` from `quality-retrospective`), and learn-retro insights (`source: "retro-git"` or `source: "retro-decision"` from `learn-retro`) all live in the same store so search and list see the entire knowledge corpus. The `source` field disambiguates origin.
-
-This workflow does NOT spawn sub-agents; it may invoke maestro CLI utilities (e.g. `maestro wiki search`, `maestro wiki list`) for list/search subcommands. The core capture flow is a thin file operation: parse → infer → append → confirm.
-
 ---
 
 ## Prerequisites

package/workflows/maestro.codex.md

@@ -1,9 +1,5 @@
 # Workflow: Maestro (Codex Edition)
 
-CSV wave coordinator version of the intelligent coordinator. Replaces `spawn_agent / wait / close_agent` loop with `spawn_agents_on_csv` (max_workers=1) for sequential pipeline execution. Each chain step is a CSV row with `skill_call` column; agents read prior results from session directory for context propagation.
-
-> Referenced by: `~/.codex/skills/maestro/SKILL.md`
-
 ---
 
 ## Step 1: Parse Arguments