mindforge-cc 11.3.1 → 11.5.0

package/.agent/mindforge/orch-fix-defect.md

@@ -0,0 +1,43 @@
+---
+description: Orchestrate fixing a bug — reproduce it as a failing regression test, fix to green, review, gated commit. Thin wrapper over the orch-pipeline skill.
+---
+
+# MindForge — Orch: Fix Defect
+# Usage: /mindforge:orch-fix-defect <what is broken>
+
+Manually launch the **fix-defect** orchestration: prove the bug with a red test,
+then fix to green.
+
+## Usage
+
+```
+/mindforge:orch-fix-defect <what is broken>
+```
+
+Examples:
+
+```
+/mindforge:orch-fix-defect poller crashes on empty upstream response
+/mindforge:orch-fix-defect login returns 500 when email has a plus sign
+```
+
+## What It Does
+
+Activate the `orch-pipeline` skill (`.mindforge/skills/orch-pipeline/SKILL.md`)
+with `$ARGUMENTS` as the request and `operation = fix-defect`. The engine will:
+
+1. **Step 0 — size classifier**: classify size (default floor: **small**, often
+   **tiny**); scope root cause with `/mindforge:map-codebase` if unclear.
+2. **Write a new failing regression test** reproducing the bug, then fix until it
+   goes green via `mindforge-tdd_extended`. (Proving the bug first is what makes
+   this a fix, not a tweak.)
+3. `/mindforge:review` (+ the `quick.md` security auto-trigger / `security-reviewer`
+   if the defect sits in a sensitive path).
+4. Commit as a conventional `fix(...)` commit + Merkle-linked AUDIT.jsonl entry.
+   → **GATE 2** (confirm before commit).
+
+Use this only when behavior is **broken/wrong** — not for intentional changes
+(`/mindforge:orch-change-feature`) or new capability
+(`/mindforge:orch-add-feature`).
+
+If `$ARGUMENTS` is empty, ask the user to describe the defect.

package/.agent/mindforge/orch-refine-code.md

@@ -0,0 +1,43 @@
+---
+description: Orchestrate a behavior-preserving refactor — confirm tests green, restructure without changing behavior, keep green, review, gated commit. Thin wrapper over the orch-pipeline skill.
+---
+
+# MindForge — Orch: Refine Code
+# Usage: /mindforge:orch-refine-code <what to restructure>
+
+Manually launch the **refine-code** orchestration: improve structure while
+behavior stays identical, with the existing test suite as the safety net.
+
+## Usage
+
+```
+/mindforge:orch-refine-code <what to restructure>
+```
+
+Examples:
+
+```
+/mindforge:orch-refine-code extract the HTTP client out of poller.py
+/mindforge:orch-refine-code remove dead code and duplication in the dashboard module
+```
+
+## What It Does
+
+Activate the `orch-pipeline` skill (`.mindforge/skills/orch-pipeline/SKILL.md`)
+with `$ARGUMENTS` as the request and `operation = refine-code`. The engine will:
+
+1. **Step 0 — size classifier**: classify size (default floor: **medium** —
+   restructures touch multiple files).
+2. Confirm the relevant tests exist and are **green before** touching code; add
+   characterization tests first if coverage is thin. Plan the restructure as
+   MindForge XML under `.planning/` via `/mindforge:plan-write`. → **GATE 1**.
+3. Restructure in small steps, re-running tests after each (no new behavior tests
+   — the existing suite proves behavior is unchanged). Dead-code/dup sweeps
+   delegate to `/mindforge:de-slop`.
+4. `/mindforge:review`, then commit as `refactor(...)` (the diff must be
+   behavior-neutral) + Merkle-linked AUDIT.jsonl entry. → **GATE 2**.
+
+Use this only when behavior must **not** change. If behavior should change at
+all, use `/mindforge:orch-change-feature` or `/mindforge:orch-fix-defect`.
+
+If `$ARGUMENTS` is empty, ask the user what to refine.

package/.agent/skills/mindforge-add-backlog/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-add-backlog
-description: Add an idea to the backlog parking lot (999.x numbering)
+name: "mindforge-add-backlog"
+description: "Add an idea to the backlog parking lot (999.x numbering)"
 ---
 
 

package/.agent/skills/mindforge-add-phase/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-add-phase
-description: Add phase to end of current milestone in roadmap
+name: "mindforge-add-phase"
+description: "Add phase to end of current milestone in roadmap"
 ---
 
 

package/.agent/skills/mindforge-add-tests/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-add-tests
-description: Generate tests for a completed phase based on UAT criteria and implementation
+name: "mindforge-add-tests"
+description: "Generate tests for a completed phase based on UAT criteria and implementation"
 ---
 
 <objective>

package/.agent/skills/mindforge-add-todo/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-add-todo
-description: Capture idea or task as todo from current conversation context
+name: "mindforge-add-todo"
+description: "Capture idea or task as todo from current conversation context"
 ---
 
 

package/.agent/skills/mindforge-audit-milestone/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-audit-milestone
-description: Audit milestone completion against original intent before archiving
+name: "mindforge-audit-milestone"
+description: "Audit milestone completion against original intent before archiving"
 ---
 
 <objective>

package/.agent/skills/mindforge-audit-uat/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-audit-uat
-description: Cross-phase audit of all outstanding UAT and verification items
+name: "mindforge-audit-uat"
+description: "Cross-phase audit of all outstanding UAT and verification items"
 ---
 
 <objective>

package/.agent/skills/mindforge-autonomous/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-autonomous
-description: Run all remaining phases autonomously — discuss→plan→execute per phase
+name: "mindforge-autonomous"
+description: "Run all remaining phases autonomously — discuss→plan→execute per phase"
 ---
 
 <objective>

package/.agent/skills/mindforge-brainstorming/SKILL.md

@@ -1,5 +1,5 @@
 ---
-name: brainstorming
+name: "brainstorming"
 description: "You MUST use this before any creative work - creating features, building components, adding functionality, or modifying behavior. Explores user intent, requirements and design before implementation."
 ---
 

package/.agent/skills/mindforge-check-todos/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-check-todos
-description: List pending todos and select one to work on
+name: "mindforge-check-todos"
+description: "List pending todos and select one to work on"
 ---
 
 

package/.agent/skills/mindforge-cleanup/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-cleanup
-description: Archive accumulated phase directories from completed milestones
+name: "mindforge-cleanup"
+description: "Archive accumulated phase directories from completed milestones"
 ---
 
 <objective>

package/.agent/skills/mindforge-complete-milestone/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-complete-milestone
-description: Archive completed milestone and prepare for next version
+name: "mindforge-complete-milestone"
+description: "Archive completed milestone and prepare for next version"
 ---
 
 

package/.agent/skills/mindforge-debug/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-debug
-description: Systematic debugging with persistent state across context resets
+name: "mindforge-debug"
+description: "Systematic debugging with persistent state across context resets"
 ---
 
 

package/.agent/skills/mindforge-debug_extended/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-debug_extended
-description: Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes
+name: "mindforge-debug_extended"
+description: "Use when encountering any bug, test failure, or unexpected behavior, before proposing fixes"
 ---
 
 # Systematic Debugging

package/.agent/skills/mindforge-discuss-phase/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-discuss-phase
-description: Gather phase context through adaptive questioning before planning. Use --auto to skip interactive questions (the agent picks recommended defaults).
+name: "mindforge-discuss-phase"
+description: "Gather phase context through adaptive questioning before planning. Use --auto to skip interactive questions (the agent picks recommended defaults)."
 ---
 
 

package/.agent/skills/mindforge-do/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-do
-description: Route freeform text to the right MindForge command automatically
+name: "mindforge-do"
+description: "Route freeform text to the right MindForge command automatically"
 ---
 
 <objective>

package/.agent/skills/mindforge-execute-phase/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-execute-phase
-description: Execute all plans in a phase with wave-based parallelization
+name: "mindforge-execute-phase"
+description: "Execute all plans in a phase with wave-based parallelization"
 ---
 
 <objective>

package/.agent/skills/mindforge-execute-phase_extended/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-execute-phase_extended
-description: Use when you have a written implementation plan to execute in a separate session with review checkpoints
+name: "mindforge-execute-phase_extended"
+description: "Use when you have a written implementation plan to execute in a separate session with review checkpoints"
 ---
 
 # Executing Plans

package/.agent/skills/mindforge-fast/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-fast
-description: Execute a trivial task inline — no subagents, no planning overhead
+name: "mindforge-fast"
+description: "Execute a trivial task inline — no subagents, no planning overhead"
 ---
 
 

package/.agent/skills/mindforge-forensics/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-forensics
-description: Post-mortem investigation for failed MindForge workflows — analyzes git history, artifacts, and state to diagnose what went wrong
+name: "mindforge-forensics"
+description: "Post-mortem investigation for failed MindForge workflows — analyzes git history, artifacts, and state to diagnose what went wrong"
 ---
 
 

package/.agent/skills/mindforge-health/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-health
-description: Diagnose planning directory health and optionally repair issues
+name: "mindforge-health"
+description: "Diagnose planning directory health and optionally repair issues"
 ---
 
 <objective>

package/.agent/skills/mindforge-help/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-help
-description: Show available MindForge commands and usage guide
+name: "mindforge-help"
+description: "Show available MindForge commands and usage guide"
 ---
 
 <objective>

package/.agent/skills/mindforge-insert-phase/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-insert-phase
-description: Insert urgent work as decimal phase (e.g., 72.1) between existing phases
+name: "mindforge-insert-phase"
+description: "Insert urgent work as decimal phase (e.g., 72.1) between existing phases"
 ---
 
 

package/.agent/skills/mindforge-join-discord/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-join-discord
-description: Join the MindForge Discord community
+name: "mindforge-join-discord"
+description: "Join the MindForge Discord community"
 ---
 
 

package/.agent/skills/mindforge-list-phase-assumptions/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-list-phase-assumptions
-description: Surface the agent's assumptions about a phase approach before planning
+name: "mindforge-list-phase-assumptions"
+description: "Surface the agent's assumptions about a phase approach before planning"
 ---
 
 

package/.agent/skills/mindforge-list-workspaces/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-list-workspaces
-description: List active MindForge workspaces and their status
+name: "mindforge-list-workspaces"
+description: "List active MindForge workspaces and their status"
 ---
 
 <objective>

package/.agent/skills/mindforge-manager/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-manager
-description: Interactive command center for managing multiple phases from one terminal
+name: "mindforge-manager"
+description: "Interactive command center for managing multiple phases from one terminal"
 ---
 
 <objective>

package/.agent/skills/mindforge-map-codebase/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-map-codebase
-description: Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
+name: "mindforge-map-codebase"
+description: "Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents"
 ---
 
 

package/.agent/skills/mindforge-milestone-summary/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-milestone-summary
-description: Generate a comprehensive project summary from milestone artifacts for team onboarding and review
+name: "mindforge-milestone-summary"
+description: "Generate a comprehensive project summary from milestone artifacts for team onboarding and review"
 ---
 
 

package/.agent/skills/mindforge-neural-orchestrator/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: using-mindforge
-description: Use when starting any conversation - establishes how to find and use skills, requiring MindForge Skill tool invocation before ANY response including clarifying questions
+name: "using-mindforge"
+description: "Use when starting any conversation - establishes how to find and use skills, requiring MindForge Skill tool invocation before ANY response including clarifying questions"
 ---
 
 <SUBAGENT-STOP>

package/.agent/skills/mindforge-new-milestone/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-new-milestone
-description: Start a new milestone cycle — update PROJECT.md and route to requirements
+name: "mindforge-new-milestone"
+description: "Start a new milestone cycle — update PROJECT.md and route to requirements"
 ---
 
 <objective>

package/.agent/skills/mindforge-new-project/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-new-project
-description: Initialize a new project with deep context gathering and PROJECT.md
+name: "mindforge-new-project"
+description: "Initialize a new project with deep context gathering and PROJECT.md"
 ---
 
 <context>

package/.agent/skills/mindforge-new-workspace/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-new-workspace
-description: Create an isolated workspace with repo copies and independent .planning/
+name: "mindforge-new-workspace"
+description: "Create an isolated workspace with repo copies and independent .planning/"
 ---
 
 <context>

package/.agent/skills/mindforge-next/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-next
-description: Automatically advance to the next logical step in the MindForge workflow
+name: "mindforge-next"
+description: "Automatically advance to the next logical step in the MindForge workflow"
 ---
 
 <objective>

package/.agent/skills/mindforge-note/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-note
-description: Zero-friction idea capture. Append, list, or promote notes to todos.
+name: "mindforge-note"
+description: "Zero-friction idea capture. Append, list, or promote notes to todos."
 ---
 
 <objective>

package/.agent/skills/mindforge-parallel-mesh_extended/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: dispatching-parallel-agents
-description: Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies
+name: "dispatching-parallel-agents"
+description: "Use when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies"
 ---
 
 # Dispatching Parallel Agents

package/.agent/skills/mindforge-pause-work/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-pause-work
-description: Create context handoff when pausing work mid-phase
+name: "mindforge-pause-work"
+description: "Create context handoff when pausing work mid-phase"
 ---
 
 

package/.agent/skills/mindforge-plan-milestone-gaps/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-plan-milestone-gaps
-description: Create phases to close all gaps identified by milestone audit
+name: "mindforge-plan-milestone-gaps"
+description: "Create phases to close all gaps identified by milestone audit"
 ---
 
 <objective>

package/.agent/skills/mindforge-plan-phase/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-plan-phase
-description: Create detailed phase plan (PLAN.md) with verification loop
+name: "mindforge-plan-phase"
+description: "Create detailed phase plan (PLAN.md) with verification loop"
 ---
 
 <objective>

package/.agent/skills/mindforge-plan-phase_extended/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-plan-phase_extended
-description: Use when you have a spec or requirements for a multi-step task, before touching code
+name: "mindforge-plan-phase_extended"
+description: "Use when you have a spec or requirements for a multi-step task, before touching code"
 ---
 
 # Writing Plans

package/.agent/skills/mindforge-plant-seed/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-plant-seed
-description: Capture a forward-looking idea with trigger conditions — surfaces automatically at the right milestone
+name: "mindforge-plant-seed"
+description: "Capture a forward-looking idea with trigger conditions — surfaces automatically at the right milestone"
 ---
 
 

package/.agent/skills/mindforge-pr-branch/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-pr-branch
-description: Create a clean PR branch by filtering out .planning/ commits — ready for code review
+name: "mindforge-pr-branch"
+description: "Create a clean PR branch by filtering out .planning/ commits — ready for code review"
 ---
 
 

package/.agent/skills/mindforge-profile-user/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-profile-user
-description: Generate developer behavioral profile and create Claude-discoverable artifacts
+name: "mindforge-profile-user"
+description: "Generate developer behavioral profile and create Claude-discoverable artifacts"
 ---
 
 

package/.agent/skills/mindforge-progress/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-progress
-description: Check project progress, show context, and route to next action (execute or plan)
+name: "mindforge-progress"
+description: "Check project progress, show context, and route to next action (execute or plan)"
 ---
 
 <objective>

package/.agent/skills/mindforge-quick/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-quick
-description: Execute a quick task with MindForge guarantees (atomic commits, state tracking) but skip optional agents
+name: "mindforge-quick"
+description: "Execute a quick task with MindForge guarantees (atomic commits, state tracking) but skip optional agents"
 ---
 
 <objective>

package/.agent/skills/mindforge-reapply-patches/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-reapply-patches
-description: Reapply local modifications after a MindForge update
+name: "mindforge-reapply-patches"
+description: "Reapply local modifications after a MindForge update"
 ---
 
 

package/.agent/skills/mindforge-remove-phase/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-remove-phase
-description: Remove a future phase from roadmap and renumber subsequent phases
+name: "mindforge-remove-phase"
+description: "Remove a future phase from roadmap and renumber subsequent phases"
 ---
 
 <objective>

package/.agent/skills/mindforge-remove-workspace/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-remove-workspace
-description: Remove a MindForge workspace and clean up worktrees
+name: "mindforge-remove-workspace"
+description: "Remove a MindForge workspace and clean up worktrees"
 ---
 
 <context>

package/.agent/skills/mindforge-research-phase/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-research-phase
-description: Research how to implement a phase (standalone - usually use /mindforge-plan-phase instead)
+name: "mindforge-research-phase"
+description: "Research how to implement a phase (standalone - usually use /mindforge-plan-phase instead)"
 ---
 
 

package/.agent/skills/mindforge-resume-work/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-resume-work
-description: Resume work from previous session with full context restoration
+name: "mindforge-resume-work"
+description: "Resume work from previous session with full context restoration"
 ---
 
 

package/.agent/skills/mindforge-review/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-review
-description: Request cross-AI peer review of phase plans from external AI CLIs
+name: "mindforge-review"
+description: "Request cross-AI peer review of phase plans from external AI CLIs"
 ---
 
 

package/.agent/skills/mindforge-review-backlog/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-review-backlog
-description: Review and promote backlog items to active milestone
+name: "mindforge-review-backlog"
+description: "Review and promote backlog items to active milestone"
 ---
 
 

package/.agent/skills/mindforge-review-inbound/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: receiving-code-review
-description: Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation
+name: "receiving-code-review"
+description: "Use when receiving code review feedback, before implementing suggestions, especially if feedback seems unclear or technically questionable - requires technical rigor and verification, not performative agreement or blind implementation"
 ---
 
 # Code Review Reception

package/.agent/skills/mindforge-review-request/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: requesting-code-review
-description: Use when completing tasks, implementing major features, or before merging to verify work meets requirements
+name: "requesting-code-review"
+description: "Use when completing tasks, implementing major features, or before merging to verify work meets requirements"
 ---
 
 # Requesting Code Review

package/.agent/skills/mindforge-session-report/SKILL.md

@@ -1,6 +1,6 @@
 ---
-name: mindforge-session-report
-description: Generate a session report with token usage estimates, work summary, and outcomes
+name: "mindforge-session-report"
+description: "Generate a session report with token usage estimates, work summary, and outcomes"
 ---
 
 <objective>