@accelerationguy/accel 1.0.0

package/modules/momentum/src/skill/momentum.md

@@ -0,0 +1,111 @@
+---
+name: momentum
+type: suite
+version: 0.1.0
+category: workspace-orchestration
+description: "Builder's Automated State Engine — workspace lifecycle management for Claude Code. Scaffold, audit, groom, and maintain AI builder workspaces. Manage data surfaces for structured context injection. Use when user mentions workspace setup, cleanup, organization, maintenance, grooming, auditing workspace health, surfaces, or Momentum."
+allowed-tools: [Read, Write, Glob, Grep, Edit, Bash, Agent, AskUserQuestion]
+---
+
+<activation>
+
+## What
+Momentum (Builder's Automated State Engine) manages the lifecycle of a Claude Code workspace. It scaffolds new workspaces, audits existing ones, runs structured grooming cycles, and maintains workspace health through automated drift detection.
+
+## When to Use
+- User says "momentum", "workspace", "cleanup", "organize", "audit my workspace", "groom", "surface", "create a surface"
+- User wants to set up a new workspace from scratch
+- User wants to optimize or clean up an existing workspace
+- User asks about workspace health, staleness, or drift
+- Session start hook detects overdue grooming
+- User wants to review workspace evolution history
+
+## Not For
+- Project-level build orchestration (that's Drive)
+- Session-level rule management (that's Vector)
+- Code quality auditing (that's Radar)
+- Skill/tool creation (that's Forge)
+
+</activation>
+
+<persona>
+
+## Role
+Workspace operations engineer. Knows the territory, tracks what's drifting, enforces maintenance cadence. Tactical, not theoretical.
+
+## Style
+- Direct, structured, checklist-driven
+- Presents health dashboards and drift scores
+- Asks focused questions during grooming (voice-friendly)
+- Never skips areas — systematic coverage
+- Recommends, doesn't dictate
+
+## Expertise
+- Workspace architecture and file organization
+- Context document lifecycle (data surfaces, ACTIVE.md, BACKLOG.md)
+- Tool and configuration management
+- Drift detection and prevention patterns
+- Claude Code ecosystem (Drive, Vector, Radar, Forge integration)
+
+</persona>
+
+<commands>
+
+| Command | Description | Routes To |
+|---------|------------|-----------|
+| `/momentum:pulse` | Daily activation — workspace health briefing | `@~/.claude/momentum-framework/tasks/pulse.md` |
+| `/momentum:groom` | Weekly maintenance cycle | `@~/.claude/momentum-framework/tasks/groom.md` |
+| `/momentum:audit` | Deep workspace optimization | `@~/.claude/momentum-framework/tasks/audit.md` |
+| `/momentum:scaffold` | Set up Momentum in a new workspace | `@~/.claude/momentum-framework/tasks/scaffold.md` |
+| `/momentum:status` | Quick health check (one-liner) | `@~/.claude/momentum-framework/tasks/status.md` |
+| `/momentum:history` | Workspace evolution timeline | `@~/.claude/momentum-framework/tasks/history.md` |
+| `/momentum:audit-claude-md` | Audit CLAUDE.md, generate recommended version | `@~/.claude/momentum-framework/tasks/audit-claude-md.md` |
+| `/momentum:vector-hygiene` | Vector domain maintenance and rule review | `@~/.claude/momentum-framework/tasks/vector-hygiene.md` |
+| `/momentum:surface create` | Create a new data surface (guided) | `@~/.claude/momentum-framework/tasks/surface-create.md` |
+| `/momentum:surface convert` | Convert markdown file to data surface | `@~/.claude/momentum-framework/tasks/surface-convert.md` |
+| `/momentum:surface list` | Show all registered surfaces | `@~/.claude/momentum-framework/tasks/surface-list.md` |
+
+</commands>
+
+<routing>
+
+## Always Load
+- `@~/.claude/momentum-framework/context/momentum-principles.md` — Core workspace management principles
+- `@~/.claude/momentum-framework/frameworks/audit-strategies.md` — Reusable audit strategy definitions
+
+## Load on Command
+- `@~/.claude/momentum-framework/tasks/pulse.md` — on `/momentum:pulse`
+- `@~/.claude/momentum-framework/tasks/groom.md` — on `/momentum:groom`
+- `@~/.claude/momentum-framework/tasks/audit.md` — on `/momentum:audit`
+- `@~/.claude/momentum-framework/tasks/scaffold.md` — on `/momentum:scaffold`
+- `@~/.claude/momentum-framework/tasks/status.md` — on `/momentum:status`
+- `@~/.claude/momentum-framework/tasks/history.md` — on `/momentum:history`
+- `@~/.claude/momentum-framework/tasks/vector-hygiene.md` — on `/momentum:vector-hygiene`
+- `@~/.claude/momentum-framework/tasks/surface-create.md` — on `/momentum:surface create`
+- `@~/.claude/momentum-framework/tasks/surface-convert.md` — on `/momentum:surface convert`
+- `@~/.claude/momentum-framework/tasks/surface-list.md` — on `/momentum:surface list`
+
+## Load on Demand
+- `@~/.claude/momentum-framework/templates/workspace-json.md` — When generating workspace.json
+- `@~/.claude/momentum-framework/templates/state-md.md` — When generating STATE.md
+- `@~/.claude/momentum-framework/frameworks/satellite-registration.md` — When handling Drive project registration
+
+</routing>
+
+<greeting>
+
+Momentum loaded. Builder's Automated State Engine.
+
+Available commands:
+- `/momentum:pulse` — What's the state of my workspace?
+- `/momentum:groom` — Run weekly maintenance
+- `/momentum:audit` — Deep optimization session
+- `/momentum:scaffold` — Set up Momentum in a new workspace
+- `/momentum:status` — Quick health check
+- `/momentum:history` — Workspace evolution timeline
+- `/momentum:surface create` — Create a new data surface
+- `/momentum:surface list` — Show registered surfaces
+
+What do you need?
+
+</greeting>

package/modules/momentum/src/tasks/groom.md

@@ -0,0 +1,164 @@
+<purpose>
+Structured weekly maintenance cycle. Walk through each workspace area, review with operator, enforce backlog time-based rules, graduate ready items, and log the groom.
+</purpose>
+
+<user-story>
+As an AI builder, I want a guided workspace maintenance session, so that my context documents stay current, my backlog items graduate when ready, and my workspace doesn't drift.
+</user-story>
+
+<when-to-use>
+- Weekly (on configured groom day)
+- When pulse reports overdue grooming
+- When user says "momentum groom", "let's groom", "workspace maintenance"
+- Entry point routes here via /momentum:groom
+</when-to-use>
+
+<steps>
+
+<step name="assess_scope" priority="first">
+Determine what needs grooming.
+
+1. Read `.accel/momentum/workspace.json` manifest
+2. Read `.accel/momentum/STATE.md` for last groom dates per area
+3. Identify which areas are due for grooming (past their cadence)
+4. Sort by staleness (most overdue first)
+5. Present: "Groom session starting. {N} areas due for review: {list}. Estimated time: {N*5} minutes."
+
+**Wait for operator confirmation before proceeding.**
+</step>
+
+<step name="groom_active">
+Review ACTIVE.md — the working memory for projects and tasks.
+
+1. Read `.accel/momentum/ACTIVE.md`
+2. Present summary: "{N} projects, {N} tasks, last updated {date}"
+3. For each project: "Still active? Status changed? Next action current?"
+4. For each task in TASKS section: "Done? Still in progress? Blocked?"
+5. Close completed tasks (move to DONE/CLOSED with outcome + date)
+6. Ask: "Anything new to add?"
+7. Update timestamp
+
+Voice-friendly: walk through one entry at a time, wait for response.
+</step>
+
+<step name="groom_backlog">
+Review BACKLOG.md — enforce time-based rules AND handle graduation.
+
+**Time-based enforcement:**
+1. For each item, check Added date against review-by threshold:
+   - High priority: 7 days
+   - Medium priority: 14 days
+   - Low priority: 30 days
+2. Items past review-by → surface: "These items need a decision: {list}"
+3. Items past staleness (2x review-by) → "Auto-archiving: {list} (past {N} days without action)"
+4. Process operator decisions on each flagged item
+
+**Graduation check:**
+5. For each remaining item, ask: "Ready to work on any of these?"
+6. If yes — determine destination:
+   - **As a TASK:** Item is bounded, standalone work. Move to ACTIVE.md → TASKS section.
+     Format: `### {Task Name}` with Status, Next, Blocked, Notes fields.
+   - **As a PROJECT:** Item is complex enough to warrant its own project entry.
+     Move to ACTIVE.md under appropriate priority section with full project format.
+   - **Stay in backlog:** Not ready yet. Keep with updated review-by date.
+7. For graduated items: remove from BACKLOG.md, add to ACTIVE.md in correct section
+8. Update BACKLOG.md timestamp
+
+**The graduation question is explicit every groom.** Items don't graduate silently — the operator decides.
+</step>
+
+<step name="groom_directories">
+Review directory-type areas (projects/, clients/, tools/).
+
+For each directory area due for grooming:
+1. List contents
+2. Flag anything that looks orphaned or new since last groom
+3. Ask: "Anything to archive, delete, or reclassify?"
+4. Execute approved changes
+</step>
+
+<step name="groom_satellites">
+Review Drive satellite project health.
+
+1. Read `.accel/momentum/workspace.json` — collect all satellite entries where `groom_check: true`
+2. If no satellites have `groom_check: true` → skip this step silently
+3. For each eligible satellite:
+   a. Read its STATE.md at the path in `satellite.state` (relative to workspace root)
+   b. If STATE.md is missing or unreadable → note as "⚠️ {name}: STATE.md not found"
+   c. Get last activity timestamp:
+      - PRIMARY: read `satellite.last_activity` from workspace.json entry (ISO timestamp written by session-start hook from drive.json)
+      - FALLBACK: if `last_activity` not present in workspace.json, parse "Last activity" line from the satellite's STATE.md
+      - If neither available → note as "⚠️ {name}: cannot determine last activity"
+   d. Parse "Loop Position" section from STATE.md → extract PLAN/APPLY/UNIFY markers (✓ = done, ○ = pending)
+   e. Evaluate health criteria:
+      - **STUCK LOOP**: Loop shows PLAN ✓ APPLY ○ or PLAN ✓ APPLY ✓ UNIFY ○, AND last activity > 7 days ago
+      - **ABANDONED PHASE**: Last activity > 14 days ago AND milestone status is not COMPLETE
+      - **MILESTONE DRIFT**: Milestone marked COMPLETE, loop shows ○ ○ ○ (no new milestone started), AND last activity > 14 days ago
+4. Collect all issues across satellites
+5. If issues found: surface as:
+   ```
+   ⚠️ Satellite health issues:
+     - {satellite-name}: {issue type} (last active: {date})
+   ```
+6. If no issues: output single line "Satellites: all healthy ({N} checked)"
+
+**Report only — do NOT auto-fix.** Operator decides what to do with flagged satellites.
+</step>
+
+<step name="groom_system">
+Review system layer areas (hooks, commands, skills, Vector).
+
+1. Quick scan for obvious dead items
+2. Only flag if something clearly wrong
+3. Ask: "Any system changes to note?"
+4. If Vector hygiene is enabled (workspace.json `vector_hygiene.proactive: true`):
+   - Check `.vector/staging/` for pending proposals
+   - Check rule timestamps for staleness
+   - Surface: "{N} staged proposals, {N} stale rules — run /momentum:vector-hygiene?"
+</step>
+
+<step name="log_groom">
+Record the groom session.
+
+1. Update `.accel/momentum/STATE.md` with new timestamps for all groomed areas
+2. Reset drift score
+3. Write groom summary to `.accel/momentum/grooming/{YYYY}-W{NN}.md`:
+   ```markdown
+   # Groom Summary — Week {NN}, {YYYY}
+
+   **Date:** {YYYY-MM-DD}
+   **Areas Reviewed:** {list}
+   **Drift Score:** {before} → 0
+
+   ## Changes
+   - {what changed}
+
+   ## Graduated from Backlog
+   - {item} → ACTIVE.md TASKS / PROJECT
+
+   ## Archived / Killed
+   - {item} (reason)
+
+   ## Next Groom Due
+   {YYYY-MM-DD}
+   ```
+4. Report: "Groom complete. Drift score: 0. Next groom due: {date}."
+</step>
+
+</steps>
+
+<output>
+Updated workspace state. All due areas reviewed and current. Backlog time-based rules enforced. Ready items graduated. Groom summary logged.
+</output>
+
+<acceptance-criteria>
+- [ ] All overdue areas reviewed with operator
+- [ ] ACTIVE.md and BACKLOG.md timestamps updated
+- [ ] Backlog time-based rules enforced (review-by, staleness)
+- [ ] Graduation question asked explicitly for backlog items
+- [ ] Graduated items properly moved to ACTIVE.md (TASKS or PROJECT)
+- [ ] STATE.md updated with new groom date
+- [ ] Groom summary written to grooming/ directory
+- [ ] Drift score reset to 0
+- [ ] Operator confirmed completion of each area
+</acceptance-criteria>

package/modules/momentum/src/templates/operator.json

@@ -0,0 +1,66 @@
+{
+  "version": 1,
+  "last_updated": null,
+  "hook_active": true,
+  "operator": {
+    "entity_id": null,
+    "name": null
+  },
+  "deep_why": {
+    "layers": [
+      {
+        "level": 1,
+        "question": "Why do you do what you do?",
+        "answer": null
+      },
+      {
+        "level": 2,
+        "question": "But why does that matter?",
+        "answer": null
+      },
+      {
+        "level": 3,
+        "question": "But why?",
+        "answer": null
+      },
+      {
+        "level": 4,
+        "question": "Why does that drive you more than anything else?",
+        "answer": null
+      },
+      {
+        "level": 5,
+        "question": "If everything else was stripped away, what's left?",
+        "answer": null
+      }
+    ],
+    "statement": null,
+    "completed_at": null
+  },
+  "north_star": {
+    "metric": null,
+    "timeframe": null,
+    "rationale": null,
+    "completed_at": null
+  },
+  "key_values": {
+    "values": [],
+    "completed_at": null
+  },
+  "elevator_pitch": {
+    "pitch": null,
+    "floors": {
+      "floor_1": null,
+      "floor_2": null,
+      "floor_3": null,
+      "floor_4": null
+    },
+    "completed_at": null
+  },
+  "surface_vision": {
+    "scenes": [],
+    "summary": null,
+    "completed_at": null
+  },
+  "extensions": {}
+}

package/modules/momentum/src/templates/workspace.json

@@ -0,0 +1,111 @@
+{
+  "workspace": "{workspace-name}",
+  "created": "{YYYY-MM-DD}",
+  "groom_cadence": "weekly",
+  "groom_day": "friday",
+  "areas": {
+    "working-memory": {
+      "type": "working-memory",
+      "description": "Core context documents that AI reads every session",
+      "paths": [
+        ".accel/momentum/data/active.json",
+        ".accel/momentum/data/backlog.json",
+        ".accel/momentum/data/projects.json"
+      ],
+      "groom": "weekly",
+      "audit": {
+        "strategy": "staleness",
+        "config": {
+          "threshold_days": 7
+        }
+      }
+    },
+    "projects": {
+      "type": "directory",
+      "description": "Project documentation and planning",
+      "paths": [
+        "projects/"
+      ],
+      "groom": "monthly",
+      "audit": {
+        "strategy": "classify",
+        "config": {
+          "states": ["active", "archive", "delete"],
+          "archive_path": "projects/_archive/"
+        }
+      }
+    },
+    "tools": {
+      "type": "config-cross-ref",
+      "description": "MCP servers, personal tools, shareable tools",
+      "paths": [
+        "tools/"
+      ],
+      "groom": "monthly",
+      "audit": {
+        "strategy": "cross-reference",
+        "config": {
+          "config_file": ".mcp.json"
+        }
+      }
+    },
+    "system-layer": {
+      "type": "system-layer",
+      "description": "Claude Code commands, hooks, skills, Vector domains",
+      "paths": [
+        ".claude/commands/",
+        ".claude/hooks/",
+        ".claude/skills/",
+        ".vector/"
+      ],
+      "groom": "monthly",
+      "audit": {
+        "strategy": "dead-code",
+        "config": {
+          "reference_check": true
+        }
+      }
+    }
+  },
+  "vector_hygiene": {
+    "proactive": true,
+    "cadence": "monthly",
+    "staleness_threshold_days": 60,
+    "max_rules_per_domain": 15,
+    "last_run": null
+  },
+  "surfaces": {
+    "active": {
+      "file": "data/active.json",
+      "description": "Active work items, projects, and tasks",
+      "hook": true,
+      "silent": true,
+      "schema": {
+        "id_prefix": "ACT",
+        "required_fields": ["title", "status", "priority"],
+        "priority_levels": ["urgent", "high", "medium", "ongoing", "deferred"],
+        "status_values": ["active", "blocked", "deferred", "done", "paused"]
+      }
+    },
+    "backlog": {
+      "file": "data/backlog.json",
+      "description": "Future work queue, ideas, and deferred tasks",
+      "hook": true,
+      "silent": true,
+      "schema": {
+        "id_prefix": "BL",
+        "required_fields": ["title", "priority"],
+        "priority_levels": ["high", "medium", "low"],
+        "time_rules": {
+          "review_by": {
+            "high": 7,
+            "medium": 14,
+            "low": 30
+          },
+          "staleness_multiplier": 2
+        }
+      }
+    }
+  },
+  "satellites": {}
+}

package/modules/momentum/terminal.svg

@@ -0,0 +1,77 @@
+<svg xmlns="http://www.w3.org/2000/svg" viewBox="0 0 740 480" width="740" height="480">
+  <!-- Window shadow -->
+  <rect x="4" y="8" width="736" height="472" rx="12" fill="rgba(0,0,0,0.4)"/>
+
+  <!-- Window background -->
+  <rect width="736" height="472" rx="12" fill="#13131f"/>
+
+  <!-- Title bar -->
+  <rect width="736" height="40" rx="12" fill="#1e1e30"/>
+  <rect y="28" width="736" height="12" fill="#1e1e30"/>
+
+  <!-- Traffic lights -->
+  <circle cx="24" cy="20" r="7" fill="#ff5f57"/>
+  <circle cx="48" cy="20" r="7" fill="#febc2e"/>
+  <circle cx="72" cy="20" r="7" fill="#28c840"/>
+
+  <!-- Terminal label -->
+  <text x="368" y="25" text-anchor="middle" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="12" fill="#4a4a6a">Terminal</text>
+
+  <!-- Prompt line -->
+  <text x="24" y="68" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="13">
+    <tspan fill="#4a4a6a">~ $ </tspan><tspan fill="#c0c0d8">npx @accel/cli --all</tspan>
+  </text>
+
+  <!-- Momentum logo - cyan -->
+  <text x="24" y="96"  fill="#00d8ff" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="13" xml:space="preserve">  ██████╗  █████╗ ███████╗███████╗</text>
+  <text x="24" y="113" fill="#00d8ff" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="13" xml:space="preserve">  ██╔══██╗██╔══██╗██╔════╝██╔════╝</text>
+  <text x="24" y="130" fill="#00d8ff" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="13" xml:space="preserve">  ██████╔╝███████║███████╗█████╗  </text>
+  <text x="24" y="147" fill="#00cfef" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="13" xml:space="preserve">  ██╔══██╗██╔══██║╚════██║██╔══╝  </text>
+  <text x="24" y="164" fill="#00cfef" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="13" xml:space="preserve">  ██████╔╝██║  ██║███████║███████╗</text>
+  <text x="24" y="181" fill="#0099bb" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="13" xml:space="preserve">  ╚═════╝ ╚═╝  ╚═╝╚══════╝╚══════╝</text>
+
+  <!-- Name + version -->
+  <text x="24" y="207" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="13">
+    <tspan fill="#00d8ff" font-weight="bold">Momentum</tspan><tspan fill="#4a4a6a"> v2.3.0</tspan>
+  </text>
+  <text x="24" y="224" fill="#7b8cde" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="13">Builder's Automated State Engine for Claude Code</text>
+
+  <!-- Divider -->
+  <line x1="24" y1="238" x2="712" y2="238" stroke="#1e1e30" stroke-width="1.5"/>
+
+  <!-- Global install -->
+  <text x="24" y="258" fill="#00d8ff" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="13">Installing commands to ~/.claude</text>
+  <text x="24" y="276" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="13">
+    <tspan fill="#4dde80">  +</tspan><tspan fill="#c0c0d8"> commands/momentum/</tspan>
+    <tspan fill="#4a4a6a">   (11 slash commands)</tspan>
+  </text>
+  <text x="24" y="293" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="13">
+    <tspan fill="#4dde80">  +</tspan><tspan fill="#c0c0d8"> skills/momentum/</tspan>
+    <tspan fill="#4a4a6a">       (entry point)</tspan>
+  </text>
+  <text x="24" y="310" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="13">
+    <tspan fill="#4dde80">  +</tspan><tspan fill="#c0c0d8"> accelerate-momentum/</tspan>
+    <tspan fill="#4a4a6a">   (tasks, templates, hooks)</tspan>
+  </text>
+
+  <!-- Workspace install -->
+  <text x="24" y="332" fill="#00d8ff" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="13">Installing workspace layer to .accel/momentum/</text>
+  <text x="24" y="350" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="13">
+    <tspan fill="#4dde80">  +</tspan><tspan fill="#c0c0d8"> .accel/momentum/data/</tspan>
+    <tspan fill="#4a4a6a">    .accel/momentum/hooks/    .accel/momentum/momentum-mcp/    .accel/momentum/vector-mcp/</tspan>
+  </text>
+  <text x="24" y="367" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="13">
+    <tspan fill="#4dde80">  +</tspan><tspan fill="#c0c0d8"> .claude/hooks/</tspan>
+    <tspan fill="#4a4a6a">  (pulse, PSMM, satellite)    .mcp.json</tspan>
+  </text>
+
+  <!-- Done line -->
+  <text x="24" y="395" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="13">
+    <tspan fill="#4dde80">Done!</tspan><tspan fill="#c0c0d8"> Run </tspan><tspan fill="#00d8ff">/momentum:scaffold</tspan><tspan fill="#c0c0d8"> to complete workspace setup.</tspan>
+  </text>
+
+  <!-- Cursor -->
+  <text x="24" y="425" font-family="'SF Mono','Fira Code','Courier New',monospace" font-size="13">
+    <tspan fill="#4a4a6a">~ $ </tspan><tspan fill="#00d8ff">▊</tspan>
+  </text>
+</svg>