mindforge-cc 11.7.0 → 11.8.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (79) hide show
  1. package/.agent/mindforge/wf-accessibility-audit.md +31 -0
  2. package/.agent/mindforge/wf-ai-model-eval.md +31 -0
  3. package/.agent/mindforge/wf-api-contract-test.md +31 -0
  4. package/.agent/mindforge/wf-api-migration.md +31 -0
  5. package/.agent/mindforge/wf-architecture-modernization.md +32 -0
  6. package/.agent/mindforge/wf-catalog.md +25 -2
  7. package/.agent/mindforge/wf-code-explainer.md +31 -0
  8. package/.agent/mindforge/wf-competitive-teardown.md +31 -0
  9. package/.agent/mindforge/wf-cost-analysis.md +31 -0
  10. package/.agent/mindforge/wf-data-pipeline-validate.md +31 -0
  11. package/.agent/mindforge/wf-database-migration.md +31 -0
  12. package/.agent/mindforge/wf-debug-detective.md +32 -0
  13. package/.agent/mindforge/wf-dependency-health.md +31 -0
  14. package/.agent/mindforge/wf-design-system-audit.md +31 -0
  15. package/.agent/mindforge/wf-documentation-gen.md +31 -0
  16. package/.agent/mindforge/wf-multi-repo-sync.md +31 -0
  17. package/.agent/mindforge/wf-mutation-testing.md +31 -0
  18. package/.agent/mindforge/wf-security-hardening.md +32 -0
  19. package/.agent/mindforge/wf-security-threat-model.md +31 -0
  20. package/.agent/mindforge/wf-test-coverage-gap.md +31 -0
  21. package/.agent/mindforge/wf-ux-heuristic-audit.md +31 -0
  22. package/.agent/mindforge/wf-writer-reviewer.md +30 -0
  23. package/.claude/commands/mindforge/wf-accessibility-audit.md +31 -0
  24. package/.claude/commands/mindforge/wf-ai-model-eval.md +31 -0
  25. package/.claude/commands/mindforge/wf-api-contract-test.md +31 -0
  26. package/.claude/commands/mindforge/wf-api-migration.md +31 -0
  27. package/.claude/commands/mindforge/wf-architecture-modernization.md +32 -0
  28. package/.claude/commands/mindforge/wf-catalog.md +25 -2
  29. package/.claude/commands/mindforge/wf-code-explainer.md +31 -0
  30. package/.claude/commands/mindforge/wf-competitive-teardown.md +31 -0
  31. package/.claude/commands/mindforge/wf-cost-analysis.md +31 -0
  32. package/.claude/commands/mindforge/wf-data-pipeline-validate.md +31 -0
  33. package/.claude/commands/mindforge/wf-database-migration.md +31 -0
  34. package/.claude/commands/mindforge/wf-debug-detective.md +32 -0
  35. package/.claude/commands/mindforge/wf-dependency-health.md +31 -0
  36. package/.claude/commands/mindforge/wf-design-system-audit.md +31 -0
  37. package/.claude/commands/mindforge/wf-documentation-gen.md +31 -0
  38. package/.claude/commands/mindforge/wf-multi-repo-sync.md +31 -0
  39. package/.claude/commands/mindforge/wf-mutation-testing.md +31 -0
  40. package/.claude/commands/mindforge/wf-security-hardening.md +32 -0
  41. package/.claude/commands/mindforge/wf-security-threat-model.md +31 -0
  42. package/.claude/commands/mindforge/wf-test-coverage-gap.md +31 -0
  43. package/.claude/commands/mindforge/wf-ux-heuristic-audit.md +31 -0
  44. package/.claude/commands/mindforge/wf-writer-reviewer.md +30 -0
  45. package/.mindforge/config.json +2 -2
  46. package/.mindforge/dynamic-workflows/REGISTRY.md +58 -60
  47. package/.mindforge/dynamic-workflows/index.json +296 -0
  48. package/.mindforge/dynamic-workflows/scripts/accessibility-audit.js +119 -0
  49. package/.mindforge/dynamic-workflows/scripts/ai-model-eval.js +82 -0
  50. package/.mindforge/dynamic-workflows/scripts/api-contract-test.js +114 -0
  51. package/.mindforge/dynamic-workflows/scripts/api-migration.js +156 -0
  52. package/.mindforge/dynamic-workflows/scripts/architecture-modernization.js +111 -0
  53. package/.mindforge/dynamic-workflows/scripts/code-explainer.js +138 -0
  54. package/.mindforge/dynamic-workflows/scripts/competitive-teardown.js +142 -0
  55. package/.mindforge/dynamic-workflows/scripts/cost-analysis.js +107 -0
  56. package/.mindforge/dynamic-workflows/scripts/data-pipeline-validate.js +69 -0
  57. package/.mindforge/dynamic-workflows/scripts/database-migration.js +113 -0
  58. package/.mindforge/dynamic-workflows/scripts/debug-detective.js +124 -0
  59. package/.mindforge/dynamic-workflows/scripts/dependency-health.js +110 -0
  60. package/.mindforge/dynamic-workflows/scripts/design-system-audit.js +115 -0
  61. package/.mindforge/dynamic-workflows/scripts/documentation-gen.js +91 -0
  62. package/.mindforge/dynamic-workflows/scripts/multi-repo-sync.js +63 -0
  63. package/.mindforge/dynamic-workflows/scripts/mutation-testing.js +148 -0
  64. package/.mindforge/dynamic-workflows/scripts/security-hardening.js +154 -0
  65. package/.mindforge/dynamic-workflows/scripts/security-threat-model.js +159 -0
  66. package/.mindforge/dynamic-workflows/scripts/test-coverage-gap.js +95 -0
  67. package/.mindforge/dynamic-workflows/scripts/ux-heuristic-audit.js +122 -0
  68. package/.mindforge/dynamic-workflows/scripts/writer-reviewer.js +85 -0
  69. package/.mindforge/memory/sync-manifest.json +1 -1
  70. package/CHANGELOG.md +23 -0
  71. package/MINDFORGE.md +2 -2
  72. package/README.md +26 -4
  73. package/RELEASENOTES.md +36 -0
  74. package/bin/parse-workflow-args.js +47 -0
  75. package/bin/workflows/workflow-runner.js +18 -2
  76. package/docs/commands-reference.md +40 -14
  77. package/docs/getting-started.md +13 -1
  78. package/docs/user-guide.md +20 -1
  79. package/package.json +1 -1
@@ -0,0 +1,31 @@
1
+ ---
2
+ description: "Asset inventory → STRIDE threat enumeration → parallel mitigations → CVSS-style score matrix"
3
+ ---
4
+ # /mindforge:wf-security-threat-model
5
+
6
+ Runs the **Security Threat Model** dynamic workflow.
7
+
8
+ ## Usage
9
+ `/mindforge:wf-security-threat-model <system or codebase to threat model>`
10
+
11
+ ## What it does
12
+ - **Assets**: Inventory system assets, data flows, and trust boundaries
13
+ - **STRIDE**: 6 parallel STRIDE threat agents — one per threat category
14
+ - **Mitigate**: Parallel mitigation agent per identified threat
15
+ - **Score**: CVSS-style risk score matrix with remediation priority
16
+
17
+ ## Running
18
+
19
+ Invoke via Claude Code's Workflow tool:
20
+
21
+ ```
22
+ Workflow({
23
+ scriptPath: ".mindforge/dynamic-workflows/scripts/security-threat-model.js",
24
+ args: "<your input>"
25
+ })
26
+ ```
27
+
28
+ Or discover via CLI:
29
+ ```bash
30
+ node bin/mindforge-cli.js workflow info security-threat-model
31
+ ```
@@ -0,0 +1,31 @@
1
+ ---
2
+ description: "Parallel per-module coverage analysis → gap map → prioritized test-writing plan"
3
+ ---
4
+ # /mindforge:wf-test-coverage-gap
5
+
6
+ Runs the **Test Coverage Gap** dynamic workflow.
7
+
8
+ ## Usage
9
+ `/mindforge:wf-test-coverage-gap <target or question>`
10
+
11
+ ## What it does
12
+ - **Discover**: Map modules and identify testable units
13
+ - **Analyze**: Parallel coverage analysis per module
14
+ - **GapMap**: Synthesize gaps by severity and risk
15
+ - **Plan**: Prioritized test-writing plan with concrete test cases
16
+
17
+ ## Running
18
+
19
+ Invoke via Claude Code's Workflow tool:
20
+
21
+ ```
22
+ Workflow({
23
+ scriptPath: ".mindforge/dynamic-workflows/scripts/test-coverage-gap.js",
24
+ args: "<your input>"
25
+ })
26
+ ```
27
+
28
+ Or discover via CLI:
29
+ ```bash
30
+ node bin/mindforge-cli.js workflow info test-coverage-gap
31
+ ```
@@ -0,0 +1,31 @@
1
+ ---
2
+ description: "10 Nielsen heuristics parallel audit → severity ranking → fix brief"
3
+ ---
4
+ # /mindforge:wf-ux-heuristic-audit
5
+
6
+ Runs the **UX Heuristic Audit** dynamic workflow.
7
+
8
+ ## Usage
9
+ `/mindforge:wf-ux-heuristic-audit <UI codebase or app description>`
10
+
11
+ ## What it does
12
+ - **Scope**: Define target UI and identify key user flows to audit
13
+ - **Audit**: 10 parallel heuristic evaluators — one per Nielsen heuristic
14
+ - **Rank**: Severity ranking of all violations by impact on user experience
15
+ - **Brief**: Prioritized fix brief with specific design recommendations
16
+
17
+ ## Running
18
+
19
+ Invoke via Claude Code's Workflow tool:
20
+
21
+ ```
22
+ Workflow({
23
+ scriptPath: ".mindforge/dynamic-workflows/scripts/ux-heuristic-audit.js",
24
+ args: "<your input>"
25
+ })
26
+ ```
27
+
28
+ Or discover via CLI:
29
+ ```bash
30
+ node bin/mindforge-cli.js workflow info ux-heuristic-audit
31
+ ```
@@ -0,0 +1,30 @@
1
+ ---
2
+ description: "Anthropic Writer/Reviewer pattern: implement in Context A → fresh Context B reviews the diff"
3
+ ---
4
+ # /mindforge:wf-writer-reviewer
5
+
6
+ Runs the **Writer Reviewer** dynamic workflow.
7
+
8
+ ## Usage
9
+ `/mindforge:wf-writer-reviewer <implementation task description>`
10
+
11
+ ## What it does
12
+ - **Implement**: Writer agent implements the requested change
13
+ - **Review**: Fresh reviewer agent inspects only the diff without implementation context
14
+ - **Verdict**: Accept / request-changes verdict with specific actionable feedback
15
+
16
+ ## Running
17
+
18
+ Invoke via Claude Code's Workflow tool:
19
+
20
+ ```
21
+ Workflow({
22
+ scriptPath: ".mindforge/dynamic-workflows/scripts/writer-reviewer.js",
23
+ args: "<your input>"
24
+ })
25
+ ```
26
+
27
+ Or discover via CLI:
28
+ ```bash
29
+ node bin/mindforge-cli.js workflow info writer-reviewer
30
+ ```
@@ -1,11 +1,11 @@
1
1
  {
2
- "version": "11.7.0",
2
+ "version": "11.8.0",
3
3
  "environment": "development",
4
4
  "governance": {
5
5
  "drift_threshold": 0.75,
6
6
  "critical_drift_threshold": 0.5,
7
7
  "res_threshold": 0.8,
8
- "active_did": "did:mindforge:5a2153fe-8744-4cc6-907d-bcfbdeca23a6"
8
+ "active_did": "did:mindforge:a38ca026-98af-4484-a9bc-6011cfd57c48"
9
9
  },
10
10
  "revops": {
11
11
  "market_registry": {
@@ -1,65 +1,63 @@
1
1
  # MindForge Dynamic Workflow Registry
2
2
 
3
- Dynamic workflows are multi-agent JS orchestration scripts that run via Claude Code's `Workflow` tool. They use `parallel()`, `pipeline()`, `phase()`, and `agent()` primitives to fan out work across multiple concurrent subagents and synthesize results.
3
+ 33 pre-built multi-agent workflows across 5 tiers. Each runs via Claude Code's `Workflow` tool using `parallel()`, `pipeline()`, `phase()`, and `agent()` primitives to fan out work across concurrent subagents and synthesize results.
4
4
 
5
5
  **Trigger:** Use `/mindforge:wf-catalog` to browse interactively, or invoke any `/mindforge:wf-<name>` command directly.
6
6
 
7
- **Discovery:** `node bin/mindforge-cli.js workflow list`
8
-
9
- ---
10
-
11
- ## Research Tier Fan-out search, adversarial verification, cited output
12
-
13
- | Name | Command | Description | Phases |
14
- |------|---------|-------------|--------|
15
- | `deep-research` | `/mindforge:wf-deep-research` | Fan-out web research with adversarial claim verification and cited synthesis | Scope Search → Fetch → Verify → Synthesize |
16
- | `competitive-analysis` | `/mindforge:wf-competitive-analysis` | Multi-angle competitive research producing a SWOT and positioning summary | Scope Research → SWOT → Position |
17
- | `tech-evaluation` | `/mindforge:wf-tech-evaluation` | Scored technology evaluation across DX, performance, security, ecosystem, community | Scope → Evaluate → Score → Recommend |
18
-
19
- ## Dev Tier — Coding-assistant power workflows
20
-
21
- | Name | Command | Description | Phases |
22
- |------|---------|-------------|--------|
23
- | `code-audit` | `/mindforge:wf-code-audit` | Parallel security + quality + performance audit with adversarial finding verification | Scope Audit Verify → Report |
24
- | `feature-planner` | `/mindforge:wf-feature-planner` | Sequential pipeline: brief PRD architecture → user stories | Brief PRD Arch → Stories |
25
- | `pr-review` | `/mindforge:wf-pr-review` | 4-dimensional parallel PR review: correctness, security, performance, style → verdict | Scope Review Consensus → Verdict |
26
- | `tdd-sprint` | `/mindforge:wf-tdd-sprint` | Strict Red-Green-Refactor TDD loop with spec-first discipline | Spec Red Green Refactor |
27
- | `refactor-plan` | `/mindforge:wf-refactor-plan` | Debt scanrisk-sorted sequence → safe refactor implementation plan | Scan Prioritize Sequence → Plan |
28
-
29
- ## Ops Tier Infrastructure and release workflows
30
-
31
- | Name | Command | Description | Phases |
32
- |------|---------|-------------|--------|
33
- | `incident-response` | `/mindforge:wf-incident-response` | Parallel investigation: logs/metrics/traces/codemitigation RCA → postmortem | Alert Investigate Mitigate → RCA |
34
- | `release-prep` | `/mindforge:wf-release-prep` | Automated release pipeline: tests → changelog → version bump → PR → announcement | Check → Changelog → Bump → PR |
35
-
36
- ## Intelligence Tier — Deep analysis and optimization
37
-
38
- | Name | Command | Description | Phases |
39
- |------|---------|-------------|--------|
40
- | `onboard-codebase` | `/mindforge:wf-onboard-codebase` | Map structure domain analysis architectureguided tour and onboarding docs | Map Domain Arch → Tour |
41
- | `perf-optimize` | `/mindforge:wf-perf-optimize` | Profile parallel bottleneck hunt (DB/network/CPU/memory)prioritized fix plan | Profile Identify → Plan → Benchmark |
42
-
43
- ---
44
-
45
- ## Schema
46
-
47
- Each workflow script at `.mindforge/dynamic-workflows/scripts/<name>.js` exports:
48
-
49
- ```javascript
50
- export const meta = {
51
- name: '<name>', // matches filename (without .js)
52
- description: '<string>', // shown in this catalog
53
- whenToUse: '<string>', // trigger conditions
54
- phases: [{ title, detail }],
55
- }
56
- ```
57
-
58
- Scripts use the Claude Code `Workflow` tool primitives: `agent()`, `parallel()`, `pipeline()`, `phase()`, `log()`, `args`, `budget`.
59
-
60
- ## Adding a workflow
61
-
62
- 1. Write `.mindforge/dynamic-workflows/scripts/<name>.js` with a valid `meta` export
63
- 2. Add an entry to `index.json`
64
- 3. Add paired command files to `.agent/mindforge/wf-<name>.md` and `.claude/commands/mindforge/wf-<name>.md`
65
- 4. Run `npm test` — `tests/workflow-registry.test.js` validates all three steps
7
+ ## Research tier — Fan-out search, adversarial verification, cited synthesis
8
+
9
+ | Workflow | Command | Description | Best for |
10
+ |----------|---------|-------------|----------|
11
+ | deep-research | /mindforge:wf-deep-research | Fan-out web research with adversarial claim verification | Multi-source fact-checked research reports |
12
+ | competitive-analysis | /mindforge:wf-competitive-analysis | SWOT and positioning from 5 research angles | Evaluating products/companies against competitors |
13
+ | tech-evaluation | /mindforge:wf-tech-evaluation | Scored technology evaluation across 5 dimensions | Choosing frameworks, libraries, or platforms |
14
+ | ai-model-eval | /mindforge:wf-ai-model-eval | 4-parallel model benchmark → scoring matrix | Choosing between AI models or providers |
15
+ | ux-heuristic-audit | /mindforge:wf-ux-heuristic-audit | 10 Nielsen heuristics parallel audit fix brief | UI usability review |
16
+ | competitive-teardown | /mindforge:wf-competitive-teardown | 5 competitor angles positioning report | Deep competitive intelligence |
17
+
18
+ ## Dev tier — Coding-assistant power workflows
19
+
20
+ | Workflow | Command | Description | Best for |
21
+ |----------|---------|-------------|----------|
22
+ | code-audit | /mindforge:wf-code-audit | Parallel security + quality + performance audit | Pre-release or pre-pentest code review |
23
+ | feature-planner | /mindforge:wf-feature-planner | Brief PRD architecture user stories | Starting a new feature |
24
+ | pr-review | /mindforge:wf-pr-review | 4-dimensional parallel PR reviewverdict | Thorough pull request review |
25
+ | tdd-sprint | /mindforge:wf-tdd-sprint | Strict Red-Green-Refactor TDD loop | Implementing with test-driven development |
26
+ | refactor-plan | /mindforge:wf-refactor-plan | Debt scan risk-sorted safe refactor plan | Planning safe refactoring |
27
+ | test-coverage-gap | /mindforge:wf-test-coverage-gap | Per-module coverage analysis test-writing plan | Finding and fixing test gaps |
28
+ | api-contract-test | /mindforge:wf-api-contract-test | Writer/Reviewer spec vs impl → violation report | API contract validation |
29
+ | debug-detective | /mindforge:wf-debug-detective | 4-hypothesis parallel investigation → scientific RCA | Hard-to-reproduce bugs |
30
+ | writer-reviewer | /mindforge:wf-writer-reviewer | Implement → fresh context review → verdict | Unbiased code review |
31
+ | mutation-testing | /mindforge:wf-mutation-testing | Mutant generator → parallel kill-test → score | Test suite effectiveness |
32
+ | code-explainer | /mindforge:wf-code-explainer | Structure → domain → architecture → narrative tour | Onboarding to unfamiliar codebases |
33
+ | design-system-audit | /mindforge:wf-design-system-audit | 5-dimension parallel auditconsistency score | Design system health checks |
34
+
35
+ ## Ops tier — Infrastructure and release workflows
36
+
37
+ | Workflow | Command | Description | Best for |
38
+ |----------|---------|-------------|----------|
39
+ | incident-response | /mindforge:wf-incident-response | Parallel investigation → mitigation → RCA → postmortem | Production incidents |
40
+ | release-prep | /mindforge:wf-release-prep | Testschangelogversion bump PR | Preparing a production release |
41
+ | dependency-health | /mindforge:wf-dependency-health | CVE + license + staleness auditrisk matrix | Pre-release dependency review |
42
+ | database-migration | /mindforge:wf-database-migration | Schema diff → risk → scripts → runbook | Database schema migrations |
43
+ | multi-repo-sync | /mindforge:wf-multi-repo-sync | Per-repo audit → divergence map → sync plan | Multi-repo consistency |
44
+ | cost-analysis | /mindforge:wf-cost-analysis | Infra/API/query/bundle cost agents → ROI plan | Cloud and API cost reduction |
45
+
46
+ ## Intelligence tier — Deep analysis and optimization
47
+
48
+ | Workflow | Command | Description | Best for |
49
+ |----------|---------|-------------|----------|
50
+ | onboard-codebase | /mindforge:wf-onboard-codebase | Map → domain → architecture → guided tour | New team member onboarding |
51
+ | perf-optimize | /mindforge:wf-perf-optimize | Profile bottleneck hunt → prioritized fix plan | Performance bottleneck investigation |
52
+ | architecture-modernization | /mindforge:wf-architecture-modernization | Legacy map 3 designs → migration roadmap | Monolith-to-services, major rewrites |
53
+ | documentation-gen | /mindforge:wf-documentation-gen | Parallel doc gen → normalize → publish-ready | Generating or refreshing docs |
54
+ | api-migration | /mindforge:wf-api-migration | Breaking change detection → guide → compat matrix | API versioning and migration |
55
+ | data-pipeline-validate | /mindforge:wf-data-pipeline-validate | Stage-by-stage validation → quality gates | Data pipeline correctness checks |
56
+
57
+ ## Beast tier — Compound workflows (5 phases, 8+ agents, adversarial verification)
58
+
59
+ | Workflow | Command | Description | Best for |
60
+ |----------|---------|-------------|----------|
61
+ | security-hardening | /mindforge:wf-security-hardening | 5-angle OWASP scout → 3-vote verify → STRIDE → roadmap | Pre-launch security hardening |
62
+ | accessibility-audit | /mindforge:wf-accessibility-audit | WCAG 2.2 per-criterion → 3-vote verify → remediation spec | WCAG 2.2 compliance |
63
+ | security-threat-model | /mindforge:wf-security-threat-model | Asset inventory → STRIDE x 6 → mitigations → CVSS matrix | Architecture threat modeling |
@@ -42,6 +42,48 @@
42
42
  { "title": "Recommend", "detail": "Produce ranked recommendation with trade-offs" }
43
43
  ]
44
44
  },
45
+ {
46
+ "name": "ai-model-eval",
47
+ "description": "4-parallel model benchmark agents → scoring matrix → cost/performance recommendation",
48
+ "whenToUse": "When choosing between AI models or providers for a use case",
49
+ "tier": "research",
50
+ "command": "/mindforge:wf-ai-model-eval",
51
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/ai-model-eval.js",
52
+ "phases": [
53
+ { "title": "Scope", "detail": "Define evaluation criteria and test prompts for the use case" },
54
+ { "title": "Benchmark", "detail": "4 parallel model evaluators (quality / reasoning / speed / cost)" },
55
+ { "title": "Score", "detail": "Scoring matrix across all dimensions" },
56
+ { "title": "Recommend", "detail": "Ranked recommendation with break-even cost analysis" }
57
+ ]
58
+ },
59
+ {
60
+ "name": "ux-heuristic-audit",
61
+ "description": "10 Nielsen heuristics parallel audit → severity ranking → fix brief",
62
+ "whenToUse": "When auditing a UI for usability issues using Nielsen's 10 heuristics",
63
+ "tier": "research",
64
+ "command": "/mindforge:wf-ux-heuristic-audit",
65
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/ux-heuristic-audit.js",
66
+ "phases": [
67
+ { "title": "Scope", "detail": "Define target UI and identify key user flows to audit" },
68
+ { "title": "Audit", "detail": "10 parallel heuristic evaluators — one per Nielsen heuristic" },
69
+ { "title": "Rank", "detail": "Severity ranking of all violations by impact on user experience" },
70
+ { "title": "Brief", "detail": "Prioritized fix brief with specific design recommendations" }
71
+ ]
72
+ },
73
+ {
74
+ "name": "competitive-teardown",
75
+ "description": "5 parallel competitor angle agents → pipeline synthesis into competitive positioning report",
76
+ "whenToUse": "When doing a deep competitive teardown across product, tech, pricing, hiring, and community",
77
+ "tier": "research",
78
+ "command": "/mindforge:wf-competitive-teardown",
79
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/competitive-teardown.js",
80
+ "phases": [
81
+ { "title": "Scope", "detail": "Identify competitors and define evaluation framework" },
82
+ { "title": "Research", "detail": "5 parallel competitor angle agents: product/tech/pricing/hiring/community" },
83
+ { "title": "Analyze", "detail": "Synthesize competitive landscape from all angles" },
84
+ { "title": "Synthesis", "detail": "Competitive positioning report with differentiation opportunities" }
85
+ ]
86
+ },
45
87
  {
46
88
  "name": "code-audit",
47
89
  "description": "Parallel security + quality + performance audit with adversarial finding verification",
@@ -112,6 +154,104 @@
112
154
  { "title": "Plan", "detail": "Produce step-by-step refactor plan with verification gates" }
113
155
  ]
114
156
  },
157
+ {
158
+ "name": "test-coverage-gap",
159
+ "description": "Parallel per-module coverage analysis → gap map → prioritized test-writing plan",
160
+ "whenToUse": "When you need to find and fix test coverage gaps across a codebase or module",
161
+ "tier": "dev",
162
+ "command": "/mindforge:wf-test-coverage-gap",
163
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/test-coverage-gap.js",
164
+ "phases": [
165
+ { "title": "Discover", "detail": "Map modules and identify testable units" },
166
+ { "title": "Analyze", "detail": "Parallel coverage analysis per module" },
167
+ { "title": "GapMap", "detail": "Synthesize gaps by severity and risk" },
168
+ { "title": "Plan", "detail": "Prioritized test-writing plan with concrete test cases" }
169
+ ]
170
+ },
171
+ {
172
+ "name": "api-contract-test",
173
+ "description": "Writer/Reviewer pattern: spec reader vs implementation reader → contract violation report",
174
+ "whenToUse": "When validating that an API implementation matches its OpenAPI/GraphQL/Protobuf spec",
175
+ "tier": "dev",
176
+ "command": "/mindforge:wf-api-contract-test",
177
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/api-contract-test.js",
178
+ "phases": [
179
+ { "title": "ReadSpec", "detail": "Parse the API specification (OpenAPI/GraphQL/Protobuf/docs)" },
180
+ { "title": "ReadImpl", "detail": "Read the actual implementation in a fresh context" },
181
+ { "title": "Diff", "detail": "Cross-reference spec contracts vs implementation" },
182
+ { "title": "Report", "detail": "Violation report with severity and fix instructions" }
183
+ ]
184
+ },
185
+ {
186
+ "name": "debug-detective",
187
+ "description": "4-hypothesis parallel investigation → evidence gathering → scientific RCA",
188
+ "whenToUse": "When debugging a hard-to-reproduce bug or production issue with unclear root cause",
189
+ "tier": "dev",
190
+ "command": "/mindforge:wf-debug-detective",
191
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/debug-detective.js",
192
+ "phases": [
193
+ { "title": "Intake", "detail": "Document symptoms, context, and reproduction steps" },
194
+ { "title": "Hypothesize", "detail": "4 parallel hypothesis agents from different angles" },
195
+ { "title": "Evidence", "detail": "Parallel evidence gathering per hypothesis" },
196
+ { "title": "RCA", "detail": "Scientific root cause analysis from evidence" },
197
+ { "title": "Fix", "detail": "Targeted fix plan with regression test spec" }
198
+ ]
199
+ },
200
+ {
201
+ "name": "writer-reviewer",
202
+ "description": "Anthropic Writer/Reviewer pattern: implement in Context A → fresh Context B reviews the diff",
203
+ "whenToUse": "When you want unbiased code review — a fresh context reviewer has no bias toward code it did not write",
204
+ "tier": "dev",
205
+ "command": "/mindforge:wf-writer-reviewer",
206
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/writer-reviewer.js",
207
+ "phases": [
208
+ { "title": "Implement", "detail": "Writer agent implements the requested change" },
209
+ { "title": "Review", "detail": "Fresh reviewer agent inspects only the diff without implementation context" },
210
+ { "title": "Verdict", "detail": "Accept / request-changes verdict with specific actionable feedback" }
211
+ ]
212
+ },
213
+ {
214
+ "name": "mutation-testing",
215
+ "description": "Mutant generator → parallel kill-test agents → mutation score + survival report",
216
+ "whenToUse": "When evaluating test suite effectiveness by checking if tests catch deliberate code mutations",
217
+ "tier": "dev",
218
+ "command": "/mindforge:wf-mutation-testing",
219
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/mutation-testing.js",
220
+ "phases": [
221
+ { "title": "Analyze", "detail": "Identify mutable source lines: conditions, operators, return values" },
222
+ { "title": "Mutate", "detail": "Generate 10-15 specific mutation descriptions" },
223
+ { "title": "Kill", "detail": "Parallel kill-test per mutation — would existing tests catch it?" },
224
+ { "title": "Report", "detail": "Mutation score report with killed/survived/timeout breakdown" }
225
+ ]
226
+ },
227
+ {
228
+ "name": "code-explainer",
229
+ "description": "Structural map → domain extraction → architecture patterns → guided narrative tour for onboarding",
230
+ "whenToUse": "When onboarding to an unfamiliar codebase or explaining a complex module to a new developer",
231
+ "tier": "dev",
232
+ "command": "/mindforge:wf-code-explainer",
233
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/code-explainer.js",
234
+ "phases": [
235
+ { "title": "Structure", "detail": "Map file structure, entry points, and module boundaries" },
236
+ { "title": "Domain", "detail": "Extract domain concepts, business logic, and key abstractions" },
237
+ { "title": "Architecture", "detail": "Identify architectural patterns, data flow, and design decisions" },
238
+ { "title": "Tour", "detail": "Synthesize a guided narrative tour for a new developer" }
239
+ ]
240
+ },
241
+ {
242
+ "name": "design-system-audit",
243
+ "description": "5 parallel dimension auditors (spacing/color/typography/icons/a11y) → consistency score",
244
+ "whenToUse": "When auditing a frontend codebase for design system consistency and token usage",
245
+ "tier": "dev",
246
+ "command": "/mindforge:wf-design-system-audit",
247
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/design-system-audit.js",
248
+ "phases": [
249
+ { "title": "Inventory", "detail": "Discover design tokens, component files, and styling approach" },
250
+ { "title": "Audit", "detail": "5 parallel dimension auditors: spacing, color, typography, icons, accessibility" },
251
+ { "title": "Score", "detail": "Aggregate consistency scores per dimension and overall" },
252
+ { "title": "Report", "detail": "Design system health report with specific violation fixes" }
253
+ ]
254
+ },
115
255
  {
116
256
  "name": "incident-response",
117
257
  "description": "Parallel investigation across logs, metrics, traces, and code → mitigation → RCA → postmortem",
@@ -140,6 +280,62 @@
140
280
  { "title": "PR", "detail": "Create release PR and draft announcement" }
141
281
  ]
142
282
  },
283
+ {
284
+ "name": "dependency-health",
285
+ "description": "Parallel per-dependency audit (CVEs / licenses / staleness / maintenance) → risk matrix",
286
+ "whenToUse": "When auditing dependencies before a release, security review, or due diligence",
287
+ "tier": "ops",
288
+ "command": "/mindforge:wf-dependency-health",
289
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/dependency-health.js",
290
+ "phases": [
291
+ { "title": "Inventory", "detail": "Extract full dependency tree from package manifests" },
292
+ { "title": "Audit", "detail": "Parallel audit per batch: CVEs, license risk, staleness, maintenance status" },
293
+ { "title": "RiskMatrix", "detail": "Consolidate into risk matrix with severity tiers" },
294
+ { "title": "Action", "detail": "Prioritized upgrade / replace / accept recommendations" }
295
+ ]
296
+ },
297
+ {
298
+ "name": "database-migration",
299
+ "description": "Schema diff → risk analysis → migration scripts → rollback plan",
300
+ "whenToUse": "When planning or reviewing a database schema migration",
301
+ "tier": "ops",
302
+ "command": "/mindforge:wf-database-migration",
303
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/database-migration.js",
304
+ "phases": [
305
+ { "title": "SchemaDiff", "detail": "Parse current and target schema, compute structural diff" },
306
+ { "title": "RiskAnalysis", "detail": "Assess data loss risk, locking impact, and rollback complexity" },
307
+ { "title": "Scripts", "detail": "Generate forward migration + rollback scripts" },
308
+ { "title": "Runbook", "detail": "Step-by-step production runbook with verification checks" }
309
+ ]
310
+ },
311
+ {
312
+ "name": "multi-repo-sync",
313
+ "description": "Parallel per-repo audit → cross-repo divergence map → sync plan",
314
+ "whenToUse": "When managing multiple related repos and need to find/fix divergence in shared config, deps, or conventions",
315
+ "tier": "ops",
316
+ "command": "/mindforge:wf-multi-repo-sync",
317
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/multi-repo-sync.js",
318
+ "phases": [
319
+ { "title": "Discover", "detail": "List target repos and their relationships" },
320
+ { "title": "Audit", "detail": "Parallel audit per repo for divergence from the reference" },
321
+ { "title": "DivergenceMap", "detail": "Cross-repo divergence map with severity" },
322
+ { "title": "SyncPlan", "detail": "Prioritized sync plan — what to align and how" }
323
+ ]
324
+ },
325
+ {
326
+ "name": "cost-analysis",
327
+ "description": "Parallel infra/API/query/bundle cost agents → reduction plan with ROI estimates",
328
+ "whenToUse": "When analyzing and reducing infrastructure, API, database, or bundle costs",
329
+ "tier": "ops",
330
+ "command": "/mindforge:wf-cost-analysis",
331
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/cost-analysis.js",
332
+ "phases": [
333
+ { "title": "Scope", "detail": "Identify cost centers and establish current baseline" },
334
+ { "title": "Analyze", "detail": "4 parallel cost dimension agents: infra / API / database / bundle" },
335
+ { "title": "Model", "detail": "Cost model with reduction opportunities and ROI estimates" },
336
+ { "title": "Plan", "detail": "Prioritized cost reduction plan with implementation steps" }
337
+ ]
338
+ },
143
339
  {
144
340
  "name": "onboard-codebase",
145
341
  "description": "Map structure → domain analysis → architecture → generate guided tour and onboarding docs",
@@ -167,5 +363,105 @@
167
363
  { "title": "Plan", "detail": "Prioritize fixes by impact-to-effort ratio" },
168
364
  { "title": "Benchmark", "detail": "Define verification benchmarks for each fix" }
169
365
  ]
366
+ },
367
+ {
368
+ "name": "architecture-modernization",
369
+ "description": "Legacy architecture map → target design → migration sequencing → risk gates",
370
+ "whenToUse": "When planning a major architecture overhaul: monolith-to-services, framework upgrade, or platform migration",
371
+ "tier": "intelligence",
372
+ "command": "/mindforge:wf-architecture-modernization",
373
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/architecture-modernization.js",
374
+ "phases": [
375
+ { "title": "Map", "detail": "Map current architecture: components, dependencies, coupling, pain points" },
376
+ { "title": "Design", "detail": "3 parallel target architecture proposals with trade-off analysis" },
377
+ { "title": "Select", "detail": "Judge panel selects best design, synthesizes hybrid" },
378
+ { "title": "Sequence", "detail": "Migration sequencing with risk gates and rollback checkpoints" },
379
+ { "title": "Roadmap", "detail": "Sprint-by-sprint modernization roadmap" }
380
+ ]
381
+ },
382
+ {
383
+ "name": "documentation-gen",
384
+ "description": "Parallel per-file doc generation → style normalization → publish-ready documentation",
385
+ "whenToUse": "When generating or refreshing documentation for a codebase, API, or module",
386
+ "tier": "intelligence",
387
+ "command": "/mindforge:wf-documentation-gen",
388
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/documentation-gen.js",
389
+ "phases": [
390
+ { "title": "Scope", "detail": "Discover files needing documentation" },
391
+ { "title": "Generate", "detail": "Parallel doc generation per file/module" },
392
+ { "title": "Normalize", "detail": "Style consistency pass across all generated docs" },
393
+ { "title": "Publish", "detail": "Assemble README, API reference, and changelog entries" }
394
+ ]
395
+ },
396
+ {
397
+ "name": "api-migration",
398
+ "description": "Breaking change detection → versioning strategy → migration guide → compatibility matrix",
399
+ "whenToUse": "When planning or communicating an API version migration to consumers",
400
+ "tier": "intelligence",
401
+ "command": "/mindforge:wf-api-migration",
402
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/api-migration.js",
403
+ "phases": [
404
+ { "title": "Detect", "detail": "Detect breaking vs non-breaking changes between old and new API versions" },
405
+ { "title": "Version", "detail": "Propose versioning strategy: semver, URL versioning, or header versioning" },
406
+ { "title": "Guide", "detail": "Generate migration guide for API consumers" },
407
+ { "title": "Matrix", "detail": "Compatibility matrix: which client versions work with which API versions" }
408
+ ]
409
+ },
410
+ {
411
+ "name": "data-pipeline-validate",
412
+ "description": "Pipeline stage-by-stage validation → data quality gates → anomaly detection report",
413
+ "whenToUse": "When validating a data pipeline for correctness, completeness, and quality before production use",
414
+ "tier": "intelligence",
415
+ "command": "/mindforge:wf-data-pipeline-validate",
416
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/data-pipeline-validate.js",
417
+ "phases": [
418
+ { "title": "Map", "detail": "Map all pipeline stages from source to sink" },
419
+ { "title": "Validate", "detail": "Parallel validation per stage (schema / completeness / transforms / outputs)" },
420
+ { "title": "Quality", "detail": "Data quality gate assessment — freshness, completeness, consistency" },
421
+ { "title": "Report", "detail": "Validation report with stage health scores and fix recommendations" }
422
+ ]
423
+ },
424
+ {
425
+ "name": "security-hardening",
426
+ "description": "5-angle OWASP parallel scout → 3-vote adversarial verification → threat model + remediation roadmap",
427
+ "whenToUse": "When hardening a codebase before a security review, pentest, or production launch",
428
+ "tier": "beast",
429
+ "command": "/mindforge:wf-security-hardening",
430
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/security-hardening.js",
431
+ "phases": [
432
+ { "title": "Scope", "detail": "Define attack surface and target context" },
433
+ { "title": "Scout", "detail": "5 parallel OWASP/CWE dimension scouts" },
434
+ { "title": "Verify", "detail": "3-vote adversarial verification per critical finding" },
435
+ { "title": "ThreatModel", "detail": "STRIDE threat model from confirmed findings" },
436
+ { "title": "Roadmap", "detail": "Prioritized remediation roadmap with severity/effort matrix" }
437
+ ]
438
+ },
439
+ {
440
+ "name": "accessibility-audit",
441
+ "description": "WCAG 2.2 parallel per-criterion audit → 3-vote adversarial verify failures → remediation spec",
442
+ "whenToUse": "When auditing a UI for WCAG 2.2 compliance before launch, legal review, or accessibility certification",
443
+ "tier": "beast",
444
+ "command": "/mindforge:wf-accessibility-audit",
445
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/accessibility-audit.js",
446
+ "phases": [
447
+ { "title": "Scope", "detail": "Define target UI and map components/pages to audit" },
448
+ { "title": "Audit", "detail": "6 parallel WCAG principle auditors (Perceivable/Operable/Understandable/Robust + ARIA + Keyboard)" },
449
+ { "title": "Verify", "detail": "3-vote adversarial verification of all Level A and AA failures" },
450
+ { "title": "Spec", "detail": "Remediation spec with exact ARIA attributes, HTML fixes, and WCAG references" }
451
+ ]
452
+ },
453
+ {
454
+ "name": "security-threat-model",
455
+ "description": "Asset inventory → STRIDE threat enumeration → parallel mitigations → CVSS-style score matrix",
456
+ "whenToUse": "When threat modeling a system architecture, API, or new feature before building",
457
+ "tier": "beast",
458
+ "command": "/mindforge:wf-security-threat-model",
459
+ "scriptPath": ".mindforge/dynamic-workflows/scripts/security-threat-model.js",
460
+ "phases": [
461
+ { "title": "Assets", "detail": "Inventory system assets, data flows, and trust boundaries" },
462
+ { "title": "STRIDE", "detail": "6 parallel STRIDE threat agents — one per threat category" },
463
+ { "title": "Mitigate", "detail": "Parallel mitigation agent per identified threat" },
464
+ { "title": "Score", "detail": "CVSS-style risk score matrix with remediation priority" }
465
+ ]
170
466
  }
171
467
  ]