mindforge-cc 2.0.0 → 2.1.1

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

@@ -0,0 +1,54 @@
+---
+name: mindforge-discuss-phase
+description: Gather phase context through adaptive questioning before planning. Use --auto to skip interactive questions (the agent picks recommended defaults).
+---
+
+
+<objective>
+Extract implementation decisions that downstream agents need — researcher and planner will use CONTEXT.md to know what to investigate and what choices are locked.
+
+**How it works:**
+1. Load prior context (PROJECT.md, REQUIREMENTS.md, STATE.md, prior CONTEXT.md files)
+2. Scout codebase for reusable assets and patterns
+3. Analyze phase — skip gray areas already decided in prior phases
+4. Present remaining gray areas — user selects which to discuss
+5. Deep-dive each selected area until satisfied
+6. Create CONTEXT.md with decisions that guide research and planning
+
+**Output:** `{phase_num}-CONTEXT.md` — decisions clear enough that downstream agents can act without asking the user again
+</objective>
+
+<execution_context>
+@.agent/workflows/mindforge-discuss-phase.md
+@.agent/workflows/mindforge-discuss-phase-assumptions.md
+@.agent/templates/context.md
+</execution_context>
+
+<context>
+Phase number: $ARGUMENTS (required)
+
+Context files are resolved in-workflow using `init phase-op` and roadmap/state tool calls.
+</context>
+
+<process>
+**Mode routing:**
+```bash
+DISCUSS_MODE=$(node ".agent/bin/mindforge-tools.cjs" config-get workflow.discuss_mode 2>/dev/null || echo "discuss")
+```
+
+If `DISCUSS_MODE` is `"assumptions"`: Read and execute @.agent/workflows/mindforge-discuss-phase-assumptions.md end-to-end.
+
+If `DISCUSS_MODE` is `"discuss"` (or unset, or any other value): Read and execute @.agent/workflows/mindforge-discuss-phase.md end-to-end.
+
+**MANDATORY:** The execution_context files listed above ARE the instructions. Read the workflow file BEFORE taking any action. The objective and success_criteria sections in this command file are summaries — the workflow file contains the complete step-by-step process with all required behaviors, config checks, and interaction patterns. Do not improvise from the summary.
+</process>
+
+<success_criteria>
+- Prior context loaded and applied (no re-asking decided questions)
+- Gray areas identified through intelligent analysis
+- User chose which areas to discuss
+- Each selected area explored until satisfied
+- Scope creep redirected to deferred ideas
+- CONTEXT.md captures decisions, not vague vision
+- User knows next steps
+</success_criteria>

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

@@ -0,0 +1,26 @@
+---
+name: mindforge-do
+description: Route freeform text to the right MindForge command automatically
+---
+
+<objective>
+Analyze freeform natural language input and dispatch to the most appropriate MindForge command.
+
+Acts as a smart dispatcher — never does the work itself. Matches intent to the best MindForge command using routing rules, confirms the match, then hands off.
+
+Use when you know what you want but don't know which `/mindforge-*` command to run.
+</objective>
+
+<execution_context>
+@.agent/workflows/mindforge-do.md
+@.agent/references/ui-brand.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+</context>
+
+<process>
+Execute the do workflow from @.agent/workflows/mindforge-do.md end-to-end.
+Route user intent to the best MindForge command and invoke it.
+</process>

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

@@ -0,0 +1,49 @@
+---
+name: mindforge-execute-phase
+description: Execute all plans in a phase with wave-based parallelization
+---
+
+<objective>
+Execute all plans in a phase using wave-based parallel execution.
+
+Orchestrator stays lean: discover plans, analyze dependencies, group into waves, spawn subagents, collect results. Each subagent loads the full execute-plan context and handles its own plan.
+
+Optional wave filter:
+- `--wave N` executes only Wave `N` for pacing, quota management, or staged rollout
+- phase verification/completion still only happens when no incomplete plans remain after the selected wave finishes
+
+Flag handling rule:
+- The optional flags documented below are available behaviors, not implied active behaviors
+- A flag is active only when its literal token appears in `$ARGUMENTS`
+- If a documented flag is absent from `$ARGUMENTS`, treat it as inactive
+
+Context budget: ~15% orchestrator, 100% fresh per subagent.
+</objective>
+
+<execution_context>
+@.agent/workflows/mindforge-execute-phase.md
+@.agent/references/ui-brand.md
+</execution_context>
+
+<context>
+Phase: $ARGUMENTS
+
+**Available optional flags (documentation only — not automatically active):**
+- `--wave N` — Execute only Wave `N` in the phase. Use when you want to pace execution or stay inside usage limits.
+- `--gaps-only` — Execute only gap closure plans (plans with `gap_closure: true` in frontmatter). Use after verify-work creates fix plans.
+- `--interactive` — Execute plans sequentially inline (no subagents) with user checkpoints between tasks. Lower token usage, pair-programming style. Best for small phases, bug fixes, and verification gaps.
+
+**Active flags must be derived from `$ARGUMENTS`:**
+- `--wave N` is active only if the literal `--wave` token is present in `$ARGUMENTS`
+- `--gaps-only` is active only if the literal `--gaps-only` token is present in `$ARGUMENTS`
+- `--interactive` is active only if the literal `--interactive` token is present in `$ARGUMENTS`
+- If none of these tokens appear, run the standard full-phase execution flow with no flag-specific filtering
+- Do not infer that a flag is active just because it is documented in this prompt
+
+Context files are resolved inside the workflow via `mindforge-tools init execute-phase` and per-subagent `<files_to_read>` blocks.
+</context>
+
+<process>
+Execute the execute-phase workflow from @.agent/workflows/mindforge-execute-phase.md end-to-end.
+Preserve all workflow gates (wave execution, checkpoint handling, verification, state updates, routing).
+</process>

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

@@ -0,0 +1,23 @@
+---
+name: mindforge-fast
+description: Execute a trivial task inline — no subagents, no planning overhead
+---
+
+
+<objective>
+Execute a trivial task directly in the current context without spawning subagents
+or generating PLAN.md files. For tasks too small to justify planning overhead:
+typo fixes, config changes, small refactors, forgotten commits, simple additions.
+
+This is NOT a replacement for /mindforge-quick — use /mindforge-quick for anything that
+needs research, multi-step planning, or verification. /mindforge-fast is for tasks
+you could describe in one sentence and execute in under 2 minutes.
+</objective>
+
+<execution_context>
+@.agent/workflows/mindforge-fast.md
+</execution_context>
+
+<process>
+Execute the fast workflow from @.agent/workflows/mindforge-fast.md end-to-end.
+</process>

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

@@ -0,0 +1,49 @@
+---
+name: mindforge-forensics
+description: Post-mortem investigation for failed MindForge workflows — analyzes git history, artifacts, and state to diagnose what went wrong
+---
+
+
+<objective>
+Investigate what went wrong during a MindForge workflow execution. Analyzes git history, `.planning/` artifacts, and file system state to detect anomalies and generate a structured diagnostic report.
+
+Purpose: Diagnose failed or stuck workflows so the user can understand root cause and take corrective action.
+Output: Forensic report saved to `.planning/forensics/`, presented inline, with optional issue creation.
+</objective>
+
+<execution_context>
+@.agent/workflows/mindforge-forensics.md
+</execution_context>
+
+<context>
+**Data sources:**
+- `git log` (recent commits, patterns, time gaps)
+- `git status` / `git diff` (uncommitted work, conflicts)
+- `.planning/STATE.md` (current position, session history)
+- `.planning/ROADMAP.md` (phase scope and progress)
+- `.planning/phases/*/` (PLAN.md, SUMMARY.md, VERIFICATION.md, CONTEXT.md)
+- `.planning/reports/SESSION_REPORT.md` (last session outcomes)
+
+**User input:**
+- Problem description: $ARGUMENTS (optional — will ask if not provided)
+</context>
+
+<process>
+Read and execute the forensics workflow from @.agent/workflows/mindforge-forensics.md end-to-end.
+</process>
+
+<success_criteria>
+- Evidence gathered from all available data sources
+- At least 4 anomaly types checked (stuck loop, missing artifacts, abandoned work, crash/interruption)
+- Structured forensic report written to `.planning/forensics/report-{timestamp}.md`
+- Report presented inline with findings, anomalies, and recommendations
+- Interactive investigation offered for deeper analysis
+- GitHub issue creation offered if actionable findings exist
+</success_criteria>
+
+<critical_rules>
+- **Read-only investigation:** Do not modify project source files during forensics. Only write the forensic report and update STATE.md session tracking.
+- **Redact sensitive data:** Strip absolute paths, API keys, tokens from reports and issues.
+- **Ground findings in evidence:** Every anomaly must cite specific commits, files, or state data.
+- **No speculation without evidence:** If data is insufficient, say so — do not fabricate root causes.
+</critical_rules>

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

@@ -0,0 +1,17 @@
+---
+name: mindforge-health
+description: Diagnose planning directory health and optionally repair issues
+---
+
+<objective>
+Validate `.planning/` directory integrity and report actionable issues. Checks for missing files, invalid configurations, inconsistent state, and orphaned plans.
+</objective>
+
+<execution_context>
+@.agent/workflows/mindforge-health.md
+</execution_context>
+
+<process>
+Execute the health workflow from @.agent/workflows/mindforge-health.md end-to-end.
+Parse --repair flag from arguments and pass to workflow.
+</process>

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

@@ -0,0 +1,23 @@
+---
+name: mindforge-help
+description: Show available MindForge commands and usage guide
+---
+
+<objective>
+Display the complete MindForge command reference.
+
+Output ONLY the reference content below. Do NOT add:
+- Project-specific analysis
+- Git status or file context
+- Next-step suggestions
+- Any commentary beyond the reference
+</objective>
+
+<execution_context>
+@.agent/workflows/mindforge-help.md
+</execution_context>
+
+<process>
+Output the complete MindForge command reference from @.agent/workflows/mindforge-help.md.
+Display the reference content directly — no additions or modifications.
+</process>

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

@@ -0,0 +1,28 @@
+---
+name: mindforge-insert-phase
+description: Insert urgent work as decimal phase (e.g., 72.1) between existing phases
+---
+
+
+<objective>
+Insert a decimal phase for urgent work discovered mid-milestone that must be completed between existing integer phases.
+
+Uses decimal numbering (72.1, 72.2, etc.) to preserve the logical sequence of planned phases while accommodating urgent insertions.
+
+Purpose: Handle urgent work discovered during execution without renumbering entire roadmap.
+</objective>
+
+<execution_context>
+@.agent/workflows/mindforge-insert-phase.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS (format: <after-phase-number> <description>)
+
+Roadmap and state are resolved in-workflow via `init phase-op` and targeted tool calls.
+</context>
+
+<process>
+Execute the insert-phase workflow from @.agent/workflows/mindforge-insert-phase.md end-to-end.
+Preserve all validation gates (argument parsing, phase verification, decimal calculation, roadmap updates).
+</process>

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

@@ -0,0 +1,19 @@
+---
+name: mindforge-join-discord
+description: Join the MindForge Discord community
+---
+
+
+<objective>
+Display the Discord invite link for the MindForge community server.
+</objective>
+
+<output>
+# Join the MindForge Discord
+
+Connect with other MindForge users, get help, share what you're building, and stay updated.
+
+**Invite link:** https://discord.gg/mindforge
+
+Click the link or paste it into your browser to join.
+</output>

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

@@ -0,0 +1,41 @@
+---
+name: mindforge-list-phase-assumptions
+description: Surface the agent's assumptions about a phase approach before planning
+---
+
+
+<objective>
+Analyze a phase and present the agent's assumptions about technical approach, implementation order, scope boundaries, risk areas, and dependencies.
+
+Purpose: Help users see what the agent thinks BEFORE planning begins - enabling course correction early when assumptions are wrong.
+Output: Conversational output only (no file creation) - ends with "What do you think?" prompt
+</objective>
+
+<execution_context>
+@.agent/workflows/mindforge-list-phase-assumptions.md
+</execution_context>
+
+<context>
+Phase number: $ARGUMENTS (required)
+
+Project state and roadmap are loaded in-workflow using targeted reads.
+</context>
+
+<process>
+1. Validate phase number argument (error if missing or invalid)
+2. Check if phase exists in roadmap
+3. Follow list-phase-assumptions.md workflow:
+   - Analyze roadmap description
+   - Surface assumptions about: technical approach, implementation order, scope, risks, dependencies
+   - Present assumptions clearly
+   - Prompt "What do you think?"
+4. Gather feedback and offer next steps
+</process>
+
+<success_criteria>
+
+- Phase validated against roadmap
+- Assumptions surfaced across five areas
+- User prompted for feedback
+- User knows next steps (discuss context, plan phase, or correct assumptions)
+  </success_criteria>

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

@@ -0,0 +1,17 @@
+---
+name: mindforge-list-workspaces
+description: List active MindForge workspaces and their status
+---
+
+<objective>
+Scan `~/mindforge-workspaces/` for workspace directories containing `WORKSPACE.md` manifests. Display a summary table with name, path, repo count, strategy, and MindForge project status.
+</objective>
+
+<execution_context>
+@.agent/workflows/mindforge-list-workspaces.md
+@.agent/references/ui-brand.md
+</execution_context>
+
+<process>
+Execute the list-workspaces workflow from @.agent/workflows/mindforge-list-workspaces.md end-to-end.
+</process>

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

@@ -0,0 +1,32 @@
+---
+name: mindforge-manager
+description: Interactive command center for managing multiple phases from one terminal
+---
+
+<objective>
+Single-terminal command center for managing a milestone. Shows a dashboard of all phases with visual status indicators, recommends optimal next actions, and dispatches work — discuss runs inline, plan/execute run as background agents.
+
+Designed for power users who want to parallelize work across phases from one terminal: discuss a phase while another plans or executes in the background.
+
+**Creates/Updates:**
+- No files created directly — dispatches to existing MindForge commands via Skill() and background Task agents.
+- Reads `.planning/STATE.md`, `.planning/ROADMAP.md`, phase directories for status.
+
+**After:** User exits when done managing, or all phases complete and milestone lifecycle is suggested.
+</objective>
+
+<execution_context>
+@.agent/workflows/mindforge-manager.md
+@.agent/references/ui-brand.md
+</execution_context>
+
+<context>
+No arguments required. Requires an active milestone with ROADMAP.md and STATE.md.
+
+Project context, phase list, dependencies, and recommendations are resolved inside the workflow using `mindforge-tools.cjs init manager`. No upfront context loading needed.
+</context>
+
+<process>
+Execute the manager workflow from @.agent/workflows/mindforge-manager.md end-to-end.
+Maintain the dashboard refresh loop until the user exits or all phases complete.
+</process>

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

@@ -0,0 +1,64 @@
+---
+name: mindforge-map-codebase
+description: Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents
+---
+
+
+<objective>
+Analyze existing codebase using parallel mindforge-codebase-mapper agents to produce structured codebase documents.
+
+Each mapper agent explores a focus area and **writes documents directly** to `.planning/codebase/`. The orchestrator only receives confirmations, keeping context usage minimal.
+
+Output: .planning/codebase/ folder with 7 structured documents about the codebase state.
+</objective>
+
+<execution_context>
+@.agent/workflows/mindforge-map-codebase.md
+</execution_context>
+
+<context>
+Focus area: $ARGUMENTS (optional - if provided, tells agents to focus on specific subsystem)
+
+**Load project state if exists:**
+Check for .planning/STATE.md - loads context if project already initialized
+
+**This command can run:**
+- Before /mindforge-new-project (brownfield codebases) - creates codebase map first
+- After /mindforge-new-project (greenfield codebases) - updates codebase map as code evolves
+- Anytime to refresh codebase understanding
+</context>
+
+<when_to_use>
+**Use map-codebase for:**
+- Brownfield projects before initialization (understand existing code first)
+- Refreshing codebase map after significant changes
+- Onboarding to an unfamiliar codebase
+- Before major refactoring (understand current state)
+- When STATE.md references outdated codebase info
+
+**Skip map-codebase for:**
+- Greenfield projects with no code yet (nothing to map)
+- Trivial codebases (<5 files)
+</when_to_use>
+
+<process>
+1. Check if .planning/codebase/ already exists (offer to refresh or skip)
+2. Create .planning/codebase/ directory structure
+3. Spawn 4 parallel mindforge-codebase-mapper agents:
+   - Agent 1: tech focus → writes STACK.md, INTEGRATIONS.md
+   - Agent 2: arch focus → writes ARCHITECTURE.md, STRUCTURE.md
+   - Agent 3: quality focus → writes CONVENTIONS.md, TESTING.md
+   - Agent 4: concerns focus → writes CONCERNS.md
+4. Wait for agents to complete, collect confirmations (NOT document contents)
+5. Verify all 7 documents exist with line counts
+6. Commit codebase map
+7. Offer next steps (typically: /mindforge-new-project or /mindforge-plan-phase)
+</process>
+
+<success_criteria>
+- [ ] .planning/codebase/ directory created
+- [ ] All 7 codebase documents written by mapper agents
+- [ ] Documents follow template structure
+- [ ] Parallel agents completed without errors
+- [ ] User knows next steps
+</success_criteria>

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

@@ -0,0 +1,44 @@
+---
+name: mindforge-milestone-summary
+description: Generate a comprehensive project summary from milestone artifacts for team onboarding and review
+---
+
+
+<objective>
+Generate a structured milestone summary for team onboarding and project review. Reads completed milestone artifacts (ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION files) and produces a human-friendly overview of what was built, how, and why.
+
+Purpose: Enable new team members to understand a completed project by reading one document and asking follow-up questions.
+Output: MILESTONE_SUMMARY written to `.planning/reports/`, presented inline, optional interactive Q&A.
+</objective>
+
+<execution_context>
+@.agent/workflows/mindforge-milestone-summary.md
+</execution_context>
+
+<context>
+**Project files:**
+- `.planning/ROADMAP.md`
+- `.planning/PROJECT.md`
+- `.planning/STATE.md`
+- `.planning/RETROSPECTIVE.md`
+- `.planning/milestones/v{version}-ROADMAP.md` (if archived)
+- `.planning/milestones/v{version}-REQUIREMENTS.md` (if archived)
+- `.planning/phases/*-*/` (SUMMARY.md, VERIFICATION.md, CONTEXT.md, RESEARCH.md)
+
+**User input:**
+- Version: $ARGUMENTS (optional — defaults to current/latest milestone)
+</context>
+
+<process>
+Read and execute the milestone-summary workflow from @.agent/workflows/mindforge-milestone-summary.md end-to-end.
+</process>
+
+<success_criteria>
+- Milestone version resolved (from args, STATE.md, or archive scan)
+- All available artifacts read (ROADMAP, REQUIREMENTS, CONTEXT, SUMMARY, VERIFICATION, RESEARCH, RETROSPECTIVE)
+- Summary document written to `.planning/reports/MILESTONE_SUMMARY-v{version}.md`
+- All 7 sections generated (Overview, Architecture, Phases, Decisions, Requirements, Tech Debt, Getting Started)
+- Summary presented inline to user
+- Interactive Q&A offered
+- STATE.md updated
+</success_criteria>

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

@@ -0,0 +1,38 @@
+---
+name: mindforge-new-milestone
+description: Start a new milestone cycle — update PROJECT.md and route to requirements
+---
+
+<objective>
+Start a new milestone: questioning → research (optional) → requirements → roadmap.
+
+Brownfield equivalent of new-project. Project exists, PROJECT.md has history. Gathers "what's next", updates PROJECT.md, then runs requirements → roadmap cycle.
+
+**Creates/Updates:**
+- `.planning/PROJECT.md` — updated with new milestone goals
+- `.planning/research/` — domain research (optional, NEW features only)
+- `.planning/REQUIREMENTS.md` — scoped requirements for this milestone
+- `.planning/ROADMAP.md` — phase structure (continues numbering)
+- `.planning/STATE.md` — reset for new milestone
+
+**After:** `/mindforge-plan-phase [N]` to start execution.
+</objective>
+
+<execution_context>
+@.agent/workflows/mindforge-new-milestone.md
+@.agent/references/questioning.md
+@.agent/references/ui-brand.md
+@.agent/templates/project.md
+@.agent/templates/requirements.md
+</execution_context>
+
+<context>
+Milestone name: $ARGUMENTS (optional - will prompt if not provided)
+
+Project and milestone context files are resolved inside the workflow (`init new-milestone`) and delegated via `<files_to_read>` blocks where subagents are used.
+</context>
+
+<process>
+Execute the new-milestone workflow from @.agent/workflows/mindforge-new-milestone.md end-to-end.
+Preserve all workflow gates (validation, questioning, research, requirements, roadmap approval, commits).
+</process>

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

@@ -0,0 +1,36 @@
+---
+name: mindforge-new-project
+description: Initialize a new project with deep context gathering and PROJECT.md
+---
+
+<context>
+**Flags:**
+- `--auto` — Automatic mode. After config questions, runs research → requirements → roadmap without further interaction. Expects idea document via @ reference.
+</context>
+
+<objective>
+Initialize a new project through unified flow: questioning → research (optional) → requirements → roadmap.
+
+**Creates:**
+- `.planning/PROJECT.md` — project context
+- `.planning/config.json` — workflow preferences
+- `.planning/research/` — domain research (optional)
+- `.planning/REQUIREMENTS.md` — scoped requirements
+- `.planning/ROADMAP.md` — phase structure
+- `.planning/STATE.md` — project memory
+
+**After this command:** Run `/mindforge-plan-phase 1` to start execution.
+</objective>
+
+<execution_context>
+@.agent/workflows/mindforge-new-project.md
+@.agent/references/questioning.md
+@.agent/references/ui-brand.md
+@.agent/templates/project.md
+@.agent/templates/requirements.md
+</execution_context>
+
+<process>
+Execute the new-project workflow from @.agent/workflows/mindforge-new-project.md end-to-end.
+Preserve all workflow gates (validation, approvals, commits, routing).
+</process>

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

@@ -0,0 +1,39 @@
+---
+name: mindforge-new-workspace
+description: Create an isolated workspace with repo copies and independent .planning/
+---
+
+<context>
+**Flags:**
+- `--name` (required) — Workspace name
+- `--repos` — Comma-separated repo paths or names. If omitted, interactive selection from child git repos in cwd
+- `--path` — Target directory. Defaults to `~/mindforge-workspaces/<name>`
+- `--strategy` — `worktree` (default, lightweight) or `clone` (fully independent)
+- `--branch` — Branch to checkout. Defaults to `workspace/<name>`
+- `--auto` — Skip interactive questions, use defaults
+</context>
+
+<objective>
+Create a physical workspace directory containing copies of specified git repos (as worktrees or clones) with an independent `.planning/` directory for isolated MindForge sessions.
+
+**Use cases:**
+- Multi-repo orchestration: work on a subset of repos in parallel with isolated MindForge state
+- Feature branch isolation: create a worktree of the current repo with its own `.planning/`
+
+**Creates:**
+- `<path>/WORKSPACE.md` — workspace manifest
+- `<path>/.planning/` — independent planning directory
+- `<path>/<repo>/` — git worktree or clone for each specified repo
+
+**After this command:** `cd` into the workspace and run `/mindforge-new-project` to initialize MindForge.
+</objective>
+
+<execution_context>
+@.agent/workflows/mindforge-new-workspace.md
+@.agent/references/ui-brand.md
+</execution_context>
+
+<process>
+Execute the new-workspace workflow from @.agent/workflows/mindforge-new-workspace.md end-to-end.
+Preserve all workflow gates (validation, approvals, commits, routing).
+</process>

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

@@ -0,0 +1,19 @@
+---
+name: mindforge-next
+description: Automatically advance to the next logical step in the MindForge workflow
+---
+
+<objective>
+Detect the current project state and automatically invoke the next logical MindForge workflow step.
+No arguments needed — reads STATE.md, ROADMAP.md, and phase directories to determine what comes next.
+
+Designed for rapid multi-project workflows where remembering which phase/step you're on is overhead.
+</objective>
+
+<execution_context>
+@.agent/workflows/mindforge-next.md
+</execution_context>
+
+<process>
+Execute the next workflow from @.agent/workflows/mindforge-next.md end-to-end.
+</process>

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

@@ -0,0 +1,29 @@
+---
+name: mindforge-note
+description: Zero-friction idea capture. Append, list, or promote notes to todos.
+---
+
+<objective>
+Zero-friction idea capture — one Write call, one confirmation line.
+
+Three subcommands:
+- **append** (default): Save a timestamped note file. No questions, no formatting.
+- **list**: Show all notes from project and global scopes.
+- **promote**: Convert a note into a structured todo.
+
+Runs inline — no Task, no AskUserQuestion, no Bash.
+</objective>
+
+<execution_context>
+@.agent/workflows/mindforge-note.md
+@.agent/references/ui-brand.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+</context>
+
+<process>
+Execute the note workflow from @.agent/workflows/mindforge-note.md end-to-end.
+Capture the note, list notes, or promote to todo — depending on arguments.
+</process>