mindforge-cc 2.1.4 → 2.3.0

package/.agent/workflows/mindforge:status.md

@@ -0,0 +1,107 @@
+---
+description: Display a rich dashboard of the current project state.
+---
+# MindForge — Status Command
+# Usage: /mindforge:status
+
+Display a rich dashboard of the current project state.
+Pull data from STATE.md, AUDIT.jsonl, REQUIREMENTS.md, and the phases directory.
+
+## Dashboard sections
+
+### Section 1 — Project header
+```
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+⚡ MindForge Status — [Project Name]
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+  Last updated : [STATE.md last updated timestamp]
+  Current phase: Phase [N] — [phase description]
+  Status       : [status from STATE.md]
+```
+
+### Section 2 — Phase progress
+```
+Phase Progress
+───────────────────────────────────────────────────────
+  Phase 1  [████████████████████] 100% — Complete ✅
+  Phase 2  [████████░░░░░░░░░░░░]  40% — In progress
+  Phase 3  [░░░░░░░░░░░░░░░░░░░░]   0% — Not started
+  Phase 4  [░░░░░░░░░░░░░░░░░░░░]   0% — Not started
+```
+Calculate percentage from: tasks with SUMMARY files / total tasks in phase.
+Count ONLY SUMMARY files that contain `Status: Completed ✅` (or `Status` + `Completed`).
+Do not count failed tasks as progress.
+If VERIFICATION.md is missing for a phase: label it "In progress" not "0% verified".
+
+### Section 3 — Requirements coverage
+Read REQUIREMENTS.md and count:
+- Total v1 requirements
+- Requirements with a passing test (from VERIFICATION.md files)
+- Requirements implemented but untested
+- Requirements not yet started
+
+```
+Requirements (v1)
+───────────────────────────────────────────────────────
+  Total        : [N]
+  ✅ Done + tested  : [N]
+  ⚠️  Done, no test : [N]
+  🔴 Not started   : [N]
+```
+
+### Section 4 — Recent activity (from AUDIT.jsonl)
+Read the last 10 entries from AUDIT.jsonl and display:
+```
+Recent Activity
+───────────────────────────────────────────────────────
+  [timestamp]  task_completed  Plan 03: User API endpoints ✅
+  [timestamp]  task_completed  Plan 02: Product model ✅
+  [timestamp]  task_started    Plan 03: User API endpoints
+  [timestamp]  task_completed  Plan 01: User model ✅
+  [timestamp]  context_compaction  Phase 2, Plan 03 (72% context)
+```
+If AUDIT.jsonl is empty or missing, display:
+```
+Recent Activity
+───────────────────────────────────────────────────────
+  No activity logged yet. Activity will appear here
+  after running /mindforge:execute-phase.
+```
+
+### Section 5 — Open issues
+Check for:
+- Any open SECURITY-REVIEW files with CRITICAL or HIGH findings
+- Any BUGS.md files with open issues
+- Any failed tasks in WAVE-REPORT files
+- Any blockers in STATE.md
+
+```
+Open Issues
+───────────────────────────────────────────────────────
+  🔴 CRITICAL: [if any — from SECURITY-REVIEW]
+  🟠 HIGH:     [if any]
+  ✅ No open issues
+```
+
+### Section 6 — Next action
+```
+Next Action
+───────────────────────────────────────────────────────
+  [What STATE.md says the next action is]
+  Run: /mindforge:next
+     to auto-execute the next step.
+━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
+```
+
+## Data sources (in priority order)
+1. STATE.md — authoritative for current status
+2. AUDIT.jsonl — authoritative for history
+3. REQUIREMENTS.md — authoritative for scope
+4. VERIFICATION.md files — authoritative for test coverage
+5. WAVE-REPORT files — authoritative for execution history
+6. HANDOFF.json — authoritative for session state
+
+## Performance notes
+- For recent activity, read only the last 500 bytes of AUDIT.jsonl:
+  `tail -c 500 .planning/AUDIT.jsonl | [parse last complete JSON objects]`
+- For requirement counts, count lines starting with `| FR-` instead of parsing the whole file.

package/.agent/workflows/mindforge:steer.md

@@ -0,0 +1,16 @@
+---
+description: Injects mid-execution guidance into the running autonomous engine.
+---
+# /mindforge:steer "[instruction]"
+
+**Purpose**: Injects mid-execution guidance into the running autonomous engine.
+Steering guidance is applied at the next task boundary to course-correct MindForge.
+
+## Usage
+- `/mindforge:steer "Use the new logger in all created files"`
+- `/mindforge:steer --task 3-05 "This plan is too broad, focus on login only"`
+- `/mindforge:steer --cancel` (Clears the steering queue)
+
+## Precedence
+- Steering instructions take precedence over the original `PLAN-N-MM.md` actions.
+- Steering cannot override core security constraints or governance gates.

package/.agent/workflows/mindforge:sync-confluence.md

@@ -0,0 +1,14 @@
+---
+description: Publish approved planning artifacts to Confluence. Usage:
+---
+Publish approved planning artifacts to Confluence. Usage:
+`/mindforge:sync-confluence [--architecture] [--phase N] [--milestone name]`
+
+## Behaviour
+- verify Confluence availability through `connection-manager.md`
+- publish idempotently by existing page title or page ID
+- never publish secrets, raw approval notes, or raw audit logs
+- log success, skip, or failure to AUDIT
+
+Publishing failures are non-fatal and create a pending manual action in
+ `STATE.md`.

package/.agent/workflows/mindforge:sync-jira.md

@@ -0,0 +1,15 @@
+---
+description: Synchronise MindForge phase and plan metadata to Jira. Usage:
+---
+Synchronise MindForge phase and plan metadata to Jira. Usage:
+`/mindforge:sync-jira [--phase N] [--plan M]`
+
+## Behaviour
+- verify Jira availability through `connection-manager.md`
+- create or update Epic and Story mappings in `.planning/jira-sync.json`
+- use dynamic transition lookup, never hardcoded IDs
+- preserve manual Jira edits
+- log all actions to AUDIT
+
+Integration failures are non-fatal and should be written to `STATE.md` for
+ manual retry.

package/.agent/workflows/mindforge:tokens.md

@@ -0,0 +1,11 @@
+---
+description: Display token consumption profile and efficiency analysis.
+---
+# MindForge — Token Usage Command
+# Usage: /mindforge:tokens [--phase N] [--session ID] [--window short|medium|long] [--optimise]
+
+## Purpose
+Display token consumption profile and efficiency analysis.
+Helps identify where tokens are being spent and how to reduce waste.
+
+## Default output (no flags — last 5 sessions)

package/.agent/workflows/mindforge:ui-phase.md

@@ -0,0 +1,27 @@
+---
+description: Generate a UI Design Contract (UI-SPEC.md) for the current phase
+---
+<objective>
+Generate a detailed UI design contract (UI-SPEC.md) for a frontend development phase to ensure consistent spacing, typography, color palettes, and accessibility standards before implementation.
+</objective>
+
+<execution_context>
+.claude/commands/mindforge/ui-phase.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS (The phase number [N], optional)
+Configuration: MINDFORGE.md `UI_PHASE_ACCESSIBILITY_STANDARD`
+State: Resolves the phase from STATE.md if N is not provided.
+</context>
+
+<process>
+1. **Identify Phase**: Get the current or targeted phase number.
+2. **Read Inputs**: Read `REQUIREMENTS.md` and `DESIGN_SYSTEM.md`.
+3. **Generate UI-SPEC.md**:
+    - Define component-level spacing and layout for the phase.
+    - Specify required colors and typography from the design system.
+    - List accessibility requirements (WCAG level).
+4. **Finalize**: Write `UI-SPEC.md` to the phase's planning directory or the root `.planning/`.
+5. **Confirm**: Provide a link to the user for review.
+</process>

package/.agent/workflows/mindforge:ui-review.md

@@ -0,0 +1,28 @@
+---
+description: Perform a retroactive visual audit of implemented UI against the DESIGN_SYSTEM.md and UI-SPEC.md
+---
+<objective>
+Perform a retroactive, multi-pillar visual audit of implemented UI features against the defined Design System and UI-SPEC.md to ensure pixel-perfect fidelity and accessibility compliance.
+</objective>
+
+<execution_context>
+.claude/commands/mindforge/ui-review.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS (The phase number [N], optional)
+Sources: `DESIGN_SYSTEM.md`, `UI-SPEC.md`, and the live application UI.
+</context>
+
+<process>
+1. **Identify Target**: Determine the phase to review.
+2. **Audit Application**:
+    - Use the browser tool to inspect the implemented features.
+    - Compare against the `UI-SPEC.md` for spacing, colors, and layout.
+    - Audit for accessibility (ARIA labels, contrast, keyboard navigation).
+3. **Generate UI-REVIEW.md**:
+    - Grade each pillar (Layout, Color, Typography, etc.).
+    - List specific "Needs Work" items.
+    - Provide "Approved" status if all criteria are met.
+4. **Finalize**: Notify the user of the audit results.
+</process>

package/.agent/workflows/mindforge:update.md

@@ -0,0 +1,45 @@
+---
+description: Check for and apply MindForge framework updates in a safe, scope-preserving way.
+---
+# MindForge — Update Command
+# Usage: /mindforge:update [--apply] [--force] [--check] [--skip-changelog]
+
+## Purpose
+Check for and apply MindForge framework updates in a safe, scope-preserving way.
+
+## Execution flow
+
+### 1. Version check
+Execute `bin/updater/self-update.js` `checkAndUpdate()`.
+Always show: current version, latest version, update type (major/minor/patch).
+
+### 2. Changelog display (unless --skip-changelog)
+Fetch and display the relevant CHANGELOG.md section.
+For major updates: prefix with ⚠️ BREAKING CHANGES notice.
+Limit display to 3,000 characters — link to full CHANGELOG for the rest.
+
+### 3. Confirmation gate (unless --apply)
+Without --apply: show update info, stop. Do not modify any files.
+Message: "To apply this update: /mindforge:update --apply"
+
+### 4. Apply (with --apply)
+a. Detect original install scope (local vs global, claude vs antigravity)
+b. Read schema_version from HANDOFF.json (captures current version BEFORE update)
+c. Run `npx mindforge-cc@[latest] --[runtime] --[scope]`
+d. Run migration: `node bin/migrations/migrate.js` with captured schema_version
+e. Run /mindforge:health to verify update succeeded
+
+### 5. Post-update health check
+If health errors: surface them immediately with specific fix instructions.
+Common post-update issue: CLAUDE.md and .agent/CLAUDE.md drifted → auto-repair.
+
+## Error scenarios and recovery
+
+| Error | Recovery |
+|---|---|
+| npm registry unreachable | Message: "Check internet. Manual: npm info mindforge-cc version" |
+| Update download fails | Retry once, then suggest manual: `npx mindforge-cc@latest` |
+| Migration fails | Restored from backup automatically. Run /mindforge:migrate manually. |
+| Install scope detection fails | Prompt user: "Is your install global or local?" |
+
+## AUDIT entry

package/.agent/workflows/mindforge:validate-phase.md

@@ -0,0 +1,25 @@
+---
+description: Audit the current phase for requirement coverage and test gaps
+---
+<objective>
+Audit a completed project phase to ensure every requirement has been addressed and that corresponding automated tests have been implemented and are passing.
+</objective>
+
+<execution_context>
+.claude/commands/mindforge/validate-phase.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS (The phase number [N], optional)
+Knowledge: `STATE.md`, `REQUIREMENTS.md`, and the codebase test suite.
+</context>
+
+<process>
+1. **Identify Phase**: Resolve the targeted phase.
+2. **Cross-reference**:
+    - List all requirements in `REQUIREMENTS.md` marked for this phase.
+    - Verify implementation of each requirement in the code.
+    - Check for the existence of passing tests for each requirement.
+3. **Analyze Gaps**: Identify any "orphaned" requirements or features missing tests.
+4. **Report Findings**: Summarize coverage and call out specific gaps to the user.
+</process>

package/.agent/workflows/mindforge:verify-phase.md

@@ -0,0 +1,65 @@
+---
+description: Human acceptance testing for a completed phase. Usage: /mindforge:verify-phase [N]
+---
+Human acceptance testing for a completed phase. Usage: /mindforge:verify-phase [N]
+
+## Pre-check
+`.planning/phases/[N]/VERIFICATION.md` must exist.
+If it does not: instruct the user to run /mindforge:execute-phase [N] first.
+
+## Step 1 — Extract testable deliverables
+Read REQUIREMENTS.md and the phase PLAN files.
+Generate a list of testable deliverables — things the user can actually check.
+
+Format each as a clear, actionable test instruction:
+"Navigate to /login and submit a form with a valid email and password.
+ You should be redirected to /dashboard within 2 seconds."
+
+## Step 2 — Walk through each deliverable
+Present one at a time. After each:
+"Please test this now and tell me: pass ✅ or fail ❌ — and describe what you saw."
+
+Wait for the user's response before proceeding to the next.
+
+## Step 3 — Handle failures
+If the user reports a failure:
+1. Ask: "What exactly happened? (error message, wrong behaviour, nothing happened)"
+2. Spawn a debug subagent with: the failure description, the relevant PLAN file,
+   and the relevant source files. Instruct it to find the root cause.
+3. Create a fix plan: `.planning/phases/[N]/FIX-PLAN-[N]-[NN].md`
+   using the same XML format as regular plans.
+4. Ask the user: "Fix plan created. Run /mindforge:execute-phase [N] again
+   to apply the fixes?"
+
+## Step 4 — Write UAT record
+Write `.planning/phases/[N]/UAT.md`:
+
+```markdown
+# UAT — Phase [N]
+
+## Tester
+[User name or "developer"]
+
+## Date
+[ISO 8601 date]
+
+## Results
+
+| # | Deliverable                        | Result | Notes                  |
+|---|------------------------------------|--------|------------------------|
+| 1 | [description]                      | ✅     | [what was observed]    |
+| 2 | [description]                      | ❌     | [what went wrong]      |
+
+## Overall status
+All passed ✅ / Issues found — fix plans created ❌
+
+## Sign-off
+[Passed / Pending fixes]
+```
+
+## Step 5 — Update state if all pass
+If all deliverables pass:
+Update STATE.md: phase N = verified and signed off.
+Tell the user:
+"✅ Phase [N] verified and signed off.
+ Run /mindforge:ship [N] to create the release PR."

package/.agent/workflows/mindforge:workspace.md

@@ -0,0 +1,32 @@
+---
+description: Monorepo workspace management.
+---
+# MindForge — Workspace Command
+# Usage: /mindforge:workspace [detect|list|plan phase N|test]
+
+Monorepo workspace management.
+
+## detect
+Run workspace detector from `.mindforge/monorepo/workspace-detector.md`.
+Write WORKSPACE-MANIFEST.json.
+Report: workspace type, packages found, dependency order.
+
+## list
+Read WORKSPACE-MANIFEST.json and display package list:
+```
+Workspace: Turborepo (4 packages)
+  packages/shared    → @myapp/shared   (lib, 0 dependents)
+  apps/api           → @myapp/api      (api, depends on: shared)
+  apps/web           → @myapp/web      (web, depends on: shared, api)
+  apps/mobile        → @myapp/mobile   (mobile, depends on: shared)
+Execution order: shared → api → (web, mobile in parallel)
+```
+
+## plan phase N
+Create a phase plan that spans multiple packages.
+Uses cross-package-planner.md to determine package execution order.
+Each PLAN file includes a `<package>` and `<working-dir>` field.
+
+## test
+Run tests across all packages in dependency order.
+Report per-package test results and aggregate coverage.

package/.agent/workflows/mindforge:workstreams.md

@@ -0,0 +1,27 @@
+---
+description: Manage parallel feature tracks with isolated state
+---
+<objective>
+Enable developers to work on multiple features or bugs concurrently within the same codebase without state collision. Provides isolated tracking for each "workstream".
+</objective>
+
+<execution_context>
+.claude/commands/mindforge/workstreams.md
+</execution_context>
+
+<context>
+Arguments: $ARGUMENTS (Switch subcommand)
+Storage: .planning/workstreams/
+State: Each workstream maintains its own subset of `STATE.md` or a local context file.
+</context>
+
+<process>
+1. **Route Subcommand**:
+    - `list`: Show all active and archived workstreams in `.planning/workstreams/`.
+    - `create <name>`: Initialize a new workstream directory and baseline state.
+    - `switch <name>`: Update the global pointer in `STATE.md` to the targeted workstream.
+    - `status`: Show the current active workstream and its progress.
+2. **Manage Isolation**:
+    - When switching, ensure current work is saved or stashed if necessary.
+3. **Confirm**: Success/Failure status message to user.
+</process>

package/.claude/CLAUDE.md

@@ -569,3 +569,17 @@ After every phase that passes all gates:
 - /mindforge:marketplace — discover and install community skills
 
 ---
+
+
+## 🧠 Knowledge Context (Auto-loaded)
+🧠 Knowledge Base — 5 relevant memories loaded:
+  Preferences  : 1
+  Code patterns: 1
+  Domain       : 3
+### Team Preferences
+- [90% confidence] Use Tailwind: Always use Tailwind for CSS.
+
+### Domain Knowledge
+- Auth with JWT: Secure JWT with httpOnly cookies.
+- Global Tip: Always fix lints.
+- Database SQL: Use indexed columns for fast queries.

package/bin/installer-core.js

@@ -22,6 +22,9 @@ const RUNTIMES = {
     commandsSubdir: 'commands/mindforge',
     entryFile:      'CLAUDE.md',
     supportsSlash:  true,
+    skillsSubdir:   'skills',
+    hooksSubdir:    'hooks',
+    personasSubdir: 'personas',
   },
   antigravity: {
     displayName:    'Antigravity',
@@ -30,6 +33,9 @@ const RUNTIMES = {
     commandsSubdir: 'workflows',
     entryFile:      'CLAUDE.md',
     supportsSlash:  true,
+    skillsSubdir:   'skills',
+    hooksSubdir:    'hooks',
+    personasSubdir: 'personas',
   },
   cursor: {
     displayName:    'Cursor',
@@ -38,6 +44,9 @@ const RUNTIMES = {
     commandsSubdir: 'rules',
     entryFile:      '.cursorrules',
     supportsSlash:  false,
+    skillsSubdir:   'skills',
+    hooksSubdir:    'hooks',
+    personasSubdir: 'personas',
   },
   opencode: {
     displayName:    'OpenCode',
@@ -46,6 +55,9 @@ const RUNTIMES = {
     commandsSubdir: 'commands/mindforge',
     entryFile:      'CLAUDE.md',
     supportsSlash:  true,
+    skillsSubdir:   'skills',
+    hooksSubdir:    'hooks',
+    personasSubdir: 'personas',
   },
   gemini: {
     displayName:    'Gemini CLI',
@@ -54,6 +66,9 @@ const RUNTIMES = {
     commandsSubdir: 'commands/mindforge',
     entryFile:      'GEMINI.md',
     supportsSlash:  true,
+    skillsSubdir:   'skills',
+    hooksSubdir:    'hooks',
+    personasSubdir: 'personas',
   },
   copilot: {
     displayName:    'GitHub Copilot',
@@ -89,6 +104,31 @@ function generateEntryContent(runtime, sourceContent) {
   return sourceContent;
 }
 
+/**
+ * Extract an enterprise-grade description from command markdown.
+ * Prioritizes YAML frontmatter 'description' field, then falls back to first non-empty text.
+ */
+function getCommandDescription(content) {
+  // Check for YAML frontmatter
+  const frontmatterMatch = content.match(/^---\s*\n([\s\S]*?)\n---\s*\n/);
+  if (frontmatterMatch) {
+    const frontmatter = frontmatterMatch[1];
+    const descMatch = frontmatter.match(/^description:\s*(.*)$/m);
+    if (descMatch) return descMatch[1].trim();
+  }
+
+  // Fallback to first non-empty, non-header line
+  const lines = content.split('\n');
+  for (let line of lines) {
+    line = line.trim();
+    if (line && !line.startsWith('#') && !line.startsWith('---')) {
+      return line.length > 100 ? line.substring(0, 97) + '...' : line;
+    }
+  }
+
+  return 'No description available';
+}
+
 // ── File system utilities ─────────────────────────────────────────────────────
 const fsu = {
   exists:     p  => fs.existsSync(p),
@@ -265,8 +305,25 @@ async function install(runtime, scope, options = {}) {
 
   if (dryRun) {
     console.log('\n  Would install:');
-    console.log(`    ${cfg.entryFile} → ${path.join(baseDir, cfg.entryFile)}`);
-    console.log(`    ${fsu.listFiles(src('.claude', 'commands', 'mindforge')).length} commands → ${cmdsDir}`);
+    console.log(`    ${cfg.entryFile.padEnd(12)} → ${path.join(baseDir, cfg.entryFile)}`);
+    
+    const cmdCountStr = `${fsu.listFiles(src('.agent', 'mindforge')).length} commands`.padEnd(12);
+    console.log(`    ${cmdCountStr} → ${cmdsDir}`);
+
+    const assetMappings = [
+      { key: 'skillsSubdir',   src: src('.agent', 'skills'),      label: 'skills' },
+      { key: 'hooksSubdir',    src: src('.agent', 'hooks'),       label: 'hooks' },
+      { key: 'personasSubdir', src: src('.mindforge', 'personas'), label: 'personas' }
+    ];
+
+    assetMappings.forEach(asset => {
+      const subDir = cfg[asset.key];
+      if (subDir && fsu.exists(asset.src)) {
+        const count = fsu.listFiles(asset.src).length;
+        const countStr = `${count} ${asset.label}`.padEnd(12);
+        console.log(`    ${countStr} → ${path.join(baseDir, subDir)}`);
+      }
+    });
     return;
   }
 
@@ -318,43 +375,82 @@ async function install(runtime, scope, options = {}) {
   }
 
   // ── 2. Install commands ─────────────────────────────────────────────────────
-  const cmdSrc = runtime === 'claude'
-    ? src('.claude', 'commands', 'mindforge')
-    : src('.agent', 'mindforge');
+  const cmdSources = [
+    { src: src('.agent', 'mindforge'), namespace: 'mindforge' },
+    { src: src('.agent', 'forge'),     namespace: 'forge' }
+  ];
 
-  if (fsu.exists(cmdSrc)) {
+  if (runtime === 'claude') {
+    // Claude Code specifically looks in .claude/commands/mindforge
+    cmdSources.length = 0;
+    cmdSources.push({ src: src('.claude', 'commands', 'mindforge'), namespace: 'mindforge' });
+  }
+
+  let totalCount = 0;
+  cmdSources.forEach(source => {
+    if (!fsu.exists(source.src)) return;
+
+    const files = fsu.listFiles(source.src).filter(f => f.endsWith('.md'));
+    totalCount += files.length;
     fsu.ensureDir(cmdsDir);
-    const files = fsu.listFiles(cmdSrc).filter(f => f.endsWith('.md'));
-    // Install for specific runtime
+
     files.forEach(f => {
-      const targetName = runtime === 'antigravity' ? `mindforge:${f}` : f;
-      const srcPath = path.join(cmdSrc, f);
+      // Logic for naming: antigravity uses namespace:prefix, others use just the file name
+      const targetName = runtime === 'antigravity' ? `${source.namespace}:${f}` : f;
+      const srcPath = path.join(source.src, f);
       const dstPath = path.join(cmdsDir, targetName);
 
       if (runtime === 'antigravity') {
         const content = fsu.read(srcPath);
-        const firstLine = content.split('\n')[0].trim();
-        // Mandatory Antigravity frontmatter metadata
-        const metadata = `---\ndescription: ${firstLine}\n---\n`;
-        fsu.write(dstPath, metadata + content);
+        const description = getCommandDescription(content);
+        const metadata = `---\ndescription: ${description}\n---\n`;
+        
+        // Strip existing frontmatter from source when injecting into Antigravity
+        const cleanContent = content.replace(/^---\s*\n[\s\S]*?\n---\s*\n/, '');
+        fsu.write(dstPath, metadata + cleanContent);
       } else {
         fsu.copy(srcPath, dstPath);
       }
     });
 
-    // ✨ STANDARD: Mirror to .claude/commands for cross-IDE compatibility (Cursor/Windsurf/Claude Code)
+    // Mirror to .claude/commands for cross-IDE compatibility (Cursor/Windsurf/Claude Code)
     if (scope === 'local' && runtime !== 'claude' && !selfInstall) {
-      const standardCmdDir = path.join(process.cwd(), '.claude', 'commands', 'mindforge');
+      const standardCmdDir = path.join(process.cwd(), '.claude', 'commands', source.namespace);
       fsu.ensureDir(standardCmdDir);
       files.forEach(f => {
-        fsu.copy(path.join(cmdSrc, f), path.join(standardCmdDir, f));
+        fsu.copy(path.join(source.src, f), path.join(standardCmdDir, f));
       });
-      Theme.printResolved(`${c.bold(files.length)} commands (Mirrored to .claude/commands/mindforge/)`);
+    }
+  });
+
+  if (totalCount > 0) {
+    if (scope === 'local' && runtime !== 'claude' && !selfInstall) {
+      Theme.printResolved(`${c.bold(totalCount)} commands (Mirrored to .claude/commands/)`);
     } else {
-      Theme.printResolved(`${c.bold(files.length)} commands`);
+      Theme.printResolved(`${c.bold(totalCount)} commands`);
     }
   }
 
+  // ── 2.1 Install Enterprise Assets (Skills, Hooks, Personas) ─────────────────
+  if (scope === 'local' && !selfInstall) {
+    const assetTypes = [
+      { key: 'skillsSubdir',   src: src('.agent', 'skills'),      label: 'skills' },
+      { key: 'hooksSubdir',    src: src('.agent', 'hooks'),       label: 'hooks' },
+      { key: 'personasSubdir', src: src('.mindforge', 'personas'), label: 'personas' }
+    ];
+
+    assetTypes.forEach(asset => {
+      const subDir = cfg[asset.key];
+      if (subDir && fsu.exists(asset.src)) {
+        const dstDir = path.join(baseDir, subDir);
+        fsu.ensureDir(dstDir);
+        // Use copyDir for the whole directory
+        fsu.copyDir(asset.src, dstDir, { excludePatterns: SENSITIVE_EXCLUDE });
+        Theme.printResolved(`${c.bold(asset.label.padEnd(10))} (Enterprise sync)`);
+      }
+    });
+  }
+
   // ── 3. Framework files (local scope only, non-self-install) ─────────────────
   if (scope === 'local' && !selfInstall) {
     // .mindforge/ — framework engine files

package/bin/wizard/theme.js

@@ -59,7 +59,7 @@ const Theme = {
    */
   printBrandManifest() {
     console.log(`  ${this.colors.dim('│')}`);
-    console.log(`  ${this.colors.dim('│')}  ${this.colors.green('🎉 V2.1.4 IS HERE!')} Welcome to MindForge V2!`);
+    console.log(`  ${this.colors.dim('│')}  ${this.colors.green('🎉 V2.3.0 IS HERE!')} Welcome to MindForge V2!`);
     console.log(`  ${this.colors.dim('│')}`);
     console.log(`  ${this.colors.dim('│')}  ${this.colors.bold('THE PLATFORM VISION:')}`);
     console.log(`  ${this.colors.dim('│')}    - Unified Enterprise Agentic Ecosystem`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mindforge-cc",
-  "version": "2.1.4",
+  "version": "2.3.0",
   "description": "MindForge - Enterprise Agentic Framework for Claude Code and Antigravity",
   "bin": {
     "mindforge-cc": "bin/install.js"