mindforge-cc 11.8.2 → 11.9.0

package/.claude/commands/mindforge/systematic-debug.md

@@ -1,60 +0,0 @@
----
-description: "4-phase root cause debugging — understand the bug completely before attempting any fix."
----
-
-# MindForge — Systematic Debug Command
-# Usage: /mindforge:systematic-debug [problem description]
-
-Activates the systematic debugging skill. The iron law: **NO FIXES WITHOUT ROOT CAUSE INVESTIGATION FIRST**. Symptom fixes are failure.
-
-## Activation
-
-Load `.mindforge/skills/systematic-debugging/SKILL.md` immediately.
-Follow its 4-phase protocol for the full duration of this session.
-
-## Phase 1 — Understand the Bug
-
-Before touching any code:
-
-1. **Reproduce it.** Can you reproduce it in a minimal, isolated environment?
-   - If no: document what you tried. Ask the user for more context. Do not guess.
-   - If yes: record the exact reproduction steps.
-
-2. **Read the error completely.** Stack trace, logs, error message — read every line.
-
-3. **Identify the invariant.** What assumption is being violated? What should be true that isn't?
-
-4. **Map the control flow.** Trace the path from input to failure point.
-
-**Output of Phase 1:** A written statement of the root cause hypothesis with evidence.
-
-## Phase 2 — Isolate the Root Cause
-
-1. Write a failing test that exercises exactly the broken invariant.
-2. Confirm the test fails for the right reason (not just any reason).
-3. Narrow scope: is the bug in this file? This function? This line?
-4. Check: is this a regression? Run `git log --oneline -20` on affected files.
-
-**Gate:** Do not proceed to Phase 3 without a failing test that proves the bug.
-
-## Phase 3 — Fix
-
-1. Apply the minimal fix that restores the invariant.
-2. Do not fix adjacent issues or refactor — single responsibility per fix.
-3. Run the failing test — it must now pass.
-4. Run the full test suite — zero new failures allowed.
-
-## Phase 4 — Verify and Document
-
-1. Confirm the original reproduction steps no longer trigger the bug.
-2. Write a one-paragraph RCA summary: what was broken, why, how it was fixed.
-3. Commit with a message that explains the root cause, not the symptom.
-
-## When you cannot find the root cause
-
-- Add logging/instrumentation at the point of failure.
-- Form 2–3 competing hypotheses and test each independently.
-- Document what you ruled out — negative evidence is evidence.
-- Ask the user for additional context before guessing.
-
-Do not apply a fix that "might work." Every fix requires a root cause explanation.

package/.claude/commands/mindforge/wf-accessibility-audit.md

@@ -1,31 +0,0 @@
----
-description: "WCAG 2.2 parallel per-criterion audit → 3-vote adversarial verify failures → remediation spec"
----
-# /mindforge:wf-accessibility-audit
-
-Runs the **Accessibility Audit** dynamic workflow.
-
-## Usage
-`/mindforge:wf-accessibility-audit <UI codebase path or component>`
-
-## What it does
-- **Scope**: Define target UI and map components/pages to audit
-- **Audit**: 6 parallel WCAG principle auditors (Perceivable/Operable/Understandable/Robust + ARIA + Keyboard)
-- **Verify**: 3-vote adversarial verification of all Level A and AA failures
-- **Spec**: Remediation spec with exact ARIA attributes, HTML fixes, and WCAG references
-
-## Running
-
-Invoke via Claude Code's Workflow tool:
-
-```
-Workflow({
-  scriptPath: ".mindforge/dynamic-workflows/scripts/accessibility-audit.js",
-  args: "<your input>"
-})
-```
-
-Or discover via CLI:
-```bash
-node bin/mindforge-cli.js workflow info accessibility-audit
-```

package/.claude/commands/mindforge/wf-ai-model-eval.md

@@ -1,31 +0,0 @@
----
-description: "4-parallel model benchmark agents → scoring matrix → cost/performance recommendation"
----
-# /mindforge:wf-ai-model-eval
-
-Runs the **AI Model Evaluation** dynamic workflow.
-
-## Usage
-`/mindforge:wf-ai-model-eval <use case description>`
-
-## What it does
-- **Scope**: Define evaluation criteria and test prompts for the use case
-- **Benchmark**: 4 parallel model evaluators (quality / reasoning / speed / cost)
-- **Score**: Scoring matrix across all dimensions
-- **Recommend**: Ranked recommendation with break-even cost analysis
-
-## Running
-
-Invoke via Claude Code's Workflow tool:
-
-```
-Workflow({
-  scriptPath: ".mindforge/dynamic-workflows/scripts/ai-model-eval.js",
-  args: "<your input>"
-})
-```
-
-Or discover via CLI:
-```bash
-node bin/mindforge-cli.js workflow info ai-model-eval
-```

package/.claude/commands/mindforge/wf-api-migration.md

@@ -1,31 +0,0 @@
----
-description: "Breaking change detection → versioning strategy → migration guide → compatibility matrix"
----
-# /mindforge:wf-api-migration
-
-Runs the **API Migration** dynamic workflow.
-
-## Usage
-`/mindforge:wf-api-migration <old API path or description of changes>`
-
-## What it does
-- **Detect**: Detect breaking vs non-breaking changes between old and new API versions
-- **Version**: Propose versioning strategy: semver, URL versioning, or header versioning
-- **Guide**: Generate migration guide for API consumers
-- **Matrix**: Compatibility matrix: which client versions work with which API versions
-
-## Running
-
-Invoke via Claude Code's Workflow tool:
-
-```
-Workflow({
-  scriptPath: ".mindforge/dynamic-workflows/scripts/api-migration.js",
-  args: "<your input>"
-})
-```
-
-Or discover via CLI:
-```bash
-node bin/mindforge-cli.js workflow info api-migration
-```

package/.claude/commands/mindforge/wf-architecture-modernization.md

@@ -1,32 +0,0 @@
----
-description: "Legacy architecture map → target design → migration sequencing → risk gates"
----
-# /mindforge:wf-architecture-modernization
-
-Runs the **Architecture Modernization** dynamic workflow.
-
-## Usage
-`/mindforge:wf-architecture-modernization <codebase or modernization goal>`
-
-## What it does
-- **Map**: Map current architecture: components, dependencies, coupling, pain points
-- **Design**: 3 parallel target architecture proposals with trade-off analysis
-- **Select**: Judge panel selects best design, synthesizes hybrid
-- **Sequence**: Migration sequencing with risk gates and rollback checkpoints
-- **Roadmap**: Sprint-by-sprint modernization roadmap
-
-## Running
-
-Invoke via Claude Code's Workflow tool:
-
-```
-Workflow({
-  scriptPath: ".mindforge/dynamic-workflows/scripts/architecture-modernization.js",
-  args: "<your input>"
-})
-```
-
-Or discover via CLI:
-```bash
-node bin/mindforge-cli.js workflow info architecture-modernization
-```

package/.claude/commands/mindforge/wf-catalog.md

@@ -1,59 +0,0 @@
----
-description: "Browse the MindForge dynamic workflow library — 32 pre-built multi-agent workflows across 5 tiers"
----
-# /mindforge:wf-catalog
-
-Browse and discover the MindForge **Dynamic Workflow Library** — 32 pre-built multi-agent workflows that run via Claude Code's Workflow tool.
-
-## Usage
-`/mindforge:wf-catalog` — show all workflows grouped by tier
-
-## Tiers
-
-**Research** — Fan-out search, adversarial verification, cited synthesis
-- `/mindforge:wf-competitive-analysis` — SWOT and positioning summary
-- `/mindforge:wf-tech-evaluation` — Scored technology comparison matrix
-- `/mindforge:wf-ai-model-eval` — Benchmark AI models → scoring matrix → recommendation
-- `/mindforge:wf-ux-heuristic-audit` — 10 Nielsen heuristics parallel audit → fix brief
-- `/mindforge:wf-competitive-teardown` — 5 competitor angles → positioning report
-
-**Dev** — Coding-assistant power workflows
-- `/mindforge:wf-code-audit` — Parallel security + quality + performance audit
-- `/mindforge:wf-feature-planner` — Brief → PRD → architecture → user stories
-- `/mindforge:wf-pr-review` — 4-dimensional parallel PR review
-- `/mindforge:wf-tdd-sprint` — Strict Red-Green-Refactor TDD loop
-- `/mindforge:wf-refactor-plan` — Technical debt scan → safe refactor plan
-- `/mindforge:wf-test-coverage-gap` — Per-module coverage analysis → test-writing plan
-- `/mindforge:wf-api-contract-test` — Spec vs impl Writer/Reviewer → violation report
-- `/mindforge:wf-debug-detective` — 4-hypothesis parallel investigation → scientific RCA
-- `/mindforge:wf-writer-reviewer` — Implement → fresh context review → verdict
-- `/mindforge:wf-mutation-testing` — Mutant generator → parallel kill-test → score
-- `/mindforge:wf-code-explainer` — Structure → domain → architecture → narrative tour
-- `/mindforge:wf-design-system-audit` — 5-dimension parallel audit → consistency score
-
-**Ops** — Infrastructure and release workflows
-- `/mindforge:wf-incident-response` — Parallel investigation → RCA → postmortem
-- `/mindforge:wf-release-prep` — Tests → changelog → version bump → PR
-- `/mindforge:wf-dependency-health` — CVE + license + staleness audit → risk matrix
-- `/mindforge:wf-database-migration` — Schema diff → risk → scripts → runbook
-- `/mindforge:wf-multi-repo-sync` — Per-repo audit → divergence map → sync plan
-- `/mindforge:wf-cost-analysis` — Infra/API/query/bundle cost agents → ROI plan
-
-**Intelligence** — Deep analysis and optimization
-- `/mindforge:wf-onboard-codebase` — Map → domain → architecture → guided tour
-- `/mindforge:wf-perf-optimize` — Profile → bottleneck hunt → prioritized fix plan
-- `/mindforge:wf-architecture-modernization` — Legacy map → 3 designs → migration roadmap
-- `/mindforge:wf-documentation-gen` — Parallel doc gen → normalize → publish-ready
-- `/mindforge:wf-api-migration` — Breaking change detection → guide → compat matrix
-- `/mindforge:wf-data-pipeline-validate` — Stage-by-stage validation → quality gates
-
-**Beast** — Compound workflows (5 phases, 8+ agents, adversarial verification)
-- `/mindforge:wf-security-hardening` — 5-angle OWASP scout → 3-vote verify → STRIDE → roadmap
-- `/mindforge:wf-accessibility-audit` — WCAG 2.2 per-criterion → 3-vote verify → remediation spec
-- `/mindforge:wf-security-threat-model` — Asset inventory → STRIDE x6 → mitigations → CVSS matrix
-
-## CLI Discovery
-```bash
-node bin/mindforge-cli.js workflow list
-node bin/mindforge-cli.js workflow info <name>
-```

package/.claude/commands/mindforge/wf-code-audit.md

@@ -1,31 +0,0 @@
----
-description: "Parallel security + quality + performance audit with adversarial finding verification"
----
-# /mindforge:wf-code-audit
-
-Runs the **Code Audit** dynamic workflow.
-
-## Usage
-`/mindforge:wf-code-audit [path or 'current git diff']`
-
-## What it does
-- **Scope**: Builds file list from git diff, specified path, or entire codebase
-- **Audit**: 3 parallel auditors — OWASP security, code quality, performance patterns
-- **Verify**: Adversarial 2-vote verification for all high/critical severity findings
-- **Report**: Risk-ranked report with remediation steps for each confirmed finding
-
-## Running
-
-Invoke via Claude Code's Workflow tool:
-
-```
-Workflow({
-  scriptPath: ".mindforge/dynamic-workflows/scripts/code-audit.js",
-  args: "<your input>"
-})
-```
-
-Or discover via CLI:
-```bash
-node bin/mindforge-cli.js workflow info code-audit
-```

package/.claude/commands/mindforge/wf-code-explainer.md

@@ -1,31 +0,0 @@
----
-description: "Structural map → domain extraction → architecture patterns → guided narrative tour for onboarding"
----
-# /mindforge:wf-code-explainer
-
-Runs the **Code Explainer** dynamic workflow.
-
-## Usage
-`/mindforge:wf-code-explainer <codebase path or module to explain>`
-
-## What it does
-- **Structure**: Map file structure, entry points, and module boundaries
-- **Domain**: Extract domain concepts, business logic, and key abstractions
-- **Architecture**: Identify architectural patterns, data flow, and design decisions
-- **Tour**: Synthesize a guided narrative tour for a new developer
-
-## Running
-
-Invoke via Claude Code's Workflow tool:
-
-```
-Workflow({
-  scriptPath: ".mindforge/dynamic-workflows/scripts/code-explainer.js",
-  args: "<your input>"
-})
-```
-
-Or discover via CLI:
-```bash
-node bin/mindforge-cli.js workflow info code-explainer
-```

package/.claude/commands/mindforge/wf-competitive-analysis.md

@@ -1,31 +0,0 @@
----
-description: "Multi-angle competitive research producing a SWOT and positioning summary"
----
-# /mindforge:wf-competitive-analysis
-
-Runs the **Competitive Analysis** dynamic workflow.
-
-## Usage
-`/mindforge:wf-competitive-analysis <product/company/technology>`
-
-## What it does
-- **Scope**: Defines the competitive landscape target
-- **Research**: 5 parallel angles — product features, pricing, reviews, community, roadmap
-- **SWOT**: Synthesizes strengths, weaknesses, opportunities, threats
-- **Position**: Produces strategic positioning and differentiation recommendations
-
-## Running
-
-Invoke via Claude Code's Workflow tool:
-
-```
-Workflow({
-  scriptPath: ".mindforge/dynamic-workflows/scripts/competitive-analysis.js",
-  args: "<your input>"
-})
-```
-
-Or discover via CLI:
-```bash
-node bin/mindforge-cli.js workflow info competitive-analysis
-```

package/.claude/commands/mindforge/wf-competitive-teardown.md

@@ -1,31 +0,0 @@
----
-description: "5 parallel competitor angle agents → pipeline synthesis into competitive positioning report"
----
-# /mindforge:wf-competitive-teardown
-
-Runs the **Competitive Teardown** dynamic workflow.
-
-## Usage
-`/mindforge:wf-competitive-teardown <your product and competitors to analyze>`
-
-## What it does
-- **Scope**: Identify competitors and define evaluation framework
-- **Research**: 5 parallel competitor angle agents: product/tech/pricing/hiring/community
-- **Analyze**: Synthesize competitive landscape from all angles
-- **Synthesis**: Competitive positioning report with differentiation opportunities
-
-## Running
-
-Invoke via Claude Code's Workflow tool:
-
-```
-Workflow({
-  scriptPath: ".mindforge/dynamic-workflows/scripts/competitive-teardown.js",
-  args: "<your input>"
-})
-```
-
-Or discover via CLI:
-```bash
-node bin/mindforge-cli.js workflow info competitive-teardown
-```

package/.claude/commands/mindforge/wf-cost-analysis.md

@@ -1,31 +0,0 @@
----
-description: "Parallel infra/API/query/bundle cost agents → reduction plan with ROI estimates"
----
-# /mindforge:wf-cost-analysis
-
-Runs the **Cost Analysis** dynamic workflow.
-
-## Usage
-`/mindforge:wf-cost-analysis <project or service to analyze>`
-
-## What it does
-- **Scope**: Identify cost centers and establish current baseline
-- **Analyze**: 4 parallel cost dimension agents: infra / API / database / bundle
-- **Model**: Cost model with reduction opportunities and ROI estimates
-- **Plan**: Prioritized cost reduction plan with implementation steps
-
-## Running
-
-Invoke via Claude Code's Workflow tool:
-
-```
-Workflow({
-  scriptPath: ".mindforge/dynamic-workflows/scripts/cost-analysis.js",
-  args: "<your input>"
-})
-```
-
-Or discover via CLI:
-```bash
-node bin/mindforge-cli.js workflow info cost-analysis
-```

package/.claude/commands/mindforge/wf-data-pipeline-validate.md

@@ -1,31 +0,0 @@
----
-description: "Pipeline stage-by-stage validation → data quality gates → anomaly detection report"
----
-# /mindforge:wf-data-pipeline-validate
-
-Runs the **Data Pipeline Validation** dynamic workflow.
-
-## Usage
-`/mindforge:wf-data-pipeline-validate <pipeline directory or description>`
-
-## What it does
-- **Map**: Map all pipeline stages from source to sink
-- **Validate**: Parallel validation per stage (schema / completeness / transforms / outputs)
-- **Quality**: Data quality gate assessment — freshness, completeness, consistency
-- **Report**: Validation report with stage health scores and fix recommendations
-
-## Running
-
-Invoke via Claude Code's Workflow tool:
-
-```
-Workflow({
-  scriptPath: ".mindforge/dynamic-workflows/scripts/data-pipeline-validate.js",
-  args: "<your input>"
-})
-```
-
-Or discover via CLI:
-```bash
-node bin/mindforge-cli.js workflow info data-pipeline-validate
-```

package/.claude/commands/mindforge/wf-database-migration.md

@@ -1,31 +0,0 @@
----
-description: "Schema diff → risk analysis → migration scripts → rollback plan"
----
-# /mindforge:wf-database-migration
-
-Runs the **Database Migration** dynamic workflow.
-
-## Usage
-`/mindforge:wf-database-migration <migration files or schema diff path>`
-
-## What it does
-- **SchemaDiff**: Parse current and target schema, compute structural diff
-- **RiskAnalysis**: Assess data loss risk, locking impact, and rollback complexity
-- **Scripts**: Generate forward migration + rollback scripts
-- **Runbook**: Step-by-step production runbook with verification checks
-
-## Running
-
-Invoke via Claude Code's Workflow tool:
-
-```
-Workflow({
-  scriptPath: ".mindforge/dynamic-workflows/scripts/database-migration.js",
-  args: "<your input>"
-})
-```
-
-Or discover via CLI:
-```bash
-node bin/mindforge-cli.js workflow info database-migration
-```

package/.claude/commands/mindforge/wf-debug-detective.md

@@ -1,32 +0,0 @@
----
-description: "4-hypothesis parallel investigation → evidence gathering → scientific RCA"
----
-# /mindforge:wf-debug-detective
-
-Runs the **Debug Detective** dynamic workflow.
-
-## Usage
-`/mindforge:wf-debug-detective <bug description, symptoms, and context>`
-
-## What it does
-- **Intake**: Document symptoms, context, and reproduction steps
-- **Hypothesize**: 4 parallel hypothesis agents from different angles
-- **Evidence**: Parallel evidence gathering per hypothesis
-- **RCA**: Scientific root cause analysis from evidence
-- **Fix**: Targeted fix plan with regression test spec
-
-## Running
-
-Invoke via Claude Code's Workflow tool:
-
-```
-Workflow({
-  scriptPath: ".mindforge/dynamic-workflows/scripts/debug-detective.js",
-  args: "<your input>"
-})
-```
-
-Or discover via CLI:
-```bash
-node bin/mindforge-cli.js workflow info debug-detective
-```

package/.claude/commands/mindforge/wf-design-system-audit.md

@@ -1,31 +0,0 @@
----
-description: "5 parallel dimension auditors (spacing/color/typography/icons/a11y) → consistency score"
----
-# /mindforge:wf-design-system-audit
-
-Runs the **Design System Audit** dynamic workflow.
-
-## Usage
-`/mindforge:wf-design-system-audit <frontend codebase or design system path>`
-
-## What it does
-- **Inventory**: Discover design tokens, component files, and styling approach
-- **Audit**: 5 parallel dimension auditors: spacing, color, typography, icons, accessibility
-- **Score**: Aggregate consistency scores per dimension and overall
-- **Report**: Design system health report with specific violation fixes
-
-## Running
-
-Invoke via Claude Code's Workflow tool:
-
-```
-Workflow({
-  scriptPath: ".mindforge/dynamic-workflows/scripts/design-system-audit.js",
-  args: "<your input>"
-})
-```
-
-Or discover via CLI:
-```bash
-node bin/mindforge-cli.js workflow info design-system-audit
-```

package/.claude/commands/mindforge/wf-documentation-gen.md

@@ -1,31 +0,0 @@
----
-description: "Parallel per-file doc generation → style normalization → publish-ready documentation"
----
-# /mindforge:wf-documentation-gen
-
-Runs the **Documentation Generation** dynamic workflow.
-
-## Usage
-`/mindforge:wf-documentation-gen <codebase or module path>`
-
-## What it does
-- **Scope**: Discover files needing documentation
-- **Generate**: Parallel doc generation per file/module
-- **Normalize**: Style consistency pass across all generated docs
-- **Publish**: Assemble README, API reference, and changelog entries
-
-## Running
-
-Invoke via Claude Code's Workflow tool:
-
-```
-Workflow({
-  scriptPath: ".mindforge/dynamic-workflows/scripts/documentation-gen.js",
-  args: "<your input>"
-})
-```
-
-Or discover via CLI:
-```bash
-node bin/mindforge-cli.js workflow info documentation-gen
-```

package/.claude/commands/mindforge/wf-feature-planner.md

@@ -1,31 +0,0 @@
----
-description: "Sequential pipeline: brief → PRD → architecture → user stories"
----
-# /mindforge:wf-feature-planner
-
-Runs the **Feature Planner** dynamic workflow.
-
-## Usage
-`/mindforge:wf-feature-planner <feature description>`
-
-## What it does
-- **Brief**: Clarifies goals, target users, success criteria, and out-of-scope items
-- **PRD**: Generates functional + non-functional requirements with priorities
-- **Architecture**: Designs technical approach, components, data flow, files to create/modify
-- **Stories**: Breaks feature into user stories with Given/When/Then and t-shirt estimates
-
-## Running
-
-Invoke via Claude Code's Workflow tool:
-
-```
-Workflow({
-  scriptPath: ".mindforge/dynamic-workflows/scripts/feature-planner.js",
-  args: "<your input>"
-})
-```
-
-Or discover via CLI:
-```bash
-node bin/mindforge-cli.js workflow info feature-planner
-```

package/.claude/commands/mindforge/wf-incident-response.md

@@ -1,31 +0,0 @@
----
-description: "Parallel investigation across logs, metrics, traces, and code → mitigation → RCA → postmortem"
----
-# /mindforge:wf-incident-response
-
-Runs the **Incident Response** dynamic workflow.
-
-## Usage
-`/mindforge:wf-incident-response <incident description and symptoms>`
-
-## What it does
-- **Alert**: Characterizes severity (P0-P3), affected systems, and initial hypothesis
-- **Investigate**: 4 parallel agents — logs, metrics, distributed traces, recent code changes
-- **Mitigate**: Identifies immediate mitigation steps with risk level and rollback procedures
-- **RCA**: Blameless postmortem with root cause, timeline, action items, lessons learned
-
-## Running
-
-Invoke via Claude Code's Workflow tool:
-
-```
-Workflow({
-  scriptPath: ".mindforge/dynamic-workflows/scripts/incident-response.js",
-  args: "<your input>"
-})
-```
-
-Or discover via CLI:
-```bash
-node bin/mindforge-cli.js workflow info incident-response
-```

package/.claude/commands/mindforge/wf-multi-repo-sync.md

@@ -1,31 +0,0 @@
----
-description: "Parallel per-repo audit → cross-repo divergence map → sync plan"
----
-# /mindforge:wf-multi-repo-sync
-
-Runs the **Multi-Repo Sync** dynamic workflow.
-
-## Usage
-`/mindforge:wf-multi-repo-sync <workspace path or comma-separated repo paths>`
-
-## What it does
-- **Discover**: List target repos and their relationships
-- **Audit**: Parallel audit per repo for divergence from the reference
-- **DivergenceMap**: Cross-repo divergence map with severity
-- **SyncPlan**: Prioritized sync plan — what to align and how
-
-## Running
-
-Invoke via Claude Code's Workflow tool:
-
-```
-Workflow({
-  scriptPath: ".mindforge/dynamic-workflows/scripts/multi-repo-sync.js",
-  args: "<your input>"
-})
-```
-
-Or discover via CLI:
-```bash
-node bin/mindforge-cli.js workflow info multi-repo-sync
-```