feat(v2.5): command reduction, universal install, and website overhaul

This release introduces major architectural improvements:

1. Command Reduction Plan:
   - Replaced fragmented workflow commands with consolidated parents: '/draft:plan', '/draft:ops', '/draft:docs', and '/draft:integrations'.
   - Total command count scaled from 28 to 32.

2. Phase 0 Graph Build:
   - Added graph analysis as a mandatory precursor (Phase 0) to '/draft:init' 5-phase analysis.

3. Unified Installation Workflow:
   - Created 'scripts/install.sh' as a universal install script for multiple IDE environments.

4. Documentation & Website:
   - Updated CHANGELOG.md for v2.5.0.
   - Overhauled website content ('web/index.html', 'web/what-is-draft/index.html') reflecting the new 32 commands and Phase 0 workflow.
   - Replaced social media sharing text to highlight core features.
   - Integrated Hacker News sharing link across all web footer variations.
   - Refreshed Draft Book command reference table with the latest hierarchy.

Author: Mayur Pise

CHANGELOG.md

@@ -8,6 +8,13 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ## [Unreleased]
 - Ongoing refinements to agent behavior protocols.
 
+## [2.5.0] - 2026-05-17
+
+### Added
+- **Command Reduction Plan** — Introduced canonical parent commands (`/draft:plan`, `/draft:ops`, `/draft:docs`, `/draft:integrations`) to logically group and reduce surface-level command sprawl. The legacy specialist commands are now intelligently routed through these parent entry points.
+- **Phase 0 Graph Build** — The knowledge graph build is now officially Phase 0 of the `/draft:init` workflow, executing before the 5-phase analysis to provide exact module boundaries and dependencies.
+- **Universal Install Script** — A single installation script (`scripts/install.sh`) has been created to unify and simplify the onboarding experience across all supported IDE environments (Claude Code, Cursor, Copilot, Gemini, Antigravity).
+
 ## [2.4.0] - 2026-04-26
 
 ### Added

CLAUDE.md

@@ -4,7 +4,7 @@ This file provides guidance to Claude Code (claude.ai/code) when working with co
 
 ## Repository Overview
 
-Draft is a Claude Code plugin that implements Context-Driven Development methodology. It provides 28 slash commands organized in a two-tier architecture: 4 primary workflow commands (`/draft:init`, `/draft:new-track`, `/draft:implement`, `/draft:review`) with auto-invocation, plus 24 specialist commands for debugging (`/draft:debug`), operations (`/draft:deploy-checklist`, `/draft:incident-response`, `/draft:standup`), quality (`/draft:quick-review`, `/draft:testing-strategy`, `/draft:tech-debt`), authoring (`/draft:documentation`), DX (`/draft:assist-review`, `/draft:impact`, `/draft:tour`), and more (`/draft:status`, `/draft:revert`, `/draft:decompose`, `/draft:coverage`, `/draft:deep-review`, `/draft:bughunt`, `/draft:learn`, `/draft:adr`, `/draft:change`, `/draft:index`, `/draft:jira-preview`, `/draft:jira-create`). Run `/draft` for overview.
+Draft is a Claude Code plugin that implements Context-Driven Development methodology. It now exposes `/draft:plan` as the canonical planning parent command alongside `/draft:init`, `/draft:implement`, and `/draft:review`. The older planning commands (`/draft:new-track`, `/draft:decompose`, `/draft:change`, `/draft:adr`) remain available as specialist modes and compatibility entry points. Run `/draft` for the current command overview.
 
 Draft also ships a **knowledge graph engine** under `graph/` (Node.js + tree-sitter WASM) and **14 deterministic shell helpers** under `scripts/tools/`. Skills are markdown (source of truth, processed by a bash build script into platform-specific integration files for Copilot and Gemini); the graph engine and shell helpers handle mechanical work that markdown can't.
 
@@ -47,7 +47,7 @@ core/agents/*.md          ──┘
 ```
 
 The build script (`scripts/build-integrations.sh`) reads `SKILL_ORDER`, `CORE_FILES`, and `TOOLS` from `scripts/lib.sh` (sourced) and:
-1. Iterates `SKILL_ORDER` (28 skills, order matters)
+1. Iterates `SKILL_ORDER` (order matters)
 2. Validates YAML frontmatter (`name:` and `description:` required)
 3. Validates body format: blank, `# Title`, blank, then content
 4. Extracts body via `extract_body()`, skipping frontmatter

README.md

@@ -46,7 +46,7 @@ Free. No API keys. No paid tier. No vendor lock-in. Catches the 3 bugs you misse
 ```bash
 /plugin marketplace add mayurpise/draft
 /plugin install draft
-/draft:init       # 5-phase codebase analysis (one-time)
+/draft:init       # Graph + 5-phase codebase analysis (one-time)
 /draft:review     # ← run this on every branch before you push
 ```
 
@@ -55,41 +55,43 @@ That's it. Run `/draft` for the full command map.
 <details>
 <summary><strong>Also works with Cursor, GitHub Copilot, Antigravity, and Gemini →</strong></summary>
 
-### Cursor
-Cursor natively supports the `.claude/` plugin structure. Add via *Settings > Rules, Skills, Subagents > Rules > New > Add from Github*:
+You can use the universal installation script to configure Draft for your environment:
+
+### Claude Code (Local Installation)
+If you prefer not to use the marketplace, you can install the plugin locally to your project:
+```bash
+curl -fsSL https://raw.githubusercontent.com/mayurpise/draft/main/scripts/install.sh | bash -s -- --claude
 ```
-https://github.com/mayurpise/draft.git
+
+### Cursor
+```bash
+curl -fsSL https://raw.githubusercontent.com/mayurpise/draft/main/scripts/install.sh | bash -s -- --cursor
 ```
-Then use: `@draft init`, `@draft new-track`, `@draft implement`.
 
 ### GitHub Copilot
 ```bash
-mkdir -p .github && curl -o .github/copilot-instructions.md \
-  https://raw.githubusercontent.com/mayurpise/draft/main/integrations/copilot/.github/copilot-instructions.md
+curl -fsSL https://raw.githubusercontent.com/mayurpise/draft/main/scripts/install.sh | bash -s -- --copilot
 ```
 
 ### Gemini
 ```bash
-curl -o .gemini.md https://raw.githubusercontent.com/mayurpise/draft/main/integrations/gemini/.gemini.md
+curl -fsSL https://raw.githubusercontent.com/mayurpise/draft/main/scripts/install.sh | bash -s -- --gemini
 ```
 
 ### Antigravity IDE
-Draft is used globally by installing skills to a central location:
-1. Clone Draft to `~/.gemini/antigravity/skills/draft`
-2. Configure `~/.gemini.md` to point to the global skills:
-```markdown
-**Skill Locations:**
-The authoritative Draft implementation skills are located at:
-`/Users/mayurpise/.gemini/antigravity/skills/draft/skills`
+```bash
+curl -fsSL https://raw.githubusercontent.com/mayurpise/draft/main/scripts/install.sh | bash -s -- --antigravity
 ```
 
 </details>
 
 ---
 
-## Beyond `/draft:review` — 27 more commands
+## The 7 Core Workflows
 
-`/draft:review` is the wedge. Once Draft has indexed your repo, you also get spec-driven planning, TDD-enforced implementation, exhaustive bug hunting, deep architectural audits, and 23 more commands covering the full development lifecycle.
+Draft provides a complete system for spec-driven planning, TDD-enforced implementation, and operational workflows.
+
+Specialist modes are built in. Advanced review, bug hunting, impact analysis, debugging, and documentation workflows are invoked intelligently through these parent commands.
 
 ---
 
@@ -98,33 +100,15 @@ The authoritative Draft implementation skills are located at:
 | Command | What It Does |
 |---------|--------------|
 | **`/draft`** | Overview, intent mapping, and command reference |
-| **`/draft:init`** | Analyze codebase, create context files + state tracking |
-| **`/draft:index`** | Aggregate monorepo service contexts |
-| **`/draft:new-track`** | Collaborative spec + plan with AI |
-| **`/draft:decompose`** | Module decomposition with dependency mapping |
-| **`/draft:implement`** | TDD workflow with checkpoints |
-| **`/draft:coverage`** | Code coverage report (target 95%+) |
-| **`/draft:review`** | 3-stage review (validation + spec compliance + code quality) |
-| **`/draft:deep-review`** | Enterprise-grade module lifecycle and ACID audit |
-| **`/draft:bughunt`** | Exhaustive 14-dimension defect discovery with taint tracking |
-| **`/draft:learn`** | Discover coding patterns, update guardrails |
-| **`/draft:adr`** | Architecture Decision Records |
-| **`/draft:status`** | Show progress overview |
-| **`/draft:revert`** | Git-aware rollback |
-| **`/draft:change`** | Handle mid-track requirement changes |
-| **`/draft:debug`** | Structured debugging: reproduce, isolate, diagnose, fix |
-| **`/draft:quick-review`** | Lightweight 4-dimension code review |
-| **`/draft:deploy-checklist`** | Pre-deployment verification with rollback triggers |
-| **`/draft:testing-strategy`** | Test plan design with coverage targets |
-| **`/draft:tech-debt`** | Technical debt analysis across 6 dimensions |
-| **`/draft:standup`** | Git activity standup summary (read-only) |
-| **`/draft:incident-response`** | Incident lifecycle: triage, communicate, mitigate, postmortem |
-| **`/draft:documentation`** | Technical docs: readme, runbook, api, onboarding |
-| **`/draft:jira-preview`** | Generate Jira export for review |
-| **`/draft:jira-create`** | Push issues to Jira via MCP |
-| **`/draft:tour`** | Interactive architecture mentorship and codebase walk-through |
-| **`/draft:impact`** | ROI analytics tracking friction and timeline metrics |
-| **`/draft:assist-review`** | Summarize intent and highlight structural PR risks for reviewers |
+| **`/draft:init`** | Analyze codebase, create context files, or route to `refresh`/`index`/`discover` |
+| **`/draft:plan`** | Canonical planning entry point (routes to `new-track`, `decompose`, `change`, `adr`) |
+| **`/draft:implement`** | TDD workflow, routes to `status`, `coverage`, `revert` |
+| **`/draft:review`** | 3-stage review, routes to `quick`, `bughunt`, `deep`, `assist` |
+| **`/draft:ops`** | Operations entry point (routes to `debug`, `deploy-checklist`, `incident-response`, `standup`) |
+| **`/draft:docs`** | Documentation entry point (routes to `documentation`, `testing-strategy`, `tech-debt`, `tour`) |
+| **`/draft:integrations`**| External systems entry point (routes to `jira-preview`, `jira-create`) |
+
+*(Legacy specialist commands remain supported via their canonical parent commands.)*
 
 [See full command reference →](core/methodology.md#command-workflows)
 
@@ -164,9 +148,9 @@ Skills also call into **14 shell helpers** under `scripts/tools/` for mechanical
 ```
 ┌─────────────────────────────────────────────────────────────┐
 │                        /draft:init                          │
-│    5-phase codebase analysis + signal detection + state     │
-│  architecture.md + .ai-context.md + .state/ (freshness,    │
-│                   signals, run memory)                      │
+│  Phase 0: Graph build (module boundaries, impact, cycles)   │
+│  Phase 1-5: Codebase analysis + signal detection + state    │
+│  architecture.md + .ai-context.md + graph/ + .state/        │
 └────────────────────────────┬────────────────────────────────┘
                              │
                              ▼
@@ -204,6 +188,7 @@ product.md       →  "Build a task manager"
 tech-stack.md    →  "React, TypeScript, Tailwind"
 architecture.md  →  Comprehensive: 28 sections + 5 appendices, Mermaid diagrams (source of truth)
 .ai-context.md   →  200-400 lines: condensed from architecture.md (token-optimized AI context)
+graph/           →  knowledge graph artifacts (modules, proto APIs, hotspots)
 .state/          →  freshness hashes, signal classification, run memory (incremental refresh)
 spec.md          →  "Add drag-and-drop reordering"
 plan.md          →  "Phase 1: sortable, Phase 2: persist"