mindforge-cc 11.5.1 → 11.7.0

package/.agent/mindforge/skill-tdd.md

@@ -0,0 +1,53 @@
+---
+description: "Test-Driven Development — RED-GREEN-REFACTOR discipline. Write the failing test first, always."
+---
+
+# MindForge — TDD Skill Command
+# Usage: /mindforge:skill-tdd [feature or bug to implement]
+
+Activates the test-driven development skill. The core rule: **if you didn't watch the test fail, you don't know if it tests the right thing.**
+
+## Activation
+
+Load `.mindforge/skills/test-driven-development/SKILL.md` immediately.
+Follow its RED-GREEN-REFACTOR cycle strictly for the full duration of this session.
+
+## The Cycle (non-negotiable)
+
+### RED — Write a failing test
+1. Identify the smallest next behavior to implement.
+2. Write one test that asserts that behavior.
+3. Run it — confirm it FAILS for the right reason (not a syntax error, not a missing import — the actual assertion fails).
+4. Do not proceed until the test fails correctly.
+
+### GREEN — Write minimal code to pass
+1. Write the simplest code that makes the test pass.
+2. No gold-plating, no extra features. Minimum viable.
+3. Run the test — it must pass.
+4. Run the full suite — no regressions.
+
+### REFACTOR — Clean up
+1. Improve code structure, naming, and clarity.
+2. Remove duplication.
+3. Tests stay green throughout — run after every change.
+
+## Mandatory gates
+
+- **Never write code without a failing test.** Not for "obvious" cases, not for "quick" fixes, not for "trivial" implementations.
+- **One cycle at a time.** Complete RED-GREEN-REFACTOR before starting the next behavior.
+- **A passing test suite is always the starting state.** If tests are red when you begin, fix them first.
+
+## When the user asks for a feature
+
+1. Decompose into the smallest testable behavior.
+2. Start with the first RED step before writing any implementation.
+3. Repeat the cycle for each behavior.
+
+## When the user asks for a bug fix
+
+1. Write a failing test that reproduces the bug (this is your RED step).
+2. Confirm it fails.
+3. Fix the code (GREEN).
+4. Refactor if needed.
+
+The bug test becomes the regression guard — it must remain in the suite permanently.

package/.agent/mindforge/skills-index.md

@@ -0,0 +1,118 @@
+---
+description: "Browse all available skills by category — discover and activate any skill by name."
+---
+
+# MindForge — Skills Index
+# Usage: /mindforge:skills-index [optional: category or keyword filter]
+
+Lists all skills available in this MindForge installation. Skills in the **Engine** tier activate automatically via trigger-matching. Skills in the **Extended** tier require explicit invocation.
+
+---
+
+## How to activate a skill
+
+**Engine tier** (auto-triggers from `.mindforge/skills/`): Just describe the task — the skill-loader matches your request against each skill's `triggers:` field and loads the relevant skill automatically.
+
+**Extended tier** (explicit from `.agent/skills/`): Ask Claude to "use the [skill-name] skill" or invoke it by name.
+
+---
+
+## Engine Tier Skills (auto-triggered)
+
+### Software Development
+| Skill | Triggers |
+|---|---|
+| `systematic-debugging` | systematic debugging, root cause analysis, debug methodology, 4-phase debug |
+| `test-driven-development` | TDD, red green refactor, write test first, test before code |
+| `plan` | write a plan, plan mode, implementation plan, plan before coding |
+| `simplify-code` | simplify code, clean up code, refactor for clarity, reduce complexity |
+| `requesting-code-review` | request code review, code review protocol, review this PR |
+| `spike` | technical spike, time-boxed spike, explore this problem |
+| `subagent-driven-development` | subagent driven development, delegate to subagent, multi-agent implementation |
+| `code-wiki` | code wiki, document codebase, knowledge wiki, explain codebase |
+
+### DevOps & Orchestration
+| Skill | Triggers |
+|---|---|
+| `kanban-orchestrator` | kanban orchestrator, multi-agent kanban, decompose and route, orchestrate tasks |
+| `kanban-worker` | kanban worker, pick up kanban task, complete kanban card |
+
+### GitHub Workflows
+| Skill | Triggers |
+|---|---|
+| `github-code-review` | github code review, review PR, pull request review workflow |
+| `github-pr-workflow` | github pr workflow, pull request lifecycle, open PR, merge PR |
+| `github-issues` | github issues, create issue, manage issues, issue triage |
+| `codebase-inspection` | codebase inspection, explore codebase, understand repository |
+
+### Research & Intelligence
+| Skill | Triggers |
+|---|---|
+| `research-paper-writing` | research paper, academic paper, write paper, arxiv paper |
+| `arxiv` | arxiv search, find papers, search arxiv, academic literature |
+| `osint-investigation` | OSINT investigation, public records research, entity investigation |
+| `domain-intel` | domain intelligence, investigate domain, domain research |
+| `duckduckgo-search` | duckduckgo search, DDG search, web search |
+| `scrapling` | scrape website, web scraping, extract web content |
+| `blogwatcher` | monitor blog, watch blog, track blog updates |
+
+### Creative
+| Skill | Triggers |
+|---|---|
+| `concept-diagrams` | concept diagram, educational diagram, SVG diagram, visual explanation |
+| `creative-ideation` | creative ideation, brainstorm ideas, creative ideas, generate concepts |
+| `pixel-art` | pixel art, create pixel art, sprite design |
+| `meme-generation` | meme generation, create meme, generate meme |
+
+### Security
+| Skill | Triggers |
+|---|---|
+| `web-pentest` | web penetration test, pentest this app, security test web app, OWASP test |
+| `oss-forensics` | OSS forensics, open source forensics, supply chain audit |
+| `sherlock` | sherlock, username investigation, find accounts, OSINT username |
+
+### Data & Tooling
+| Skill | Triggers |
+|---|---|
+| `jupyter-live-kernel` | jupyter kernel, live jupyter, interactive notebook |
+| `obsidian` | obsidian notes, obsidian vault, obsidian workflow |
+
+---
+
+## Extended Tier Skills (`.agent/skills/`, explicit activation)
+
+### 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`
+
+---
+
+## Usage examples
+
+```
+"Debug this null pointer — use systematic debugging"
+→ Engine tier: systematic-debugging activates automatically
+
+"I want to do TDD on this new auth module"
+→ Engine tier: test-driven-development activates automatically
+
+"Use the docker-management skill to set up my containers"
+→ Extended tier: explicit invocation of docker-management
+
+"Run an OSINT investigation on this company"
+→ Engine tier: osint-investigation activates automatically
+```

package/.agent/mindforge/systematic-debug.md

@@ -0,0 +1,60 @@
+---
+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/.agent/mindforge/wf-catalog.md

@@ -0,0 +1,37 @@
+---
+description: "Browse the MindForge dynamic workflow library — 12 pre-built multi-agent workflows"
+---
+# /mindforge:wf-catalog
+
+Browse and discover the MindForge **Dynamic Workflow Library** — 12 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-deep-research` — Multi-source fact-checked research report
+- `/mindforge:wf-competitive-analysis` — SWOT and positioning summary
+- `/mindforge:wf-tech-evaluation` — Scored technology comparison matrix
+
+**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
+
+**Ops** — Infrastructure and release workflows
+- `/mindforge:wf-incident-response` — Parallel investigation → RCA → postmortem
+- `/mindforge:wf-release-prep` — Tests → changelog → version bump → PR
+
+**Intelligence** — Deep analysis and optimization
+- `/mindforge:wf-onboard-codebase` — Map → domain → architecture → guided tour
+- `/mindforge:wf-perf-optimize` — Profile → bottleneck hunt → prioritized fix plan
+
+## CLI Discovery
+```bash
+node bin/mindforge-cli.js workflow list
+node bin/mindforge-cli.js workflow info <name>
+```

package/.agent/mindforge/wf-code-audit.md

@@ -0,0 +1,31 @@
+---
+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/.agent/mindforge/wf-competitive-analysis.md

@@ -0,0 +1,31 @@
+---
+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/.agent/mindforge/wf-deep-research.md

@@ -0,0 +1,32 @@
+---
+description: "Fan-out web research with adversarial claim verification and cited synthesis"
+---
+# /mindforge:wf-deep-research
+
+Runs the **Deep Research** dynamic workflow.
+
+## Usage
+`/mindforge:wf-deep-research <your research question>`
+
+## What it does
+- **Scope**: Decomposes your question into 5 independent search angles
+- **Search**: 5 parallel web search agents, one per angle (~30s)
+- **Fetch**: Deduplicates URLs, fetches top 15 sources, extracts falsifiable claims
+- **Verify**: 3-vote adversarial verification per claim — 2/3 refutes kills a claim
+- **Synthesize**: Merges confirmed findings, ranks by confidence, cites all sources
+
+## Running
+
+Invoke via Claude Code's Workflow tool:
+
+```
+Workflow({
+  scriptPath: ".mindforge/dynamic-workflows/scripts/deep-research.js",
+  args: "<your input>"
+})
+```
+
+Or discover via CLI:
+```bash
+node bin/mindforge-cli.js workflow info deep-research
+```

package/.agent/mindforge/wf-feature-planner.md

@@ -0,0 +1,31 @@
+---
+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/.agent/mindforge/wf-incident-response.md

@@ -0,0 +1,31 @@
+---
+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/.agent/mindforge/wf-onboard-codebase.md

@@ -0,0 +1,31 @@
+---
+description: "Map structure → domain analysis → architecture → generate guided tour and onboarding docs"
+---
+# /mindforge:wf-onboard-codebase
+
+Runs the **Onboard Codebase** dynamic workflow.
+
+## Usage
+`/mindforge:wf-onboard-codebase [repo path or description]`
+
+## What it does
+- **Map**: Discovers languages, frameworks, entry points, and key directory purposes
+- **Domain**: Identifies business domains, core abstractions, and the software's purpose
+- **Architecture**: Maps layers, data flow, key patterns, and developer gotchas
+- **Tour**: Generates a 5-10 step guided tour, conventions guide, and quick-start
+
+## Running
+
+Invoke via Claude Code's Workflow tool:
+
+```
+Workflow({
+  scriptPath: ".mindforge/dynamic-workflows/scripts/onboard-codebase.js",
+  args: "<your input>"
+})
+```
+
+Or discover via CLI:
+```bash
+node bin/mindforge-cli.js workflow info onboard-codebase
+```

package/.agent/mindforge/wf-perf-optimize.md

@@ -0,0 +1,31 @@
+---
+description: "Profile → parallel bottleneck hunt across DB/network/CPU/memory → prioritized fix plan"
+---
+# /mindforge:wf-perf-optimize
+
+Runs the **Perf Optimize** dynamic workflow.
+
+## Usage
+`/mindforge:wf-perf-optimize [application or path description]`
+
+## What it does
+- **Profile**: Establishes baseline, identifies slowest paths, forms bottleneck hypothesis
+- **Identify**: 4 parallel agents — DB queries, network, CPU/compute, memory
+- **Plan**: Prioritizes fixes by impact-to-effort ratio with implementation guidance
+- **Benchmark**: Defines before/after benchmark tests and success criteria for each fix
+
+## Running
+
+Invoke via Claude Code's Workflow tool:
+
+```
+Workflow({
+  scriptPath: ".mindforge/dynamic-workflows/scripts/perf-optimize.js",
+  args: "<your input>"
+})
+```
+
+Or discover via CLI:
+```bash
+node bin/mindforge-cli.js workflow info perf-optimize
+```

package/.agent/mindforge/wf-pr-review.md

@@ -0,0 +1,31 @@
+---
+description: "4-dimensional parallel PR review: correctness, security, performance, style → consensus verdict"
+---
+# /mindforge:wf-pr-review
+
+Runs the **Pr Review** dynamic workflow.
+
+## Usage
+`/mindforge:wf-pr-review [diff target or 'current HEAD~1']`
+
+## What it does
+- **Scope**: Reads the diff and gathers review context
+- **Review**: 4 parallel reviewers — correctness, security, performance, code style
+- **Consensus**: Merges all findings, deduplicates, assigns severity (blocking/major/minor)
+- **Verdict**: APPROVED / APPROVED_WITH_SUGGESTIONS / CHANGES_REQUIRED / BLOCKING
+
+## Running
+
+Invoke via Claude Code's Workflow tool:
+
+```
+Workflow({
+  scriptPath: ".mindforge/dynamic-workflows/scripts/pr-review.js",
+  args: "<your input>"
+})
+```
+
+Or discover via CLI:
+```bash
+node bin/mindforge-cli.js workflow info pr-review
+```

package/.agent/mindforge/wf-refactor-plan.md

@@ -0,0 +1,31 @@
+---
+description: "Technical debt scan → risk-sorted sequence → safe refactor implementation plan"
+---
+# /mindforge:wf-refactor-plan
+
+Runs the **Refactor Plan** dynamic workflow.
+
+## Usage
+`/mindforge:wf-refactor-plan [path or 'current codebase']`
+
+## What it does
+- **Scan**: 3 parallel scans — structural debt, complexity debt, maintenance debt
+- **Prioritize**: Risk-sorts items by blast radius × test coverage inverse
+- **Sequence**: Orders changes to minimize conflicts and risk
+- **Plan**: Step-by-step refactor plan with verification gates and rollback procedures
+
+## Running
+
+Invoke via Claude Code's Workflow tool:
+
+```
+Workflow({
+  scriptPath: ".mindforge/dynamic-workflows/scripts/refactor-plan.js",
+  args: "<your input>"
+})
+```
+
+Or discover via CLI:
+```bash
+node bin/mindforge-cli.js workflow info refactor-plan
+```

package/.agent/mindforge/wf-release-prep.md

@@ -0,0 +1,31 @@
+---
+description: "Automated release pipeline: tests → changelog → version bump → PR → announcement draft"
+---
+# /mindforge:wf-release-prep
+
+Runs the **Release Prep** dynamic workflow.
+
+## Usage
+`/mindforge:wf-release-prep [repo context]`
+
+## What it does
+- **Check**: Verifies readiness — no uncommitted changes, tests passing, no critical open bugs
+- **Changelog**: Generates changelog from conventional commits since last release
+- **Bump**: Determines next semver version based on breaking/feature/fix counts
+- **PR**: Drafts the release PR body, release notes, and social announcement
+
+## Running
+
+Invoke via Claude Code's Workflow tool:
+
+```
+Workflow({
+  scriptPath: ".mindforge/dynamic-workflows/scripts/release-prep.js",
+  args: "<your input>"
+})
+```
+
+Or discover via CLI:
+```bash
+node bin/mindforge-cli.js workflow info release-prep
+```

package/.agent/mindforge/wf-tdd-sprint.md

@@ -0,0 +1,31 @@
+---
+description: "Strict Red-Green-Refactor TDD loop with spec-first discipline"
+---
+# /mindforge:wf-tdd-sprint
+
+Runs the **Tdd Sprint** dynamic workflow.
+
+## Usage
+`/mindforge:wf-tdd-sprint <feature or behavior to implement>`
+
+## What it does
+- **Spec**: Writes a precise Given-When-Then behavioral spec with edge cases
+- **Red**: Writes a failing test that captures exactly the required behavior
+- **Green**: Writes the MINIMAL implementation to make the test pass
+- **Refactor**: Cleans up the passing implementation with specific improvements listed
+
+## Running
+
+Invoke via Claude Code's Workflow tool:
+
+```
+Workflow({
+  scriptPath: ".mindforge/dynamic-workflows/scripts/tdd-sprint.js",
+  args: "<your input>"
+})
+```
+
+Or discover via CLI:
+```bash
+node bin/mindforge-cli.js workflow info tdd-sprint
+```

package/.agent/mindforge/wf-tech-evaluation.md

@@ -0,0 +1,31 @@
+---
+description: "Scored technology evaluation across DX, performance, security, ecosystem, community"
+---
+# /mindforge:wf-tech-evaluation
+
+Runs the **Tech Evaluation** dynamic workflow.
+
+## Usage
+`/mindforge:wf-tech-evaluation <TechA vs TechB vs TechC for [use case]>`
+
+## What it does
+- **Scope**: Parses candidates and evaluation criteria from your input
+- **Evaluate**: 5 parallel dimension agents — DX, performance, security, ecosystem, community
+- **Score**: Builds a weighted 1-10 scoring matrix per dimension
+- **Recommend**: Produces ranked recommendation with trade-offs for each option
+
+## Running
+
+Invoke via Claude Code's Workflow tool:
+
+```
+Workflow({
+  scriptPath: ".mindforge/dynamic-workflows/scripts/tech-evaluation.js",
+  args: "<your input>"
+})
+```
+
+Or discover via CLI:
+```bash
+node bin/mindforge-cli.js workflow info tech-evaluation
+```