mindforge-cc 11.5.1 → 11.7.0

package/CHANGELOG.md

@@ -1,5 +1,76 @@
 # Changelog
 
+## [11.7.0] - 2026-06-23 — Workflow Forge
+
+First Dynamic Workflow Library for MindForge. Adds 12 pre-built multi-agent workflow scripts that users trigger via `/mindforge:wf-*` commands. Each workflow uses Claude Code's `Workflow` tool primitives (`parallel()`, `pipeline()`, `phase()`, `agent()`) for true fan-out concurrent agent execution with structured synthesis. Architecture follows adversarially-verified best practices: three-tier progressive disclosure, one-workflow-per-domain, predefined (not open-ended) patterns.
+
+### Added
+
+- **Dynamic Workflow Library (`.mindforge/dynamic-workflows/`)** — 12 self-contained multi-agent workflow scripts:
+  - *Research tier:* `deep-research` (5× parallel searches → 3-vote adversarial verify → cited synthesis), `competitive-analysis` (5× parallel angles → SWOT → positioning), `tech-evaluation` (5× dimension agents → scored matrix → recommendation)
+  - *Dev tier:* `code-audit` (3× parallel auditors → adversarial verify → risk report), `feature-planner` (brief → PRD → architecture → user stories pipeline), `pr-review` (4× parallel reviewers → consensus verdict), `tdd-sprint` (Spec → Red → Green → Refactor loop), `refactor-plan` (debt scan → risk-sort → safe sequence → plan)
+  - *Ops tier:* `incident-response` (4× parallel investigation → mitigation → RCA → postmortem), `release-prep` (tests → changelog → version bump → PR → announcement)
+  - *Intelligence tier:* `onboard-codebase` (map → domain → architecture → guided tour), `perf-optimize` (profile → 4× parallel bottleneck hunt → fix plan → benchmarks)
+- **13 new slash commands** — `/mindforge:wf-catalog` (browseable index) + 12 `/mindforge:wf-<name>` workflow commands
+- **CLI workflow subcommand** — `node bin/mindforge-cli.js workflow list|info|run <name>` for discovery and metadata access
+- **Workflow registry** — `index.json` (machine-readable) + `REGISTRY.md` (human-readable catalog) with tier, description, phases, and command for each workflow
+- **`tests/workflow-registry.test.js`** — validates registry consistency, script meta exports, command mirror parity, and frontmatter schema for all workflow commands
+
+### Summary
+
+| Tier | Workflows | Commands |
+|------|-----------|----------|
+| Research | 3 | `wf-deep-research`, `wf-competitive-analysis`, `wf-tech-evaluation` |
+| Dev | 4 | `wf-code-audit`, `wf-feature-planner`, `wf-pr-review`, `wf-tdd-sprint`, `wf-refactor-plan` |
+| Ops | 2 | `wf-incident-response`, `wf-release-prep` |
+| Intelligence | 2 | `wf-onboard-codebase`, `wf-perf-optimize` |
+| **Total** | **12** | **13 (including wf-catalog)** |
+
+---
+
+## [11.6.0] - 2026-06-17 — Skill Forge
+
+Largest single skill expansion in MindForge's history. Adds 80 community-sourced skills across 8 engineering domains with zero external attribution in any committed file. 30 skills are promoted to the engine tier for automatic trigger-matching; 50 live in the extended tier for explicit activation. Three new slash commands complete the discovery surface.
+
+### Added
+
+- **Engine-tier skills (auto-trigger, `.mindforge/skills/`)** — 30 new skills activated automatically when task description matches trigger phrases:
+  - *Software development:* `systematic-debugging` (4-phase root-cause methodology), `test-driven-development` (RED-GREEN-REFACTOR), `plan` (implementation planning), `simplify-code`, `requesting-code-review`, `spike`, `subagent-driven-development`, `code-wiki`
+  - *DevOps & orchestration:* `kanban-orchestrator`, `kanban-worker` (multi-agent task routing)
+  - *GitHub workflows:* `github-code-review`, `github-pr-workflow`, `github-issues`, `codebase-inspection`
+  - *Research & intelligence:* `research-paper-writing`, `arxiv`, `osint-investigation`, `domain-intel`, `duckduckgo-search`, `scrapling`, `blogwatcher`
+  - *Creative:* `concept-diagrams` (SVG educational visuals), `creative-ideation`, `pixel-art`, `meme-generation`
+  - *Security:* `web-pentest` (authorized penetration testing), `oss-forensics`, `sherlock`
+  - *Data-science & note-taking:* `jupyter-live-kernel`, `obsidian`
+
+- **Extended-tier skills (explicit activation, `.agent/skills/`)** — 20 additional skills beyond the promoted 30:
+  - *Software development:* `node-inspect-debugger`, `python-debugpy`, `skill-authoring`, `rest-graphql-debug`
+  - *GitHub:* `github-auth`, `github-repo-management`
+  - *DevOps:* `docker-management`, `devops-cli`, `devops-watchers`, `pinggy-tunnel`, `s6-container-supervision`
+  - *Research:* `llm-wiki`, `polymarket`, `parallel-cli`
+  - *Security:* `godmode`, `1password-skill`
+  - *Creative:* `hyperframes`, `article-illustrator`, `comic-creator`, `video-orchestrator`
+
+- **3 new slash commands:**
+  - `/mindforge:systematic-debug` — 4-phase root-cause debugging (no fixes without RCA)
+  - `/mindforge:skill-tdd` — strict RED-GREEN-REFACTOR TDD enforcement
+  - `/mindforge:skills-index` — browseable catalog of all 153 skills grouped by category
+
+### Changed
+
+- `tests/install.test.js` — added `hermes-agent` to secret-scanner skip list (gitignored donor directory)
+- `CLAUDE.md` — new **Extended Skill Library** section documents both skill tiers, trigger mechanics, and bulk import pattern
+
+### Skill counts
+
+| Tier | Before | After |
+|---|---|---|
+| Engine tier (`.mindforge/skills/`) | 202 | 232 |
+| Extended tier (`.agent/skills/`) | 73 | 123 |
+| Slash commands | 174 | 177 |
+
+---
+
 ## [11.5.1] - 2026-06-11 — Robustness + governance-gate patch (Wave 8)
 
 A fast-follow patch from a fresh adversarial audit of the shipped v11.5.0 tree.

package/MINDFORGE.md

@@ -3,10 +3,10 @@
 ## 1. IDENTITY & VERSIONING
 
 [NAME]    = MindForge
-[VERSION] = 11.5.1
+[VERSION] = 11.7.0
 [STABLE]  = true
 [MODE]    = "Platform Sovereign"
-[REQUIRED_CORE_VERSION] = 11.5.1
+[REQUIRED_CORE_VERSION] = 11.7.0
 [SOVEREIGN_IDENTITY] = true
 [SRE_LAYER_ENABLED]  = true
 

package/README.md

@@ -4,9 +4,11 @@
 
 ---
 
-## Latest: v11.3.1
+## Latest: v11.7.0
 
-- **v11.3.1 — Packaging hotfix.** Restores the full published payload: every `npx mindforge-cc` install now delivers all 174 slash commands, 73 skills, 154 subagents, and the complete `.mindforge/` framework. (v11.3.0 shipped a too-narrow npm allowlist that silently dropped commands and skills — fixed here, with a tarball regression test so it cannot recur.)
+- **v11.7.0 — "Workflow Forge".** Ships the first Dynamic Workflow Library — 12 pre-built multi-agent workflow scripts that run via Claude Code's `Workflow` tool with true parallel agent execution. Four tiers: Research (deep-research, competitive-analysis, tech-evaluation), Dev (code-audit, feature-planner, pr-review, tdd-sprint, refactor-plan), Ops (incident-response, release-prep), Intelligence (onboard-codebase, perf-optimize). 13 new `/mindforge:wf-*` commands. Total: 198 commands.
+- **v11.6.0 — "Skill Forge".** Adds 80 community-sourced skills across 8 domains (software-development, github, devops, research, security, creative, data-science, note-taking) — 30 promoted to engine tier for automatic trigger-matching, 50 in the extended tier for explicit activation. Three new slash commands: `/mindforge:systematic-debug`, `/mindforge:skill-tdd`, `/mindforge:skills-index`. Total: 153 skills, 232 engine-tier entries, 185 commands.
+- **v11.5.1 — Standalone MCP server.** The MindForge MCP server now ships as its own npm package, `mindforge-mcp-server@11.5.1`, listed on the official MCP Registry as `io.github.sairam0424/mindforge`. Add it to Claude Code with one command (see [Use the MCP server](#-use-the-mcp-server-standalone)); it exposes 7 tools over stdio (6 read-only + 1 guarded write).
 - **v11.3.0 — "Legion".** Imports 154 specialized Claude-Code-native subagents across 10 categories into `.claude/agents/`, fully rebranded and collision-safe. Additive and backward-compatible.
 
 See [CHANGELOG.md](./CHANGELOG.md) for full release history.
@@ -22,7 +24,7 @@ MindForge v11.0.0 "Sovereign Stability" is a production-hardening release focuse
 - **Production observability** — `/api/v1/system` health endpoint, P95 latency tracking, heap health monitoring, and real EIS client with retry logic.
 - **Graduated intelligence** — Adaptive tier escalation (+1/+2/MAX) with cost-awareness, 3-tier stuck detection, and adaptive context windows.
 
-This release ships 211 personas, 73 skills, 154 specialized subagents, 174 commands, 18 pillars, and 49 swarm templates across 12 engineering domains.
+This release ships 211 personas, 153 skills, 154 specialized subagents, 198 commands, 18 pillars, and 49 swarm templates across 12 engineering domains.
 
 
 ## Installation & Setup
@@ -74,6 +76,29 @@ npx mindforge-cc@latest --claude --local
 npx mindforge-cc@latest --antigravity --local
 ```
 
+### 🔗 Use the MCP server (standalone)
+
+The MindForge MCP server is published as its own npm package,
+**`mindforge-mcp-server`** (`11.5.1`), and is listed on the official
+[MCP Registry](https://registry.modelcontextprotocol.io) as
+`io.github.sairam0424/mindforge`. Wire it into Claude Code with one command:
+
+```bash
+claude mcp add mindforge -- npx -y mindforge-mcp-server
+```
+
+It exposes **7 tools over stdio** — 6 read-only plus 1 guarded write:
+
+| Tool | Purpose |
+| :--- | :--- |
+| `mindforge_health` | Framework health check |
+| `mindforge_status` | Project status snapshot |
+| `mindforge_memory_query` | Query the knowledge graph |
+| `mindforge_memory_stats` | Knowledge graph statistics |
+| `mindforge_memory_find_related` | Find related knowledge entries |
+| `mindforge_audit_log` | Read the append-only audit trail |
+| `mindforge_memory_remember` | Persist a memory (guarded write) |
+
 ---
 
 - **Production Hardening (v11.0.0)** — LRU caches, atomic JSON writes, log rotation, HANDOFF validation, and temporal snapshot GC for crash-safe long-running sessions.
@@ -355,8 +380,51 @@ See `.mindforge/production/token-optimiser.md`.
 - **Architecture:** `docs/architecture/README.md`
 - **Contributing:** `docs/contributing/CONTRIBUTING.md`
 
+## 🚀 Dynamic Workflow Library
+
+12 pre-built multi-agent workflow scripts that run via Claude Code's `Workflow` tool. Each workflow fans out concurrent agents, synthesizes results, and returns structured output.
+
+**Discover:** `/mindforge:wf-catalog` or `node bin/mindforge-cli.js workflow list`
+
+| Tier | Command | What it does |
+|------|---------|-------------|
+| Research | `/mindforge:wf-deep-research` | Fan-out web research → adversarial verify → cited report |
+| Research | `/mindforge:wf-competitive-analysis` | 5× parallel angles → SWOT → positioning |
+| Research | `/mindforge:wf-tech-evaluation` | 5× dimensions → scored matrix → recommendation |
+| Dev | `/mindforge:wf-code-audit` | 3× parallel auditors → verified findings → risk report |
+| Dev | `/mindforge:wf-feature-planner` | Brief → PRD → architecture → user stories |
+| Dev | `/mindforge:wf-pr-review` | 4× parallel reviewers → consensus verdict |
+| Dev | `/mindforge:wf-tdd-sprint` | Spec → RED → GREEN → REFACTOR loop |
+| Dev | `/mindforge:wf-refactor-plan` | Debt scan → risk-sort → safe sequence → plan |
+| Ops | `/mindforge:wf-incident-response` | 4× parallel investigation → mitigate → RCA → postmortem |
+| Ops | `/mindforge:wf-release-prep` | Tests → changelog → version bump → PR → announcement |
+| Intelligence | `/mindforge:wf-onboard-codebase` | Map → domain → architecture → guided tour |
+| Intelligence | `/mindforge:wf-perf-optimize` | Profile → 4× bottleneck hunt → prioritized fix plan |
+
+---
+
 ## 📜 Framework Evolution & Version History
 
+<details>
+<summary><b>v11.7.0 — Workflow Forge (Dynamic Workflow Library)</b></summary>
+
+- **12 dynamic workflow scripts** in `.mindforge/dynamic-workflows/scripts/` — each runs via Claude Code's `Workflow` tool with true parallel agent execution, structured JSON schemas, and adversarial verification where appropriate.
+- **4 tiers:** Research (fan-out search + verify + synthesis), Dev (code-audit, feature-planner, pr-review, tdd-sprint, refactor-plan), Ops (incident-response, release-prep), Intelligence (onboard-codebase, perf-optimize).
+- **13 new commands:** `/mindforge:wf-catalog` discovery index + 12 workflow-specific commands.
+- **CLI discovery:** `node bin/mindforge-cli.js workflow list|info|run <name>`.
+- Architecture follows adversarially-verified best practices: one-workflow-per-domain, predefined (not open-ended) pipelines, fan-out + gated synthesis pattern.
+</details>
+
+<details>
+<summary><b>v11.6.0 — Skill Forge (Core + Dev Skill Pack)</b></summary>
+
+- **80 new skills** across 8 domains: software-development, GitHub workflows, DevOps orchestration, research intelligence, security, creative tooling, data-science, and note-taking.
+- **Engine tier (auto-trigger):** 30 skills in `.mindforge/skills/` activated automatically by trigger-phrase matching — systematic debugging, TDD, kanban orchestration, OSINT investigation, web pentesting, concept diagram generation, research paper writing, and more.
+- **Extended tier (explicit):** 50 skills in `.agent/skills/` covering GitHub auth, docker management, DevOps watchers, 1Password, debuggers, pixel art, video orchestration, and more.
+- **3 new slash commands:** `/mindforge:systematic-debug` (4-phase RCA), `/mindforge:skill-tdd` (RED-GREEN-REFACTOR), `/mindforge:skills-index` (browseable skill catalog).
+- All skills cleanly integrated — zero external attribution in any committed file.
+</details>
+
 <details>
 <summary><b>v11.0.0 — Sovereign Stability (Production Hardening)</b></summary>
 
@@ -501,3 +569,4 @@ MindForge never stores credentials in files. Review:
 
 ## ⚖️ License
 MIT © 2026 MindForge Team
+eam

package/RELEASENOTES.md

@@ -1,5 +1,114 @@
 # Release Notes
 
+## v11.7.0 — Workflow Forge
+
+**Release Date**: 2026-06-23
+**Type**: Minor — new dynamic workflow library, no breaking changes
+**Upgrade Path**: `npx mindforge-cc@latest`
+
+---
+
+The first Dynamic Workflow Library for MindForge. Twelve pre-built multi-agent workflow scripts ship in the npm package and are immediately available to any user who installs MindForge. Each workflow runs via Claude Code's native `Workflow` tool for true parallel agent execution.
+
+### Dynamic Workflow Library
+
+12 workflows across 4 tiers, each backed by a full JS orchestration script in `.mindforge/dynamic-workflows/scripts/`:
+
+**Research tier** — fan-out parallel searches, adversarial claim verification, cited synthesis:
+- `deep-research` — Decompose → 5× parallel web search → fetch 15 sources → 3-vote verify → synthesize cited report
+- `competitive-analysis` — 5× angles (product/pricing/reviews/community/roadmap) → SWOT → positioning
+- `tech-evaluation` — 5× dimensions (DX/perf/security/ecosystem/community) → scored matrix → recommendation
+
+**Dev tier** — coding-assistant power workflows:
+- `code-audit` — 3× parallel auditors (security/quality/perf) → adversarial verify high-severity findings → risk report
+- `feature-planner` — Brief → PRD → Architecture → User stories (sequential pipeline)
+- `pr-review` — 4× parallel reviewers (correctness/security/perf/style) → consensus verdict
+- `tdd-sprint` — Spec → RED (failing test) → GREEN (minimal impl) → REFACTOR (clean up) loop
+- `refactor-plan` — Debt scan → risk-sort → sequence → safe implementation plan
+
+**Ops tier**:
+- `incident-response` — 4× parallel investigation (logs/metrics/traces/code) → mitigate → RCA → postmortem
+- `release-prep` — Tests → changelog → semver bump → PR body → announcement draft
+
+**Intelligence tier**:
+- `onboard-codebase` — Map → domain analysis → architecture → guided tour + onboarding docs
+- `perf-optimize` — Profile → 4× parallel bottleneck hunt (DB/network/CPU/memory) → prioritized fix plan → benchmarks
+
+### 13 new commands
+
+`/mindforge:wf-catalog` — browseable index of all 12 workflows grouped by tier
+`/mindforge:wf-<name>` — one command per workflow, each with usage and phase descriptions
+
+### CLI discovery
+
+```bash
+node bin/mindforge-cli.js workflow list          # print catalog
+node bin/mindforge-cli.js workflow info <name>   # show phases and description
+```
+
+### Upgrade steps
+
+1. `npx mindforge-cc@latest` — all 12 workflows and 13 commands install automatically
+2. Run `/mindforge:wf-catalog` to browse the library
+3. Try `/mindforge:wf-deep-research <your question>` for a first run
+
+---
+
+## v11.6.0 — Skill Forge
+
+**Release Date**: 2026-06-17
+**Type**: Minor — additive skill pack expansion, no breaking changes
+**Upgrade Path**: `npx mindforge-cc@latest`
+
+---
+
+Largest single skill expansion in MindForge history. 80 new skills across 8 engineering domains — software development, GitHub workflows, DevOps orchestration, research intelligence, security, creative tooling, data-science, and note-taking. Zero breaking changes; fully backward-compatible.
+
+### Engine-tier skills (auto-trigger)
+
+30 skills in `.mindforge/skills/` now activate automatically when your task description matches their trigger phrases — no explicit invocation needed:
+
+- **Systematic debugging** — 4-phase root-cause methodology. The iron rule: no fix without a root cause investigation first.
+- **Test-driven development** — RED-GREEN-REFACTOR enforcement. Write the failing test first, always.
+- **Plan mode** — implementation planning before coding. Saves the plan to a markdown file.
+- **Kanban orchestration** — `kanban-orchestrator` decomposes work and routes to specialist agents; `kanban-worker` executes individual cards.
+- **GitHub workflows** — PR review, PR lifecycle, issue management, codebase inspection.
+- **OSINT investigation** — public-records cross-reference across SEC, OFAC, OpenCorporates, court records, Wayback Machine.
+- **Web pentesting** — authorized web application penetration testing with hard scope guardrails.
+- **Concept diagrams** — flat, minimal SVG educational diagrams with automatic dark mode.
+- **Research paper writing** — academic paper authoring with citation workflow and reviewer guidelines.
+- And 21 more across research, creative, security, data-science, and note-taking domains.
+
+### Extended-tier skills (explicit activation)
+
+50 skills in `.agent/skills/` for on-demand use: GitHub auth, docker management, DevOps watchers, 1Password CLI integration, debuggers (Node inspect, Python debugpy), creative tools (pixel art, video orchestration, comic creation), research tools (LLM wiki, polymarket, parallel CLI), and more.
+
+### New slash commands
+
+| Command | Purpose |
+|---|---|
+| `/mindforge:systematic-debug` | 4-phase root-cause debugging session |
+| `/mindforge:skill-tdd` | Strict TDD RED-GREEN-REFACTOR cycle |
+| `/mindforge:skills-index` | Browse all 153 skills by category |
+
+### Skill counts
+
+| Tier | Before | After |
+|---|---|---|
+| Engine tier (`.mindforge/skills/`) | 202 | 232 |
+| Extended tier (`.agent/skills/`) | 73 | 123 |
+| Slash commands | 174 | 177 |
+
+### Upgrade
+
+```bash
+npx mindforge-cc@latest --claude --global
+```
+
+No migration steps required. All new skills are additive.
+
+---
+
 ## v11.5.1 — Robustness + governance-gate patch
 
 **Release Date**: 2026-06-11

package/bin/installer-core.js

@@ -527,9 +527,13 @@ async function install(runtime, scope, options = {}) {
   ];
 
   if (runtime === 'claude') {
-    // Claude Code specifically looks in .claude/commands/mindforge
+    // Claude Code looks in .claude/commands/mindforge. Use .agent/mindforge as the
+    // canonical source — it is always committed, while .claude/ is gitignored. The
+    // previous behaviour of reading from .claude/commands/mindforge/ (itself gitignored)
+    // left CI with an empty command set on a fresh checkout.
     cmdSources.length = 0;
-    cmdSources.push({ src: src('.claude', 'commands', 'mindforge'), namespace: 'mindforge' });
+    cmdSources.push({ src: src('.agent', 'mindforge'), namespace: 'mindforge' });
+    cmdSources.push({ src: src('.agent', 'forge'),     namespace: 'forge' });
   }
 
   let totalCount = 0;

package/bin/mindforge-cli.js

@@ -140,6 +140,13 @@ const COMMANDS = {
   }
 };
 
+// ── Workflow subcommand (non-script, handled inline) ─────────────────────────
+if (COMMAND === 'workflow') {
+  const workflowRunner = require('./workflows/workflow-runner');
+  workflowRunner.run(COMMAND_ARGS[0], COMMAND_ARGS.slice(1));
+  process.exit(0);
+}
+
 if (!COMMAND || ARGS.includes('--help') || ARGS.includes('-h')) {
   printUsage();
   process.exit(0);

package/bin/workflows/workflow-runner.js

@@ -0,0 +1,110 @@
+'use strict';
+
+const fs = require('fs');
+const path = require('path');
+
+const ROOT = path.resolve(__dirname, '..', '..');
+const REGISTRY_PATH = path.join(ROOT, '.mindforge', 'dynamic-workflows', 'index.json');
+
+function loadRegistry() {
+  if (!fs.existsSync(REGISTRY_PATH)) {
+    console.error('Workflow registry not found. Run `npx mindforge-cc@latest` to reinstall.');
+    process.exit(1);
+  }
+  return JSON.parse(fs.readFileSync(REGISTRY_PATH, 'utf8'));
+}
+
+function cmdList() {
+  const workflows = loadRegistry();
+  const tiers = ['research', 'dev', 'ops', 'intelligence'];
+  const byTier = {};
+  for (const wf of workflows) {
+    (byTier[wf.tier] = byTier[wf.tier] || []).push(wf);
+  }
+
+  console.log('\nMindForge Dynamic Workflow Library\n');
+  for (const tier of tiers) {
+    if (!byTier[tier]) continue;
+    console.log(`  ${tier.toUpperCase()} TIER`);
+    for (const wf of byTier[tier]) {
+      console.log(`    ${wf.command.padEnd(40)} ${wf.description}`);
+    }
+    console.log('');
+  }
+  console.log(`  Total: ${workflows.length} workflows`);
+  console.log('  Run `node bin/mindforge-cli.js workflow info <name>` for details.\n');
+}
+
+function cmdInfo(name) {
+  if (!name) {
+    console.error('Usage: workflow info <name>');
+    process.exit(1);
+  }
+  const workflows = loadRegistry();
+  const wf = workflows.find(w => w.name === name);
+  if (!wf) {
+    console.error(`Workflow not found: ${name}`);
+    console.error(`Available: ${workflows.map(w => w.name).join(', ')}`);
+    process.exit(1);
+  }
+
+  console.log(`\n${wf.name}`);
+  console.log(`  Command:    ${wf.command}`);
+  console.log(`  Tier:       ${wf.tier}`);
+  console.log(`  Description: ${wf.description}`);
+  console.log(`  When to use: ${wf.whenToUse}`);
+  console.log(`  Script:     ${wf.scriptPath}`);
+  console.log('  Phases:');
+  for (const p of wf.phases) {
+    console.log(`    ${p.title.padEnd(16)} ${p.detail}`);
+  }
+  console.log('');
+}
+
+function cmdRun(name, args) {
+  if (!name) {
+    console.error('Usage: workflow run <name> [args...]');
+    process.exit(1);
+  }
+  const workflows = loadRegistry();
+  const wf = workflows.find(w => w.name === name);
+  if (!wf) {
+    console.error(`Workflow not found: ${name}`);
+    process.exit(1);
+  }
+
+  const scriptPath = path.join(ROOT, wf.scriptPath);
+  if (!fs.existsSync(scriptPath)) {
+    console.error(`Workflow script not found: ${scriptPath}`);
+    process.exit(1);
+  }
+
+  const argsStr = args.join(' ');
+  console.log(`\nTo run the "${name}" workflow in Claude Code:`);
+  console.log('\nInvoke via the Workflow tool with:');
+  console.log(`  scriptPath: "${wf.scriptPath}"`);
+  console.log(`  args: "${argsStr}"`);
+  console.log(`\nOr use the command: ${wf.command} ${argsStr}`);
+  console.log('\nThe Workflow tool runs in Claude Code\'s native multi-agent environment.');
+  console.log('Phases: ' + wf.phases.map(p => p.title).join(' -> ') + '\n');
+}
+
+function run(subcommand, args) {
+  switch (subcommand) {
+  case 'list':
+    cmdList();
+    break;
+  case 'info':
+    cmdInfo(args[0]);
+    break;
+  case 'run':
+    cmdRun(args[0], args.slice(1));
+    break;
+  default:
+    console.error(`Unknown workflow subcommand: ${subcommand || '(none)'}`);
+    console.error('Usage: workflow <list|info|run> [args]');
+    process.exit(1);
+  }
+}
+
+module.exports = { run };

package/docs/commands-reference.md

@@ -194,4 +194,29 @@ mindforge <command> [options]
 | `tokens` | Analyze token consumption and cost efficiency |
 | `learning` | Consult or initialize the project agentic learning memory |
 | `record-learning` | Append a new Learning Entry to the Evolution Log |
+| `workflow list` | List all available dynamic workflows with descriptions |
+| `workflow info <name>` | Show phases and metadata for a specific workflow |
+| `workflow run <name> [args]` | Display invocation instructions for a workflow |
+
+---
+
+## 🚀 Dynamic Workflow Library
+
+Pre-built multi-agent workflow scripts triggered via `/mindforge:wf-*` commands. Each runs via Claude Code's `Workflow` tool with true parallel agent execution.
+
+| Command | Tier | Description |
+| :--- | :--- | :--- |
+| `/mindforge:wf-catalog` | — | Browse all 12 workflows grouped by tier |
+| `/mindforge:wf-deep-research` | research | Fan-out web research → adversarial verify → cited report |
+| `/mindforge:wf-competitive-analysis` | research | 5× parallel angles → SWOT → positioning |
+| `/mindforge:wf-tech-evaluation` | research | 5× dimensions → scored matrix → recommendation |
+| `/mindforge:wf-code-audit` | dev | 3× parallel auditors → verified findings → risk report |
+| `/mindforge:wf-feature-planner` | dev | Brief → PRD → architecture → user stories pipeline |
+| `/mindforge:wf-pr-review` | dev | 4× parallel reviewers → consensus verdict |
+| `/mindforge:wf-tdd-sprint` | dev | Spec → RED → GREEN → REFACTOR loop |
+| `/mindforge:wf-refactor-plan` | dev | Debt scan → risk-sort → safe sequence → plan |
+| `/mindforge:wf-incident-response` | ops | 4× parallel investigation → mitigate → RCA → postmortem |
+| `/mindforge:wf-release-prep` | ops | Tests → changelog → version bump → PR → announcement |
+| `/mindforge:wf-onboard-codebase` | intelligence | Map → domain → architecture → guided tour |
+| `/mindforge:wf-perf-optimize` | intelligence | Profile → 4× bottleneck hunt → prioritized fix plan |
 

package/docs/getting-started.md

@@ -1,4 +1,4 @@
-# MindForge — Getting Started (v11.3.1)
+# MindForge — Getting Started (v11.5.1)
 
 This guide gets you from zero to a working MindForge project in under five minutes.
 
@@ -9,21 +9,58 @@ This guide gets you from zero to a working MindForge project in under five minut
 
 ## Install
 
-MindForge is installed via `npx` for zero-config setup:
+MindForge ships across several channels. Pick the one that matches how you work — the CLI installer is the recommended starting point.
+
+### 1. CLI installer (recommended, via `npx`)
+
+Zero-config setup that scaffolds the full framework:
 
 ```bash
 # Recommended (auto-detects your runtime)
-npx mindforge-cc
+npx mindforge-cc@latest
 
 # Antigravity (local development)
-npx mindforge-cc --antigravity --local
+npx mindforge-cc@latest --antigravity --local
 
 # Claude Code (local, per project)
-npx mindforge-cc --claude --local
+npx mindforge-cc@latest --claude --local
 ```
 
 After installation, the `mindforge` CLI command is available for runtime operations (health checks, security scans, headless execution, etc.).
 
+### 2. Claude Code plugin (self-hosted marketplace)
+
+Install MindForge as a Claude Code plugin from its marketplace:
+
+```bash
+/plugin marketplace add sairam0424/MindForge
+/plugin install mindforge@mindforge
+```
+
+### 3. Standalone MCP server
+
+Run the MindForge MCP server (`mindforge-mcp-server`) over stdio — it exposes 7 tools (6 read-only plus 1 guarded write): `mindforge_health`, `mindforge_status`, `mindforge_memory_query`, `mindforge_memory_stats`, `mindforge_memory_find_related`, `mindforge_audit_log`, and `mindforge_memory_remember`.
+
+```bash
+claude mcp add mindforge -- npx -y mindforge-mcp-server
+```
+
+This server is also published to the [MCP Registry](https://registry.modelcontextprotocol.io) as `io.github.sairam0424/mindforge` (currently `11.5.1`, marked latest).
+
+### 4. Homebrew
+
+```bash
+brew install sairam0424/tap/mindforge
+```
+
+### SDK
+
+To build on top of MindForge programmatically, install the TypeScript SDK:
+
+```bash
+npm i mindforge-sdk
+```
+
 ## Initialise Your Project
 
 Open your agentic runtime (Antigravity or Claude Code) in your repository and run:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindforge-cc",
-  "version": "11.5.1",
+  "version": "11.7.0",
   "description": "MindForge \u2014 Sovereign Agentic Intelligence Framework. Sovereign Stability: Production-Hardened Agentic Intelligence (v11)",
   "bin": {
     "mindforge-cc": "bin/install.js",
@@ -23,6 +23,7 @@
     ".mindforge/schemas/",
     ".mindforge/personas/",
     ".mindforge/skills/",
+    ".mindforge/dynamic-workflows/",
     ".mindforge/governance/",
     ".mindforge/integrations/",
     ".mindforge/intelligence/",