@accelerationguy/accel 1.0.0

package/modules/momentum/package.json

@@ -0,0 +1,42 @@
+{
+  "name": "@accel/momentum",
+  "version": "3.0.1",
+  "description": "Builder's Automated State Engine — workspace orchestration framework for Claude Code",
+  "bin": {
+    "momentum-framework": "bin/install.js"
+  },
+  "files": [
+    "bin",
+    "src/commands",
+    "src/skill",
+    "src/framework",
+    "src/packages",
+    "src/hooks",
+    "src/templates",
+    "schemas",
+    "README.md"
+  ],
+  "keywords": [
+    "claude",
+    "claude-code",
+    "ai",
+    "workspace",
+    "orchestration",
+    "momentum",
+    "data-surfaces",
+    "mcp"
+  ],
+  "author": "Acceleration Guy",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/accelerationguy/accelerate.git"
+  },
+  "bugs": {
+    "url": "https://github.com/accelerationguy/accelerate/issues"
+  },
+  "homepage": "https://github.com/accelerationguy/accelerate#readme",
+  "engines": {
+    "node": ">=16.7.0"
+  }
+}

package/modules/momentum/schemas/entities.schema.json

@@ -0,0 +1,89 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "momentum/entities.schema.json",
+  "title": "Mission Control Entities",
+  "description": "Graph layer for people and organizations with relational links to projects. Not a CRM — no contact info, just identity and relationships.",
+  "type": "object",
+  "required": ["version", "last_modified", "entities"],
+  "properties": {
+    "version": {
+      "type": "integer",
+      "const": 1
+    },
+    "last_modified": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "entities": {
+      "type": "array",
+      "items": { "$ref": "#/$defs/entity" }
+    }
+  },
+  "$defs": {
+    "entity": {
+      "type": "object",
+      "required": ["id", "name", "type", "created_at", "updated_at"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique identifier. Convention: ENT-NNN",
+          "pattern": "^ENT-\\d{3,}$"
+        },
+        "name": {
+          "type": "string",
+          "description": "Display name"
+        },
+        "type": {
+          "type": "string",
+          "enum": ["person", "organization"],
+          "description": "Entity type — person or organization only"
+        },
+        "role": {
+          "type": ["string", "null"],
+          "description": "Primary role or relationship context (e.g. 'owner', 'client', 'partner', 'contractor', 'team member', 'employer')",
+          "default": null
+        },
+        "relations": {
+          "type": "array",
+          "description": "Links to project items in projects.json",
+          "items": {
+            "type": "object",
+            "required": ["project_id", "relationship"],
+            "properties": {
+              "project_id": {
+                "type": "string",
+                "description": "ID from projects.json (INI-NNN, PRJ-NNN, or TSK-NNN)"
+              },
+              "relationship": {
+                "type": "string",
+                "description": "Nature of relationship (e.g. stakeholder, client, owner, partner, contractor, assignee)"
+              }
+            }
+          },
+          "default": []
+        },
+        "notes": {
+          "type": "array",
+          "description": "Timestamped notes about this entity",
+          "items": {
+            "type": "object",
+            "required": ["text", "timestamp"],
+            "properties": {
+              "text": { "type": "string" },
+              "timestamp": { "type": "string", "format": "date-time" }
+            }
+          },
+          "default": []
+        },
+        "created_at": {
+          "type": "string",
+          "format": "date-time"
+        },
+        "updated_at": {
+          "type": "string",
+          "format": "date-time"
+        }
+      }
+    }
+  }
+}

package/modules/momentum/schemas/projects.schema.json

@@ -0,0 +1,221 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "momentum/projects.schema.json",
+  "title": "Mission Control Projects",
+  "description": "Unified project management schema for the Mission Control ecosystem. Supports Initiative > Project > Task hierarchy with flat categories, multi-user assignees, and Drive satellite linkage.",
+  "type": "object",
+  "required": ["version", "workspace", "last_modified", "categories", "items"],
+  "properties": {
+    "version": {
+      "type": "integer",
+      "description": "Schema version for migration compatibility",
+      "const": 1
+    },
+    "workspace": {
+      "type": "string",
+      "description": "Workspace name"
+    },
+    "last_modified": {
+      "type": "string",
+      "format": "date-time",
+      "description": "ISO 8601 timestamp of last modification"
+    },
+    "categories": {
+      "type": "array",
+      "description": "User-defined flat category list. Workspaces define their own categories.",
+      "items": { "type": "string" },
+      "uniqueItems": true
+    },
+    "items": {
+      "type": "array",
+      "description": "All project items (initiatives, projects, tasks) in a flat array with parent_id for hierarchy",
+      "items": { "$ref": "#/$defs/item" }
+    },
+    "archived": {
+      "type": "array",
+      "description": "Completed or closed items preserved for history",
+      "items": { "$ref": "#/$defs/archived_item" }
+    }
+  },
+  "$defs": {
+    "item": {
+      "type": "object",
+      "required": ["id", "title", "type", "status", "priority", "created_at", "updated_at"],
+      "properties": {
+        "id": {
+          "type": "string",
+          "description": "Unique identifier. Convention: INI-NNN for initiatives, PRJ-NNN for projects, TSK-NNN for tasks",
+          "pattern": "^(INI|PRJ|TSK)-\\d{3,}$"
+        },
+        "title": {
+          "type": "string",
+          "description": "Human-readable item title"
+        },
+        "type": {
+          "type": "string",
+          "enum": ["initiative", "project", "task"],
+          "description": "Hierarchy level"
+        },
+        "parent_id": {
+          "type": ["string", "null"],
+          "description": "ID of parent item. null for top-level initiatives. Initiative ID for projects. Project ID for tasks.",
+          "default": null
+        },
+        "status": {
+          "type": "string",
+          "enum": ["backlog", "todo", "in_progress", "blocked", "in_review", "completed", "deferred", "archived"],
+          "description": "Current work status"
+        },
+        "priority": {
+          "type": "string",
+          "enum": ["urgent", "high", "medium", "low", "ongoing"],
+          "description": "Priority level"
+        },
+        "category": {
+          "type": ["string", "null"],
+          "description": "Flat category from the workspace categories list",
+          "default": null
+        },
+        "assignees": {
+          "type": "array",
+          "description": "Array of entity IDs (from entities.json) assigned to this item",
+          "items": { "type": "string" },
+          "default": []
+        },
+        "start_date": {
+          "type": ["string", "null"],
+          "format": "date",
+          "description": "ISO date when work started or is planned to start",
+          "default": null
+        },
+        "due_date": {
+          "type": ["string", "null"],
+          "format": "date",
+          "description": "ISO date deadline",
+          "default": null
+        },
+        "review_by": {
+          "type": ["string", "null"],
+          "format": "date",
+          "description": "Hygiene review date — when to re-evaluate this item. Separate from due_date (hard deadline).",
+          "default": null
+        },
+        "created_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "ISO 8601 timestamp when item was created"
+        },
+        "updated_at": {
+          "type": "string",
+          "format": "date-time",
+          "description": "ISO 8601 timestamp of last update"
+        },
+        "location": {
+          "type": ["string", "null"],
+          "description": "Workspace-relative path to project directory",
+          "default": null
+        },
+        "blocked_by": {
+          "type": ["string", "null"],
+          "description": "Description of what's blocking this item",
+          "default": null
+        },
+        "next": {
+          "type": ["string", "null"],
+          "description": "Next action or step for this item",
+          "default": null
+        },
+        "notes": {
+          "type": "array",
+          "description": "Timestamped notes (from dashboard or Claude sessions)",
+          "items": {
+            "type": "object",
+            "required": ["text", "timestamp"],
+            "properties": {
+              "text": { "type": "string" },
+              "author": { "type": ["string", "null"], "default": null },
+              "timestamp": { "type": "string", "format": "date-time" }
+            }
+          },
+          "default": []
+        },
+        "tags": {
+          "type": "array",
+          "description": "Free-form tags for filtering and search",
+          "items": { "type": "string" },
+          "default": []
+        },
+        "drive": {
+          "type": ["object", "null"],
+          "description": "Drive satellite linkage. Present only for projects managed by Drive.",
+          "properties": {
+            "is_drive_project": { "type": "boolean" },
+            "satellite_name": { "type": "string", "description": "Key in workspace.json satellites" },
+            "milestone": { "type": ["string", "null"], "description": "Current milestone name" },
+            "phase": { "type": ["string", "null"], "description": "Current phase name" },
+            "loop_position": { "type": ["string", "null"], "enum": ["IDLE", "PLAN", "APPLY", "UNIFY", null] },
+            "last_update": { "type": ["string", "null"], "format": "date-time" },
+            "total_phases": { "type": ["integer", "null"] },
+            "completed_phases": { "type": ["integer", "null"] },
+            "total_plans_completed": { "type": ["integer", "null"] },
+            "total_time_hours": { "type": ["number", "null"], "description": "Accumulated execution time" }
+          },
+          "default": null
+        },
+        "relations": {
+          "type": "array",
+          "description": "Relations to entities (stakeholders, clients, orgs)",
+          "items": {
+            "type": "object",
+            "required": ["entity_id", "relationship"],
+            "properties": {
+              "entity_id": { "type": "string", "description": "ID from entities.json" },
+              "relationship": { "type": "string", "description": "e.g. stakeholder, client, owner, partner, contractor" }
+            }
+          },
+          "default": []
+        },
+        "description": {
+          "type": ["string", "null"],
+          "description": "Extended description or context",
+          "default": null
+        },
+        "revenue": {
+          "type": ["object", "null"],
+          "description": "Revenue context for business-critical projects",
+          "properties": {
+            "type": { "type": "string", "enum": ["recurring", "one-time", "retainer", "w2", "none"] },
+            "amount": { "type": ["string", "null"], "description": "Human-readable amount" },
+            "notes": { "type": ["string", "null"], "description": "Brief revenue context" }
+          },
+          "default": null
+        },
+        "dependencies": {
+          "type": "array",
+          "description": "Cross-project dependencies (blocks, requires, informs)",
+          "items": {
+            "type": "object",
+            "required": ["project_id", "type"],
+            "properties": {
+              "project_id": { "type": "string", "description": "ID of the dependency project" },
+              "type": { "type": "string", "enum": ["blocks", "requires", "informs"], "description": "Dependency type" },
+              "notes": { "type": ["string", "null"] }
+            }
+          },
+          "default": []
+        }
+      }
+    },
+    "archived_item": {
+      "type": "object",
+      "required": ["id", "title", "outcome", "archived_at"],
+      "properties": {
+        "id": { "type": "string" },
+        "title": { "type": "string" },
+        "outcome": { "type": "string", "description": "What happened — shipped, killed, absorbed, etc." },
+        "date": { "type": ["string", "null"], "format": "date", "description": "When the outcome occurred" },
+        "archived_at": { "type": "string", "format": "date-time" }
+      }
+    }
+  }
+}

package/modules/momentum/schemas/state.schema.json

@@ -0,0 +1,108 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "momentum/state.schema.json",
+  "title": "Mission Control Workspace State",
+  "description": "Workspace health, drift tracking, groom scheduling, and satellite registry. Replaces STATE.md with machine-readable state.",
+  "type": "object",
+  "required": ["version", "workspace", "groom", "drift", "areas"],
+  "properties": {
+    "version": {
+      "type": "integer",
+      "const": 1
+    },
+    "workspace": {
+      "type": "string",
+      "description": "Workspace name"
+    },
+    "last_modified": {
+      "type": "string",
+      "format": "date-time"
+    },
+    "groom": {
+      "type": "object",
+      "required": ["cadence", "day", "last_groom", "next_groom_due"],
+      "properties": {
+        "cadence": { "type": "string", "enum": ["daily", "weekly", "bi-weekly", "monthly"] },
+        "day": { "type": ["string", "null"], "description": "Day of week for weekly cadence (e.g. friday)" },
+        "last_groom": { "type": ["string", "null"], "format": "date" },
+        "next_groom_due": { "type": ["string", "null"], "format": "date" }
+      }
+    },
+    "drift": {
+      "type": "object",
+      "required": ["score"],
+      "properties": {
+        "score": { "type": "integer", "minimum": 0, "description": "Composite drift score (0 = healthy)" },
+        "indicators": {
+          "type": "object",
+          "properties": {
+            "active_age_days": { "type": "integer", "description": "Days since ACTIVE/projects data last updated" },
+            "backlog_age_days": { "type": "integer", "description": "Days since BACKLOG data last updated" },
+            "backlog_past_review": { "type": "integer", "description": "Count of backlog items past review_by date" },
+            "orphaned_sessions": { "type": "integer", "description": "PSMM sessions with no recent activity" },
+            "untracked_root_files": { "type": "integer", "description": "Files in workspace root not in .gitignore or tracked" },
+            "stale_satellites": { "type": "integer", "description": "Drive satellites with no recent activity" }
+          }
+        }
+      }
+    },
+    "areas": {
+      "type": "object",
+      "description": "Workspace areas with health tracking. Keys are area slugs.",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["type", "description", "paths"],
+        "properties": {
+          "type": { "type": "string", "description": "Area type (e.g. working-memory, directory, config-cross-ref, system-layer)" },
+          "description": { "type": "string" },
+          "paths": { "type": "array", "items": { "type": "string" } },
+          "groom_schedule": { "type": "string", "enum": ["daily", "weekly", "bi-weekly", "monthly"] },
+          "last_touched": { "type": ["string", "null"], "format": "date" },
+          "groom_due": { "type": ["string", "null"], "format": "date" },
+          "status": { "type": "string", "enum": ["current", "stale", "critical"], "default": "current" },
+          "audit": {
+            "type": "object",
+            "properties": {
+              "strategy": { "type": "string", "description": "Audit strategy type (staleness, classify, cross-reference, dead-code, pipeline-status)" },
+              "config": { "type": "object", "description": "Strategy-specific configuration" }
+            }
+          }
+        }
+      }
+    },
+    "satellites": {
+      "type": "object",
+      "description": "Drive project satellites. Keys are project slugs.",
+      "additionalProperties": {
+        "type": "object",
+        "required": ["path", "engine"],
+        "properties": {
+          "path": { "type": "string", "description": "Workspace-relative path to project" },
+          "engine": { "type": "string", "enum": ["drive"], "description": "Build orchestration engine" },
+          "state": { "type": "string", "description": "Path to STATE.md" },
+          "registered": { "type": "string", "format": "date" },
+          "groom_check": { "type": "boolean", "default": true },
+          "last_activity": { "type": ["string", "null"], "format": "date-time" }
+        }
+      }
+    },
+    "vector_hygiene": {
+      "type": "object",
+      "properties": {
+        "proactive": { "type": "boolean", "default": true },
+        "cadence": { "type": "string", "enum": ["weekly", "bi-weekly", "monthly"] },
+        "staleness_threshold_days": { "type": "integer", "default": 60 },
+        "max_rules_per_domain": { "type": "integer", "default": 15 },
+        "last_run": { "type": ["string", "null"], "format": "date" }
+      }
+    },
+    "last_audit": {
+      "type": ["object", "null"],
+      "properties": {
+        "date": { "type": "string", "format": "date" },
+        "phases": { "type": "integer" },
+        "outcome": { "type": "string" }
+      }
+    }
+  }
+}

package/modules/momentum/src/commands/audit-claude-md.md

@@ -0,0 +1,31 @@
+---
+name: momentum:audit-claude-md
+description: Audit CLAUDE.md and generate recommended version
+allowed-tools: [Read, Write, Edit, Glob, Grep, Bash]
+---
+
+<objective>
+Audit the project's CLAUDE.md for completeness, accuracy, and alignment with workspace state. Generate a recommended version.
+
+**When to use:** "audit claude md", "check my claude.md", after major workspace changes.
+</objective>
+
+<execution_context>
+@.claude/skills/momentum/tasks/audit-claude-md.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+
+@CLAUDE.md
+</context>
+
+<process>
+Follow task: @.claude/skills/momentum/tasks/audit-claude-md.md
+</process>
+
+<success_criteria>
+- [ ] Current CLAUDE.md analyzed
+- [ ] Gaps and outdated sections identified
+- [ ] Recommended version generated or changes suggested
+</success_criteria>

package/modules/momentum/src/commands/audit.md

@@ -0,0 +1,33 @@
+---
+name: momentum:audit
+description: Deep workspace optimization
+allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, Agent, AskUserQuestion]
+---
+
+<objective>
+Deep workspace audit — comprehensive optimization across all areas with actionable recommendations.
+
+**When to use:** "audit my workspace", "deep clean", monthly optimization.
+</objective>
+
+<execution_context>
+@.claude/skills/momentum/tasks/audit.md
+@.claude/skills/momentum/context/momentum-principles.md
+@.claude/skills/momentum/frameworks/audit-strategies.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+
+@.accel/momentum/workspace.json
+</context>
+
+<process>
+Follow task: @.claude/skills/momentum/tasks/audit.md
+</process>
+
+<success_criteria>
+- [ ] All areas audited with strategy-specific checks
+- [ ] Findings categorized and prioritized
+- [ ] Actionable recommendations presented
+</success_criteria>

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

@@ -0,0 +1,35 @@
+---
+name: momentum:groom
+description: Weekly workspace maintenance cycle
+allowed-tools: [Read, Write, Edit, Glob, Grep, Bash, AskUserQuestion]
+---
+
+<objective>
+Structured weekly maintenance — review each workspace area, update statuses, archive stale items, reduce drift.
+
+**When to use:** Weekly maintenance, "groom my workspace", "run grooming".
+</objective>
+
+<execution_context>
+@.claude/skills/momentum/tasks/groom.md
+@.claude/skills/momentum/context/momentum-principles.md
+@.claude/skills/momentum/frameworks/audit-strategies.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+
+@.accel/momentum/workspace.json
+@.accel/momentum/STATE.md
+</context>
+
+<process>
+Follow task: @.claude/skills/momentum/tasks/groom.md
+</process>
+
+<success_criteria>
+- [ ] All workspace areas reviewed
+- [ ] Stale items addressed
+- [ ] STATE.md updated with groom results
+- [ ] Drift score recalculated
+</success_criteria>

package/modules/momentum/src/commands/history.md

@@ -0,0 +1,27 @@
+---
+name: momentum:history
+description: Workspace evolution timeline
+allowed-tools: [Read, Glob, Bash]
+---
+
+<objective>
+Show workspace evolution — grooming history, audits, major changes over time.
+
+**When to use:** "workspace history", "show evolution", "what's changed".
+</objective>
+
+<execution_context>
+@.claude/skills/momentum/tasks/history.md
+</execution_context>
+
+<context>
+@.accel/momentum/STATE.md
+</context>
+
+<process>
+Follow task: @.claude/skills/momentum/tasks/history.md
+</process>
+
+<success_criteria>
+- [ ] Timeline of workspace events displayed
+</success_criteria>

package/modules/momentum/src/commands/pulse.md

@@ -0,0 +1,33 @@
+---
+name: momentum:pulse
+description: Daily workspace health briefing
+allowed-tools: [Read, Glob, Grep, Bash]
+---
+
+<objective>
+Workspace health briefing — drift score, stale areas, overdue grooming, quick status.
+
+**When to use:** Session start, "what's the state of my workspace", daily check-in.
+</objective>
+
+<execution_context>
+@.claude/skills/momentum/tasks/pulse.md
+@.claude/skills/momentum/context/momentum-principles.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+
+@.accel/momentum/workspace.json
+@.accel/momentum/STATE.md
+</context>
+
+<process>
+Follow task: @.claude/skills/momentum/tasks/pulse.md
+</process>
+
+<success_criteria>
+- [ ] Drift score calculated and displayed
+- [ ] Stale areas identified
+- [ ] Groom cadence checked
+</success_criteria>

package/modules/momentum/src/commands/scaffold.md

@@ -0,0 +1,33 @@
+---
+name: momentum:scaffold
+description: Set up Momentum in a new workspace
+argument-hint: "[--full]"
+allowed-tools: [Read, Write, Edit, Glob, Bash, AskUserQuestion]
+---
+
+<objective>
+Guided workspace setup — scan, configure, install Momentum infrastructure. Optional --full mode adds operational templates.
+
+**When to use:** First-time Momentum installation, "set up momentum", "scaffold my workspace".
+</objective>
+
+<execution_context>
+@.claude/skills/momentum/tasks/scaffold.md
+@.claude/skills/momentum/templates/workspace-json.md
+@.claude/skills/momentum/templates/state-md.md
+</execution_context>
+
+<context>
+$ARGUMENTS
+</context>
+
+<process>
+Follow task: @.claude/skills/momentum/tasks/scaffold.md
+</process>
+
+<success_criteria>
+- [ ] .accel/momentum/ directory structure created
+- [ ] workspace.json generated from scan
+- [ ] STATE.md initialized
+- [ ] Hooks and MCP servers installed (if --full)
+</success_criteria>