mindforge-cc 2.0.0 → 2.1.1

package/docs/{reference → references}/commands.md

@@ -1,89 +1,99 @@
 # MindForge v2.0.0 — Complete Commands Reference
 
-## All 40+ commands
+## All 50+ commands
 
 ### Lifecycle commands (core workflow)
 
 | Command | Usage | Description | Added |
 |---|---|---|---|
-| `/mindforge:init-project` | `init-project` | Guided project setup — creates all `.planning/` files |
-| `/mindforge:discuss-phase` | `discuss-phase [N] [--batch|--auto]` | Pre-planning interview to capture implementation decisions |
-| `/mindforge:plan-phase` | `plan-phase [N]` | Research, decompose, and create atomic task plans |
+| `/mindforge:init-project` | `init-project` | Guided project setup — creates all `.planning/` files | |
+| `/mindforge:discuss-phase` | `discuss-phase [N] [--batch|--auto]` | Pre-planning interview to capture implementation decisions | |
+| `/mindforge:ui-phase` | `ui-phase [N]` | Generate UI design contract (UI-SPEC.md) | v2.0.0 |
+| `/mindforge:plan-phase` | `plan-phase [N]` | Research, decompose, and create atomic task plans | |
 | `/mindforge:execute-phase` | `execute-phase [N]` | Wave-based parallel execution of all phase plans | Day 1+2 |
-| `/mindforge:verify-phase` | `verify-phase [N]` | Automated + human acceptance testing pipeline |
-| `/mindforge:ship` | `ship [N]` | Create PR, write release notes, push to remote |
-| `/mindforge:auto` | `auto [--phase N] [--milestone M]` | Walk-away autonomous execution with stuck detection |
-| `/mindforge:steer` | `steer "instruction"` | Inject guidance into a running autonomous session |
-| `/mindforge:next` | `next` | Auto-detect and execute the correct next workflow step |
-| `/mindforge:cross-review` | `cross-review` | Adversarial multi-model code review and synthesis |
-| `/mindforge:research` | `research "query"` | Deep research using Gemini 1.5 Pro 1M context |
-| `/mindforge:remember` | `remember [--add X|--search Y|--promote ID|--stats]` | Persistent knowledge graph management |
+| `/mindforge:ui-review` | `ui-review [N]` | Retroactive 6-pillar visual audit | v2.0.0 |
+| `/mindforge:verify-phase` | `verify-phase [N]` | Automated + human acceptance testing pipeline | |
+| `/mindforge:validate-phase` | `validate-phase [N]` | Requirement coverage and test gap audit | v2.0.0 |
+| `/mindforge:ship` | `ship [N]` | Create PR, write release notes, push to remote | |
+| `/mindforge:auto` | `auto [--phase N] [--milestone M]` | Walk-away autonomous execution with stuck detection | |
+| `/mindforge:steer` | `steer "instruction"` | Inject guidance into a running autonomous session | |
+| `/mindforge:next` | `next` | Auto-detect and execute the correct next workflow step | |
+| `/mindforge:cross-review` | `cross-review` | Adversarial multi-model code review and synthesis | |
+| `/mindforge:research` | `research "query"` | Deep research using Gemini 1.5 Pro 1M context | |
+| `/mindforge:remember` | `remember [--add X|--search Y|--promote ID|--stats]` | Persistent knowledge graph management | |
+| `/mindforge:workstreams` | `workstreams [list|create|switch|status|complete]` | Manage parallel feature tracks with isolated state | v2.0.0 |
 
 ### Project setup & discovery
 
 | Command | Usage | Description | Added |
 |---|---|---|---|
-| `/mindforge:map-codebase` | `map-codebase` | Brownfield onboarding: infer stack and seed docs |
-| `/mindforge:quick` | `quick` | Run a small, single-task plan without a full phase |
-| `/mindforge:status` | `status` | Show current phase, plan status, and next action |
-| `/mindforge:health` | `health [--repair]` | Validate installation and repair drift |
-| `/mindforge:review` | `review [N]` | Run a structured review pass for a phase |
-| `/mindforge:debug` | `debug [plan-id]` | Debug a failed plan with root-cause workflow |
+| `/mindforge:map-codebase` | `map-codebase` | Brownfield onboarding: infer stack and seed docs | |
+| `/mindforge:do` | `do <text>` | Smart dispatcher for natural language intent | v2.0.0 |
+| `/mindforge:note` | `note <text> [list|promote N]` | Zero-friction idea capture and todo promotion | v2.0.0 |
+| `/mindforge:quick` | `quick` | Run a small, single-task plan without a full phase | |
+| `/mindforge:status` | `status` | Show current phase, plan status, and next action | |
+| `/mindforge:health` | `health [--repair]` | Validate installation and repair drift | |
+| `/mindforge:review` | `review [N]` | Run a structured review pass for a phase | |
+| `/mindforge:debug` | `debug [plan-id]` | Debug a failed plan with root-cause workflow | |
+| `/mindforge:add-backlog` | `add-backlog <desc>` | Park ideas in 999.x "parking lot" | v2.0.0 |
+| `/mindforge:review-backlog` | `review-backlog` | Review and promote backlog items to active phases | v2.0.0 |
+| `/mindforge:plant-seed` | `plant-seed <idea>` | Capture speculative ideas with triggers | v2.0.0 |
 
 ### Governance & compliance
 
 | Command | Usage | Description | Added |
 |---|---|---|---|
-| `/mindforge:approve` | `approve [--tier 2|3]` | Process approvals and emergency overrides |
-| `/mindforge:audit` | `audit [--phase N] [--event X] [--since DATE]` | Query `AUDIT.jsonl` history |
-| `/mindforge:security-scan` | `security-scan [--deep] [--secrets] [--deps]` | Security scan with OWASP classification |
-| `/mindforge:milestone` | `milestone [name]` | Create or update milestone definitions |
-| `/mindforge:complete-milestone` | `complete-milestone [name]` | Archive milestone and generate release report |
-| `/mindforge:retrospective` | `retrospective [N]` | Phase retrospective and improvement actions |
+| `/mindforge:approve` | `approve [--tier 2|3]` | Process approvals and emergency overrides | |
+| `/mindforge:audit` | `audit [--phase N] [--event X] [--since DATE]` | Query `AUDIT.jsonl` history | |
+| `/mindforge:security-scan` | `security-scan [--deep] [--secrets] [--deps]` | Security scan with OWASP classification | |
+| `/mindforge:milestone` | `milestone [name]` | Create or update milestone definitions | |
+| `/mindforge:complete-milestone` | `complete-milestone [name]` | Archive milestone and generate release report | |
+| `/mindforge:retrospective` | `retrospective [N]` | Phase retrospective and improvement actions | |
 
 ### Skills & plugins
 
 | Command | Usage | Description | Added |
 |---|---|---|---|
-| `/mindforge:skills` | `skills [list|validate|refresh]` | Manage core/org/project skills |
-| `/mindforge:install-skill` | `install-skill <name> [--version]` | Install skill from registry |
-| `/mindforge:publish-skill` | `publish-skill <path>` | Publish a skill to the registry |
-| `/mindforge:plugins` | `plugins [list|install|uninstall|validate]` | Manage plugin lifecycle |
+| `/mindforge:skills` | `skills [list|validate|refresh]` | Manage core/org/project skills | |
+| `/mindforge:install-skill` | `install-skill <name> [--version]` | Install skill from registry | |
+| `/mindforge:publish-skill` | `publish-skill <path>` | Publish a skill to the registry | |
+| `/mindforge:plugins` | `plugins [list|install|uninstall|validate]` | Manage plugin lifecycle | |
 
 ### Intelligence & metrics
 
 | Command | Usage | Description | Added |
 |---|---|---|---|
-| `/mindforge:metrics` | `metrics [--phase N]` | Compute quality and throughput metrics |
-| `/mindforge:profile-team` | `profile-team` | Generate team skill and ownership profile |
-| `/mindforge:benchmark` | `benchmark [--skill X]` | Measure skill effectiveness |
-| `/mindforge:tokens` | `tokens [--profile] [--summary]` | Token usage profiling and optimisation |
+| `/mindforge:metrics` | `metrics [--phase N]` | Compute quality and throughput metrics | |
+| `/mindforge:profile-team` | `profile-team` | Generate team skill and ownership profile | |
+| `/mindforge:benchmark` | `benchmark [--skill X]` | Measure skill effectiveness | |
+| `/mindforge:tokens` | `tokens [--profile] [--summary]` | Token usage profiling and optimisation | |
 
 ### Integrations & distribution
 
 | Command | Usage | Description | Added |
 |---|---|---|---|
-| `/mindforge:init-org` | `init-org` | Org-wide MindForge setup |
-| `/mindforge:sync-jira` | `sync-jira [--project KEY]` | Sync phases and plans to Jira |
-| `/mindforge:sync-confluence` | `sync-confluence [--page ...]` | Publish docs to Confluence |
-| `/mindforge:pr-review` | `pr-review [--range A..B]` | AI PR review with context |
-| `/mindforge:workspace` | `workspace [detect|plan|test]` | Monorepo workspace management |
-| `/mindforge:browse` | `browse [--navigate URL] [--command]` | Control persistent browser daemon and sessions |
-| `/mindforge:qa` | `qa [--diff] [--all]` | Run systematic visual QA and regression tests |
+| `/mindforge:init-org` | `init-org` | Org-wide MindForge setup | |
+| `/mindforge:sync-jira` | `sync-jira [--project KEY]` | Sync phases and plans to Jira | |
+| `/mindforge:sync-confluence` | `sync-confluence [--page ...]` | Publish docs to Confluence | |
+| `/mindforge:pr-review` | `pr-review [--range A..B]` | AI PR review with context | |
+| `/mindforge:workspace` | `workspace [detect|plan|test]` | Monorepo workspace management | |
+| `/mindforge:browse` | `browse [--navigate URL] [--command]` | Control persistent browser daemon and sessions | |
+| `/mindforge:qa` | `qa [--diff] [--all]` | Run systematic visual QA and regression tests | |
 
 ### Release & maintenance
 
 | Command | Usage | Description | Added |
 |---|---|---|---|
-| `/mindforge:update` | `update [--apply] [--force] [--check]` | Check for and apply framework updates |
-| `/mindforge:migrate` | `migrate [--from vX] [--to vY] [--dry-run]` | Run schema migrations |
-| `/mindforge:release` | `release [--tag vX]` | Framework release pipeline (core team) |
+| `/mindforge:update` | `update [--apply] [--force] [--check]` | Check for and apply framework updates | |
+| `/mindforge:migrate` | `migrate [--from vX] [--to vY] [--dry-run]` | Run schema migrations | |
+| `/mindforge:session-report` | `session-report` | Generate post-session summary and resource profiling | v2.0.0 |
+| `/mindforge:release` | `release [--tag vX]` | Framework release pipeline (core team) | |
 
 ### Utility
 
 | Command | Usage | Description | Added |
 |---|---|---|---|
-| `/mindforge:help` | `help` | Show all available commands and current project status |
+| `/mindforge:help` | `help` | Show all available commands and current project status | |
 
 ## Command interface contract (v1.0.0 stable)
 

package/docs/references/continuation-format.md

@@ -0,0 +1,249 @@
+# Continuation Format
+
+Standard format for presenting next steps after completing a command or workflow.
+
+## Core Structure
+
+```
+---
+
+## ▶ Next Up
+
+**{identifier}: {name}** — {one-line description}
+
+`{command to copy-paste}`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**Also available:**
+- `{alternative option 1}` — description
+- `{alternative option 2}` — description
+
+---
+```
+
+## Format Rules
+
+1. **Always show what it is** — name + description, never just a command path
+2. **Pull context from source** — ROADMAP.md for phases, PLAN.md `<objective>` for plans
+3. **Command in inline code** — backticks, easy to copy-paste, renders as clickable link
+4. **`/clear` explanation** — always include, keeps it concise but explains why
+5. **"Also available" not "Other options"** — sounds more app-like
+6. **Visual separators** — `---` above and below to make it stand out
+
+## Variants
+
+### Execute Next Plan
+
+```
+---
+
+## ▶ Next Up
+
+**02-03: Refresh Token Rotation** — Add /api/auth/refresh with sliding expiry
+
+`/mindforge-execute-phase 2`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**Also available:**
+- Review plan before executing
+- `/mindforge-list-phase-assumptions 2` — check assumptions
+
+---
+```
+
+### Execute Final Plan in Phase
+
+Add note that this is the last plan and what comes after:
+
+```
+---
+
+## ▶ Next Up
+
+**02-03: Refresh Token Rotation** — Add /api/auth/refresh with sliding expiry
+<sub>Final plan in Phase 2</sub>
+
+`/mindforge-execute-phase 2`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**After this completes:**
+- Phase 2 → Phase 3 transition
+- Next: **Phase 3: Core Features** — User dashboard and settings
+
+---
+```
+
+### Plan a Phase
+
+```
+---
+
+## ▶ Next Up
+
+**Phase 2: Authentication** — JWT login flow with refresh tokens
+
+`/mindforge-plan-phase 2`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**Also available:**
+- `/mindforge-discuss-phase 2` — gather context first
+- `/mindforge-research-phase 2` — investigate unknowns
+- Review roadmap
+
+---
+```
+
+### Phase Complete, Ready for Next
+
+Show completion status before next action:
+
+```
+---
+
+## ✓ Phase 2 Complete
+
+3/3 plans executed
+
+## ▶ Next Up
+
+**Phase 3: Core Features** — User dashboard, settings, and data export
+
+`/mindforge-plan-phase 3`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+
+**Also available:**
+- `/mindforge-discuss-phase 3` — gather context first
+- `/mindforge-research-phase 3` — investigate unknowns
+- Review what Phase 2 built
+
+---
+```
+
+### Multiple Equal Options
+
+When there's no clear primary action:
+
+```
+---
+
+## ▶ Next Up
+
+**Phase 3: Core Features** — User dashboard, settings, and data export
+
+**To plan directly:** `/mindforge-plan-phase 3`
+
+**To discuss context first:** `/mindforge-discuss-phase 3`
+
+**To research unknowns:** `/mindforge-research-phase 3`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+```
+
+### Milestone Complete
+
+```
+---
+
+## 🎉 Milestone v1.0 Complete
+
+All 4 phases shipped
+
+## ▶ Next Up
+
+**Start v1.1** — questioning → research → requirements → roadmap
+
+`/mindforge-new-milestone`
+
+<sub>`/clear` first → fresh context window</sub>
+
+---
+```
+
+## Pulling Context
+
+### For phases (from ROADMAP.md):
+
+```markdown
+### Phase 2: Authentication
+**Goal**: JWT login flow with refresh tokens
+```
+
+Extract: `**Phase 2: Authentication** — JWT login flow with refresh tokens`
+
+### For plans (from ROADMAP.md):
+
+```markdown
+Plans:
+- [ ] 02-03: Add refresh token rotation
+```
+
+Or from PLAN.md `<objective>`:
+
+```xml
+<objective>
+Add refresh token rotation with sliding expiry window.
+
+Purpose: Extend session lifetime without compromising security.
+</objective>
+```
+
+Extract: `**02-03: Refresh Token Rotation** — Add /api/auth/refresh with sliding expiry`
+
+## Anti-Patterns
+
+### Don't: Command-only (no context)
+
+```
+## To Continue
+
+Run `/clear`, then paste:
+/mindforge-execute-phase 2
+```
+
+User has no idea what 02-03 is about.
+
+### Don't: Missing /clear explanation
+
+```
+`/mindforge-plan-phase 3`
+
+Run /clear first.
+```
+
+Doesn't explain why. User might skip it.
+
+### Don't: "Other options" language
+
+```
+Other options:
+- Review roadmap
+```
+
+Sounds like an afterthought. Use "Also available:" instead.
+
+### Don't: Fenced code blocks for commands
+
+```
+```
+/mindforge-plan-phase 3
+```
+```
+
+Fenced blocks inside templates create nesting ambiguity. Use inline backticks instead.

package/docs/references/decimal-phase-calculation.md

@@ -0,0 +1,64 @@
+# Decimal Phase Calculation
+
+Calculate the next decimal phase number for urgent insertions.
+
+## Using mindforge-tools
+
+```bash
+# Get next decimal phase after phase 6
+node ".agent/mindforge/bin/mindforge-tools.cjs" phase next-decimal 6
+```
+
+Output:
+```json
+{
+  "found": true,
+  "base_phase": "06",
+  "next": "06.1",
+  "existing": []
+}
+```
+
+With existing decimals:
+```json
+{
+  "found": true,
+  "base_phase": "06",
+  "next": "06.3",
+  "existing": ["06.1", "06.2"]
+}
+```
+
+## Extract Values
+
+```bash
+DECIMAL_PHASE=$(node ".agent/mindforge/bin/mindforge-tools.cjs" phase next-decimal "${AFTER_PHASE}" --pick next)
+BASE_PHASE=$(node ".agent/mindforge/bin/mindforge-tools.cjs" phase next-decimal "${AFTER_PHASE}" --pick base_phase)
+```
+
+Or with --raw flag:
+```bash
+DECIMAL_PHASE=$(node ".agent/mindforge/bin/mindforge-tools.cjs" phase next-decimal "${AFTER_PHASE}" --raw)
+# Returns just: 06.1
+```
+
+## Examples
+
+| Existing Phases | Next Phase |
+|-----------------|------------|
+| 06 only | 06.1 |
+| 06, 06.1 | 06.2 |
+| 06, 06.1, 06.2 | 06.3 |
+| 06, 06.1, 06.3 (gap) | 06.4 |
+
+## Directory Naming
+
+Decimal phase directories use the full decimal number:
+
+```bash
+SLUG=$(node ".agent/mindforge/bin/mindforge-tools.cjs" generate-slug "$DESCRIPTION" --raw)
+PHASE_DIR=".planning/phases/${DECIMAL_PHASE}-${SLUG}"
+mkdir -p "$PHASE_DIR"
+```
+
+Example: `.planning/phases/06.1-fix-critical-auth-bug/`