mindforge-cc 11.3.1 → 11.5.0

package/.claude/commands/mindforge/ecommerce.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:ecommerce
+name: "mindforge:ecommerce"
 description: "Design ecommerce platform architecture. Usage: /mindforge:ecommerce [component] [--type marketplace|direct|hybrid]"
 argument-hint: "[component] [--type marketplace|direct|hybrid]"
 allowed-tools:

package/.claude/commands/mindforge/edge.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:edge
+name: "mindforge:edge"
 description: "Design edge computing architecture. Usage: /mindforge:edge [service] [--runtime workers|vercel|deno] [--regions global|specific]"
 argument-hint: "[service] [--runtime workers|vercel|deno] [--regions global|specific]"
 allowed-tools:

package/.claude/commands/mindforge/edtech.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:edtech
+name: "mindforge:edtech"
 description: "Design educational technology platform. Usage: /mindforge:edtech [component] [--type lms|assessment|adaptive]"
 argument-hint: "[component] [--type lms|assessment|adaptive]"
 allowed-tools:

package/.claude/commands/mindforge/embeddings.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:embeddings
+name: "mindforge:embeddings"
 description: "Design embedding and vector search system. Usage: /mindforge:embeddings [domain] [--db pinecone|weaviate|qdrant|pgvector] [--hybrid true|false]"
 argument-hint: "[domain] [--db pinecone|weaviate|qdrant|pgvector] [--hybrid true|false]"
 allowed-tools:

package/.claude/commands/mindforge/environments.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:environments
+name: "mindforge:environments"
 description: "Design environment management system. Usage: /mindforge:environments [scope] [--type preview|ephemeral|staging] [--lifecycle hours|days|permanent]"
 argument-hint: "[scope] [--type preview|ephemeral|staging] [--lifecycle hours|days|permanent]"
 allowed-tools:

package/.claude/commands/mindforge/eval.md

@@ -1,5 +1,5 @@
 ---
-description: Score the last task using eval-harness rubrics and track pass@k metrics. Usage - /mindforge:eval [eval-name] [--grader code|model|human] [--k 5] [--type capability|regression]
+description: "Score the last task using eval-harness rubrics and track pass@k metrics. Usage - /mindforge:eval [eval-name] [--grader code|model|human] [--k 5] [--type capability|regression]"
 ---
 
 <objective>

package/.claude/commands/mindforge/events.md

@@ -1,5 +1,5 @@
 ---
-description: Design event-driven message flow with ordering and delivery guarantees. Usage - /mindforge:events [domain] [--broker kafka|rabbitmq|sqs] [--guarantee at-least-once]
+description: "Design event-driven message flow with ordering and delivery guarantees. Usage - /mindforge:events [domain] [--broker kafka|rabbitmq|sqs] [--guarantee at-least-once]"
 ---
 
 <objective>

package/.claude/commands/mindforge/evolve-skills.md

@@ -1,5 +1,5 @@
 ---
-description: Review mature instincts and promote qualifying ones to full skills. Usage - /mindforge:evolve-skills [--dry-run] [--threshold 0.85] [--min-applications 5]
+description: "Review mature instincts and promote qualifying ones to full skills. Usage - /mindforge:evolve-skills [--dry-run] [--threshold 0.85] [--min-applications 5]"
 ---
 
 <objective>

package/.claude/commands/mindforge/execute-phase.md

@@ -1,5 +1,5 @@
 ---
-description: 1. Read STATE.md — confirm phase [N] is in "planned" status.
+description: "1. Read STATE.md — confirm phase [N] is in \"planned\" status."
 ---
 
 # MindForge — Execute Phase Command
@@ -80,19 +80,60 @@ Write to console:
 For each plan in the wave:
 1. Load context package (per `context-injector.md`)
 2. Execute the plan instructions
-   - Run `<verify>` — capture exact output
-   - If verify PASSES:
+   - Run the **5-Level Escalating Validation Ladder** (see below) as the `<verify>` body.
+     Capture exact output at each level.
+   - If all levels PASS:
      - Run `<verify-visual>` via `visual-verify-executor.js`
      - If visual verify FAILS: stop and report (treat as verify failure)
-     - Write SUMMARY-[N]-[M].md
+     - Write SUMMARY-[N]-[M].md (include the Deviation Report block, see below)
    - Execute commit: `git add [files] && git commit -m "[type]([scope]): [task name]"`
    - Capture git SHA
    - Write AUDIT entry for task completion
-5. If verify FAILS:
-   - Write SUMMARY-[N]-[M].md with failure details
+
+#### 5-Level Escalating Validation Ladder (per task)
+
+> Adapted from the PRP-implement validation loops (PRPs-agentic-eng by Wirasm).
+> Run levels **in order**. **Fix immediately** — never proceed past a failing
+> level, never accumulate broken state. Each higher level is more expensive and
+> more end-to-end than the last.
+
+- **Level 1 — Static**: formatter + linter + type-check (`[project lint command]`,
+  `[project lint-fix command]`, `[project type-check command]`).
+  EXPECT: zero lint errors, zero type errors. Auto-fix first, then fix manually.
+- **Level 2 — Unit**: run unit tests for the affected area (`[project test command]`).
+  EXPECT: all green; every new function has at least one test; plan edge cases covered.
+  If a test fails, fix the implementation (not the test, unless the test is wrong).
+- **Level 3 — Build**: `[project build command]`. EXPECT: build succeeds, zero errors.
+- **Level 4 — Integration**: start the service, hit it end-to-end, stop it
+  (`[project dev/integration command]`). EXPECT: integration assertions pass.
+  Skip with an explicit "N/A — no integration surface" note if not applicable.
+- **Level 5 — Edge / Manual**: walk the edge-case checklist from the plan's Testing
+  Strategy (empty input, max size, invalid types, concurrency, failure paths) plus
+  any manual checks the plan flags. EXPECT: all edge cases handled.
+
+**Fix-immediately rule**: A failing level halts the task. Diagnose, fix, re-run
+that level from the top, and only then climb to the next. Do NOT move to the next
+task with any level red.
+
+#### Deviation Report (record in each task's SUMMARY-[N]-[M].md)
+
+If implementation deviated from the plan, append a Deviation Report — never deviate
+silently:
+
+```markdown
+## Deviation Report
+| What changed | Why | Plan step affected | Re-validated? |
+|---|---|---|---|
+| [what differed from the plan] | [reason / root cause] | [task/step id] | [levels re-run] |
+```
+
+If there were no deviations, write `## Deviation Report\nNone — implemented exactly as planned.`
+
+5. If any validation level FAILS (and cannot be fixed in place per the fix-immediately rule):
+   - Write SUMMARY-[N]-[M].md with failure details (which level, exact output, Deviation Report)
    - Write AUDIT entry for task failure
    - STOP this wave immediately
-   - Report: "Task [plan ID] failed: [verify output]. Stopping Phase [N]."
+   - Report: "Task [plan ID] failed at Level [1-5]: [verify output]. Stopping Phase [N]."
    - Do not start next wave
    - Ask user: "Spawn debug agent to diagnose? (yes/no)"
 

package/.claude/commands/mindforge/feature-flags.md

@@ -1,5 +1,5 @@
 ---
-description: Design feature flag strategy with lifecycle management. Usage - /mindforge:feature-flags [feature] [--type release|experiment|operational] [--rollout 5%]
+description: "Design feature flag strategy with lifecycle management. Usage - /mindforge:feature-flags [feature] [--type release|experiment|operational] [--rollout 5%]"
 ---
 
 <objective>

package/.claude/commands/mindforge/feature-store.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:feature-store
+name: "mindforge:feature-store"
 description: "Design ML feature store. Usage: /mindforge:feature-store [domain] [--store feast|tecton|vertex] [--type batch|realtime|both]"
 argument-hint: "[domain] [--store feast|tecton|vertex] [--type batch|realtime|both]"
 allowed-tools:

package/.claude/commands/mindforge/finops.md

@@ -1,5 +1,5 @@
 ---
-description: Estimate and optimize cloud infrastructure costs. Usage - /mindforge:finops [service] [--forecast 6m] [--target-savings 20%]
+description: "Estimate and optimize cloud infrastructure costs. Usage - /mindforge:finops [service] [--forecast 6m] [--target-savings 20%]"
 ---
 
 <objective>

package/.claude/commands/mindforge/fintech.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:fintech
+name: "mindforge:fintech"
 description: "Design fintech payment/ledger architecture. Usage: /mindforge:fintech [service] [--domain payments|ledger|kyc] [--compliance pci|sox]"
 argument-hint: "[service] [--domain payments|ledger|kyc] [--compliance pci|sox]"
 allowed-tools:

package/.claude/commands/mindforge/flutter.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:flutter
+name: "mindforge:flutter"
 description: "Flutter architecture and pattern guidance. Usage: /mindforge:flutter [feature] [--state riverpod|bloc|provider]"
 argument-hint: "[feature] [--state riverpod|bloc|provider]"
 allowed-tools:

package/.claude/commands/mindforge/gaming.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:gaming
+name: "mindforge:gaming"
 description: "Design gaming backend architecture. Usage: /mindforge:gaming [feature] [--mode realtime|turn-based] [--scale small|massive]"
 argument-hint: "[feature] [--mode realtime|turn-based] [--scale small|massive]"
 allowed-tools:

package/.claude/commands/mindforge/graphql.md

@@ -1,5 +1,5 @@
 ---
-description: Design GraphQL schema and resolver architecture. Usage - /mindforge:graphql [domain] [--style code-first|schema-first] [--federation]
+description: "Design GraphQL schema and resolver architecture. Usage - /mindforge:graphql [domain] [--style code-first|schema-first] [--federation]"
 ---
 
 <objective>

package/.claude/commands/mindforge/harness-audit.md

@@ -0,0 +1,59 @@
+---
+description: "Run the deterministic harness-audit scorecard (0-10 per category) over the MindForge tree, with an optional LLM soft-signal layer."
+---
+
+# MindForge — Harness Audit Command
+# Usage: /mindforge:harness-audit [scope] [--format text|json]
+# Scopes: repo (default) | hooks | skills | commands | agents | security
+
+Two-layer harness health check. The DETERMINISTIC layer is `bin/harness-audit.js`
+(explicit file/config checks, reproducible, CI-gateable). The optional LLM layer
+adds soft signals the deterministic checks cannot see (quality, drift, coherence).
+
+## Step 1 — Run the deterministic scorecard
+
+```bash
+node bin/harness-audit.js              # text scorecard, repo scope
+node bin/harness-audit.js --format json # machine-readable (for CI / dashboards)
+node bin/harness-audit.js --scope security
+```
+
+The JSON contract is stable: `overall_score`, `max_score`, `categories`,
+`applicable_categories`, `rubric_version`, `checks[]`, `top_actions[]`. Categories:
+Tool Coverage, Context Efficiency, Quality Gates, Memory & Learning, Eval Coverage,
+Security Guardrails, Cost Efficiency, Governance & Identity.
+
+## Step 2 — (Optional) LLM soft-signal layer
+
+For each category scoring below 10/10, inspect the failing checks in `top_actions`
+and assess severity in context. The deterministic layer says *what* is missing; the
+LLM layer judges *whether it matters here* and proposes the highest-leverage fix.
+
+## Step 3 — Report + AUDIT entry
+
+Summarize the scorecard, then write a Merkle-linked AUDIT.jsonl entry:
+
+```json
+{
+  "event": "harness_audit_completed",
+  "scope": "repo",
+  "overall_score": 0,
+  "max_score": 0,
+  "rubric_version": "2026-06-10",
+  "failing_categories": [],
+  "top_actions": []
+}
+```
+
+## Relationship to /mindforge:health
+
+`/mindforge:health` calls this command as its deterministic layer. A regression
+(e.g. the `permissions.deny` baseline removed, the Gemini settings mirror desynced,
+the threat-model doc deleted) drops the Security Guardrails score and surfaces in
+`top_actions` — making harness drift visible and CI-blockable.
+
+## Related: cross-harness compliance
+
+`npm run harness:compliance` (`bin/installer/harness-adapter-compliance.js --check`)
+validates the per-harness support matrix and gates documentation drift — distinct
+from this scorecard, which audits the repo's own harness health.

package/.claude/commands/mindforge/health.md

@@ -1,5 +1,5 @@
 ---
-description: Run all seven health-engine categories from .mindforge/intelligence/health-engine.md.
+description: "Run all seven health-engine categories from .mindforge/intelligence/health-engine.md."
 ---
 
 # MindForge — Health Command

package/.claude/commands/mindforge/healthcare.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:healthcare
+name: "mindforge:healthcare"
 description: "Design HIPAA-compliant healthcare system architecture. Usage: /mindforge:healthcare [service] [--standard hipaa|hl7|fhir] [--scope full|audit]"
 argument-hint: "[service] [--standard hipaa|hl7|fhir] [--scope full|audit]"
 allowed-tools:

package/.claude/commands/mindforge/help.md

@@ -1,5 +1,5 @@
 ---
-description: Show all available MindForge commands.
+description: "Show all available MindForge commands."
 ---
 
 Show all available MindForge commands.

package/.claude/commands/mindforge/hire.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:hire
+name: "mindforge:hire"
 description: "Design technical interview process. Usage: /mindforge:hire [role] [--level junior|mid|senior|staff] [--type system-design|coding|behavioral]"
 argument-hint: "[role] [--level junior|mid|senior|staff] [--type system-design|coding|behavioral]"
 allowed-tools:

package/.claude/commands/mindforge/i18n.md

@@ -1,5 +1,5 @@
 ---
-description: Set up internationalization architecture. Usage - /mindforge:i18n [app] [--format icu] [--locales en,fr,ja] [--lazy-load]
+description: "Set up internationalization architecture. Usage - /mindforge:i18n [app] [--format icu] [--locales en,fr,ja] [--lazy-load]"
 ---
 
 <objective>

package/.claude/commands/mindforge/idempotent.md

@@ -1,5 +1,5 @@
 ---
-description: Design idempotency patterns for a service or API. Usage - /mindforge:idempotent [endpoint] [--key-strategy client|server] [--store redis|db]
+description: "Design idempotency patterns for a service or API. Usage - /mindforge:idempotent [endpoint] [--key-strategy client|server] [--store redis|db]"
 ---
 
 <objective>

package/.claude/commands/mindforge/init-org.md

@@ -1,5 +1,5 @@
 ---
-description: Set up MindForge at the organisation level — create standardised org-level
+description: "Set up MindForge at the organisation level — create standardised org-level"
 ---
 
 # MindForge — Init Org Command

package/.claude/commands/mindforge/init-project.md

@@ -1,5 +1,5 @@
 ---
-description: Initialise a new project under the MindForge framework.
+description: "Initialise a new project under the MindForge framework."
 ---
 
 Initialise a new project under the MindForge framework.

package/.claude/commands/mindforge/install-skill.md

@@ -1,5 +1,5 @@
 ---
-description: Follow the full installation protocol from .mindforge/distribution/registry-client.md.
+description: "Follow the full installation protocol from .mindforge/distribution/registry-client.md."
 ---
 
 Follow the full installation protocol from `.mindforge/distribution/registry-client.md`.

package/.claude/commands/mindforge/instinct.md

@@ -0,0 +1,46 @@
+---
+description: "Manage the instinct store via the deterministic instinct-CLI - list/projects/export/import/promote/prune. Usage - /mindforge:instinct <list|projects|export|import|promote|prune> [options]"
+---
+
+<objective>
+Inspect and maintain the project-scoped instinct store with the deterministic
+CLI (bin/learning/instinct-cli.js). Read-only views (list/projects) are always
+safe; mutating actions (import/promote/prune) require --force and support
+--dry-run. Promotion to a full skill stays with /mindforge:evolve-skills and
+/mindforge:cluster-instincts — this command only LISTS candidates.
+</objective>
+
+<execution_context>
+@.mindforge/engine/instincts/instinct-schema.md
+@.mindforge/skills/continuous-learning/SKILL.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+</context>
+
+<process>
+1. Parse the subcommand + flags from $ARGUMENTS and shell out to the CLI:
+   `node bin/learning/instinct-cli.js <subcommand> [flags]`
+   - `list [--project <id>|--all] [--status active|promoted|deprecated|pruned] [--json]`
+     — defaults to the current project's instincts plus `global`.
+   - `projects [--json]` — per-project counts, active count, avg confidence, last-applied.
+   - `export [--project <id>|--all] [--status <s>] [--min-confidence N] [-o file]`
+     — emits a JSONL subset (portable interchange) to stdout or a file.
+   - `import <file|https-url> [--scope project|global] [--min-confidence N] [--dry-run] [--force]`
+     — https-only + SSRF-guarded for URLs; dedups by id keeping higher confidence;
+       stamps project_id + source:imported. Default lists what WOULD import; --force writes.
+   - `promote [<id>] [--project <id>|--all] [--dry-run] [--force]`
+     — LISTS instincts meeting confidence ≥ threshold AND applied ≥ min; does NOT
+       create skills (run /mindforge:evolve-skills for that). --force only flags.
+   - `prune [--max-age <days>] [--dry-run] [--force]`
+     — flags low-confidence/high-applied or stale instincts as pruned; --force writes.
+2. Relay the CLI output. For mutating actions, prefer running --dry-run first and
+   showing the user the diff before re-running with --force.
+3. The CLI writes atomically under an advisory lock, so it is safe to run while
+   the capture hook is appending. It spawns no model and incurs no token cost.
+4. Optionally log an AUDIT entry for a mutating action (import/promote/prune).
+
+NOTE: this command and its .agent/mindforge/ mirror MUST be edited together —
+they are kept byte-identical.
+</process>

package/.claude/commands/mindforge/introspect.md

@@ -1,5 +1,5 @@
 ---
-description: Debug agent behavior or failures using 4-phase self-diagnosis. Usage - /mindforge:introspect [--last-failure] [--session] [--stuck]
+description: "Debug agent behavior or failures using 4-phase self-diagnosis. Usage - /mindforge:introspect [--last-failure] [--session] [--stuck]"
 ---
 
 <objective>

package/.claude/commands/mindforge/iot.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:iot
+name: "mindforge:iot"
 description: "Design IoT platform architecture. Usage: /mindforge:iot [component] [--protocol mqtt|coap|http] [--scale devices]"
 argument-hint: "[component] [--protocol mqtt|coap|http] [--scale devices]"
 allowed-tools:

package/.claude/commands/mindforge/knowledge-graph.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:knowledge-graph
+name: "mindforge:knowledge-graph"
 description: "Design knowledge graph architecture. Usage: /mindforge:knowledge-graph [domain] [--db neo4j|neptune|dgraph] [--scale nodes]"
 argument-hint: "[domain] [--db neo4j|neptune|dgraph] [--scale nodes]"
 allowed-tools:

package/.claude/commands/mindforge/lakehouse.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:lakehouse
+name: "mindforge:lakehouse"
 description: "Design data lakehouse architecture. Usage: /mindforge:lakehouse [domain] [--format delta|iceberg|hudi] [--layer bronze|silver|gold]"
 argument-hint: "[domain] [--format delta|iceberg|hudi] [--layer bronze|silver|gold]"
 allowed-tools:

package/.claude/commands/mindforge/lead.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:lead
+name: "mindforge:lead"
 description: "Technical leadership guidance and decision framework. Usage: /mindforge:lead [situation] [--context team|org|technical]"
 argument-hint: "[situation] [--context team|org|technical]"
 allowed-tools:

package/.claude/commands/mindforge/learn-instinct.md

@@ -1,5 +1,5 @@
 ---
-description: Manually capture a learned behavior as an instinct with initial confidence scoring. Usage - /mindforge:learn-instinct [observation] [--behavior "what to do"] [--confidence 0.7] [--tags tag1,tag2]
+description: "Manually capture a learned behavior as an instinct with initial confidence scoring. Usage - /mindforge:learn-instinct [observation] [--behavior \"what to do\"] [--confidence 0.7] [--tags tag1,tag2]"
 ---
 
 <objective>

package/.claude/commands/mindforge/learn.md

@@ -1,5 +1,5 @@
 ---
-description: Convert any knowledge source into a reusable, validated, committed MindForge SKILL.md.
+description: "Convert any knowledge source into a reusable, validated, committed MindForge SKILL.md."
 ---
 
 # MindForge v2 — Learn Command

package/.claude/commands/mindforge/learning.md

@@ -1,5 +1,5 @@
 ---
-description: Consult or initialize the project agentic learning memory - AGENTS_LEARNING.md
+description: "Consult or initialize the project agentic learning memory - AGENTS_LEARNING.md"
 ---
 
 # /mindforge:learning [init]

package/.claude/commands/mindforge/llm-route.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:llm-route
+name: "mindforge:llm-route"
 description: "Design LLM orchestration and routing. Usage: /mindforge:llm-route [system] [--strategy cascade|parallel|router] [--budget tokens]"
 argument-hint: "[system] [--strategy cascade|parallel|router] [--budget tokens]"
 allowed-tools:

package/.claude/commands/mindforge/load-test.md

@@ -1,5 +1,5 @@
 ---
-description: Design load test scenario with profiles. Usage - /mindforge:load-test [endpoint] [--profile ramp|spike|soak] [--target-rps N]
+description: "Design load test scenario with profiles. Usage - /mindforge:load-test [endpoint] [--profile ramp|spike|soak] [--target-rps N]"
 ---
 
 <objective>

package/.claude/commands/mindforge/logistics.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:logistics
+name: "mindforge:logistics"
 description: "Design logistics optimization system. Usage: /mindforge:logistics [component] [--type routing|warehouse|delivery]"
 argument-hint: "[component] [--type routing|warehouse|delivery]"
 allowed-tools:

package/.claude/commands/mindforge/map-codebase.md

@@ -1,5 +1,5 @@
 ---
-description: - Joining an existing project that has no MindForge context files
+description: "- Joining an existing project that has no MindForge context files"
 ---
 
 # MindForge — Map Codebase Command

package/.claude/commands/mindforge/marketplace.md

@@ -1,5 +1,5 @@
 ---
-description: Discover, evaluate, and install community-published MindForge skills from the
+description: "Discover, evaluate, and install community-published MindForge skills from the"
 ---
 
 # MindForge v2 — Marketplace Command

package/.claude/commands/mindforge/meeting-design.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:meeting-design
+name: "mindforge:meeting-design"
 description: "Design effective meeting or async process. Usage: /mindforge:meeting-design [purpose] [--format sync|async|hybrid] [--size small|large]"
 argument-hint: "[purpose] [--format sync|async|hybrid] [--size small|large]"
 allowed-tools:

package/.claude/commands/mindforge/metrics.md

@@ -1,5 +1,5 @@
 ---
-description: Display session and phase quality trends with early warning signals.
+description: "Display session and phase quality trends with early warning signals."
 ---
 
 # MindForge — Metrics Command

package/.claude/commands/mindforge/migrate.md

@@ -1,5 +1,5 @@
 ---
-description: Run explicit schema migrations for .planning/ files.
+description: "Run explicit schema migrations for .planning/ files."
 ---
 
 # MindForge — Migrate Command

package/.claude/commands/mindforge/migration-mgmt.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:migration-mgmt
+name: "mindforge:migration-mgmt"
 description: "Design migration orchestration platform. Usage: /mindforge:migration-mgmt [scope] [--type schema|data|infrastructure] [--downtime zero|planned]"
 argument-hint: "[scope] [--type schema|data|infrastructure] [--downtime zero|planned]"
 allowed-tools:

package/.claude/commands/mindforge/milestone.md

@@ -1,5 +1,5 @@
 ---
-description: Create or update a milestone definition in .planning/milestones/ and track the
+description: "Create or update a milestone definition in .planning/milestones/ and track the"
 ---
 
 Create or update a milestone definition in `.planning/milestones/` and track the

package/.claude/commands/mindforge/mobile.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:mobile
+name: "mindforge:mobile"
 description: "Design mobile app architecture. Usage: /mindforge:mobile [app] [--platform ios|android|cross] [--framework rn|flutter|native]"
 argument-hint: "[app] [--platform ios|android|cross] [--framework rn|flutter|native]"
 allowed-tools:

package/.claude/commands/mindforge/monorepo.md

@@ -1,5 +1,5 @@
 ---
-description: Set up monorepo with task pipelines. Usage - /mindforge:monorepo [--tool nx|turborepo] [--packages N]
+description: "Set up monorepo with task pipelines. Usage - /mindforge:monorepo [--tool nx|turborepo] [--packages N]"
 ---
 
 <objective>

package/.claude/commands/mindforge/multi-tenant.md

@@ -1,5 +1,5 @@
 ---
-description: Design multi-tenancy isolation strategy. Usage - /mindforge:multi-tenant [app] [--isolation rls|schema|database] [--routing subdomain|header]
+description: "Design multi-tenancy isolation strategy. Usage - /mindforge:multi-tenant [app] [--isolation rls|schema|database] [--routing subdomain|header]"
 ---
 
 <objective>

package/.claude/commands/mindforge/multimodal.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:multimodal
+name: "mindforge:multimodal"
 description: "Design multimodal AI system architecture. Usage: /mindforge:multimodal [system] [--modality vision|audio|text|multi] [--task generation|understanding|retrieval]"
 argument-hint: "[system] [--modality vision|audio|text|multi] [--task generation|understanding|retrieval]"
 allowed-tools:

package/.claude/commands/mindforge/new-runtime.md

@@ -1,5 +1,5 @@
 ---
-description: Scaffold support for a new AI coding runtime.
+description: "Scaffold support for a new AI coding runtime."
 ---
 
 # /mindforge:new-runtime

package/.claude/commands/mindforge/next.md

@@ -1,5 +1,5 @@
 ---
-description: Auto-detect the current project state and execute the appropriate next step.
+description: "Auto-detect the current project state and execute the appropriate next step."
 ---
 
 # MindForge — Next Command

package/.claude/commands/mindforge/note.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge:note
-description: Capture an idea, task, or issue that surfaces during a session as a quick note for later
+name: "mindforge:note"
+description: "Capture an idea, task, or issue that surfaces during a session as a quick note for later"
 argument-hint: <text> [list|promote N]
 allowed-tools:
   - list_dir

package/.claude/commands/mindforge/observability-platform.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:observability-platform
+name: "mindforge:observability-platform"
 description: "Design unified observability platform. Usage: /mindforge:observability-platform [scope] [--stack otel|datadog|grafana] [--scale services]"
 argument-hint: "[scope] [--stack otel|datadog|grafana] [--scale services]"
 allowed-tools:

package/.claude/commands/mindforge/offline.md

@@ -1,5 +1,5 @@
 ---
-name: mindforge:offline
+name: "mindforge:offline"
 description: "Design offline-first data architecture. Usage: /mindforge:offline [feature] [--sync crdt|ot|custom] [--conflict lww|merge|manual]"
 argument-hint: "[feature] [--sync crdt|ot|custom] [--conflict lww|merge|manual]"
 allowed-tools:

package/.claude/commands/mindforge/onboard.md

@@ -1,5 +1,5 @@
 ---
-description: Generate a knowledge graph, entry point summary, and learning path for the current or specified codebase. Usage - /mindforge:onboard [path] [--depth shallow|deep] [--output ONBOARDING-REPORT.md]
+description: "Generate a knowledge graph, entry point summary, and learning path for the current or specified codebase. Usage - /mindforge:onboard [path] [--depth shallow|deep] [--output ONBOARDING-REPORT.md]"
 ---
 
 <objective>