@drafthq/draft 2.8.1 → 2.8.3

package/.claude-plugin/marketplace.json

@@ -12,7 +12,7 @@
       "name": "draft",
       "source": "./",
       "description": "Context-Driven Development: draft specs and plans before implementation. Structured workflows for features and fixes.",
-      "version": "2.8.0",
+      "version": "2.8.3",
       "author": {
         "name": "mayurpise"
       },

package/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "draft",
   "description": "Context-Driven Development: draft specs and plans before implementation. Structured workflows for features and fixes.",
-  "version": "2.8.1",
+  "version": "2.8.3",
   "author": {
     "name": "mayurpise"
   },

package/README.md

@@ -113,9 +113,9 @@ curl -o .gemini.md https://raw.githubusercontent.com/drafthq/draft/main/integrat
 
 ---
 
-## Beyond `/draft:review` — 27 more commands
+## Beyond `/draft:review` — 33 more commands
 
-`/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: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 29 more commands covering the full development lifecycle.
 
 ---
 
@@ -124,6 +124,10 @@ curl -o .gemini.md https://raw.githubusercontent.com/drafthq/draft/main/integrat
 | Command | What It Does |
 |---------|--------------|
 | **`/draft`** | Overview, intent mapping, and command reference |
+| **`/draft:plan`** | Router for planning, architecture, and track management |
+| **`/draft:ops`** | Router for operations, deployment, incident, and lifecycle |
+| **`/draft:docs`** | Router for authoring and documentation workflows |
+| **`/draft:discover`** | Router for discovery, debugging, investigation, and quality |
 | **`/draft:init`** | Analyze codebase, create context files + state tracking |
 | **`/draft:index`** | Aggregate monorepo service contexts |
 | **`/draft:new-track`** | Collaborative spec + plan with AI |
@@ -141,11 +145,13 @@ curl -o .gemini.md https://raw.githubusercontent.com/drafthq/draft/main/integrat
 | **`/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:upload`** | Pre-upload handoff gate (review, HLD, checklist, validators) |
 | **`/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:integrations`** | External system exports and syncs (jira preview / create) |
 | **`/draft:jira`** | Unified Jira workflows (preview / create / review) |
 | **`/draft:tour`** | Interactive architecture mentorship and codebase walk-through |
 | **`/draft:impact`** | ROI analytics tracking friction and timeline metrics |

package/cli/src/installer.js

@@ -11,13 +11,22 @@ function hasBinary(name) {
   return !(r.error && r.error.code === 'ENOENT');
 }
 
+// Per-step ceiling so a stalled network op (e.g. the `git clone` behind
+// `claude plugin marketplace add`) fails loudly with the manual fallback
+// instead of hanging the installer forever. Override with DRAFT_INSTALL_TIMEOUT_MS.
+const STEP_TIMEOUT_MS = Number(process.env.DRAFT_INSTALL_TIMEOUT_MS) || 300000;
+
 function execAction(act, ctx) {
   const printable = `${act.cmd} ${act.args.join(' ')}`;
   log.plan(`${ctx.dryRun ? 'would run' : 'running'}: ${printable}`);
   if (ctx.dryRun) return 0;
-  const r = spawnSync(act.cmd, act.args, { stdio: 'inherit' });
+  const r = spawnSync(act.cmd, act.args, { stdio: 'inherit', timeout: STEP_TIMEOUT_MS });
   if (r.error) {
-    log.error(`failed to run ${act.cmd}: ${r.error.message}`);
+    if (r.error.code === 'ETIMEDOUT') {
+      log.error(`timed out after ${Math.round(STEP_TIMEOUT_MS / 1000)}s: ${printable}`);
+    } else {
+      log.error(`failed to run ${act.cmd}: ${r.error.message}`);
+    }
     return 1;
   }
   return r.status == null ? 1 : r.status;

package/integrations/copilot/.github/copilot-instructions.md.7iDz8X

@@ -0,0 +1,91 @@
+# Draft - Context-Driven Development
+
+You are operating with the Draft methodology for Context-Driven Development.
+
+**Measure twice, code once.**
+
+## Core Workflow
+
+**Context -> Spec & Plan -> Implement**
+
+Every feature follows this lifecycle:
+1. **Setup** - Initialize project context (once per project)
+2. **New Track** - Create specification and plan
+3. **Implement** - Execute tasks with TDD workflow
+4. **Verify** - Confirm acceptance criteria met
+
+## Project Context Files
+
+When `draft/` exists in the project, always consider:
+- `draft/.ai-context.md` - Source of truth for AI agents (dense codebase understanding)
+- `draft/architecture.md` - Human-readable engineering guide (derived from .ai-context.md)
+- `draft/product.md` - Product vision and goals
+- `draft/tech-stack.md` - Technical constraints
+- `draft/workflow.md` - TDD and commit preferences
+- `draft/tracks.md` - Active work items
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `draft` | Show overview and available commands |
+| `draft init` | Initialize project (run once) |
+| `draft index [--init-missing]` | Aggregate monorepo service contexts |
+| `draft new-track <description>` | Create feature/bug track |
+| `draft decompose` | Module decomposition with dependency mapping |
+| `draft implement` | Execute tasks from plan |
+| `draft coverage` | Code coverage report (target 95%+) |
+| `draft bughunt [--track <id>]` | Systematic bug discovery |
+| `draft review [--track <id>]` | Three-stage code review |
+| `draft deep-review [module]` | Exhaustive production-grade module audit |
+| `draft learn [promote\|migrate]` | Discover coding patterns, update guardrails |
+| `draft adr [title]` | Architecture Decision Records |
+| `draft status` | Show progress overview |
+| `draft revert` | Git-aware rollback |
+| `draft change <description>` | Handle mid-track requirement changes |
+| `draft jira-preview [track-id]` | Generate jira-export.md for review |
+| `draft jira-create [track-id]` | Create Jira issues from export via MCP |
+
+## Intent Mapping
+
+Recognize these natural language patterns:
+
+| User Says | Action |
+|-----------|--------|
+| "set up the project" | Run init |
+| "index services", "aggregate context" | Run index |
+| "new feature", "add X" | Create new track |
+| "break into modules", "decompose" | Run decompose |
+| "start implementing" | Execute implement |
+| "check coverage", "test coverage" | Run coverage |
+| "hunt bugs", "find bugs" | Run bug hunt |
+| "review code", "review track", "check quality" | Run review |
+| "deep review", "production audit", "module audit" | Run deep-review |
+| "learn patterns", "update guardrails", "discover conventions" | Run learn |
+| "what's the status" | Show status |
+| "undo", "revert" | Run revert |
+| "requirements changed", "scope changed", "update the spec" | Run change |
+| "preview jira", "export to jira" | Run jira-preview |
+| "create jira", "push to jira" | Run jira-create |
+| "document decision", "create ADR" | Create architecture decision record |
+| "help", "what commands" | Show draft overview |
+| "the plan" | Read active track's plan.md |
+| "the spec" | Read active track's spec.md |
+
+## Tracks
+
+A **track** is a high-level unit of work (feature, bug fix, refactor). Each track contains:
+- `spec.md` - Requirements and acceptance criteria
+- `plan.md` - Phased task breakdown
+- `metadata.json` - Status and timestamps
+
+Located at: `draft/tracks/<track-id>/`
+
+## Status Markers
+
+Recognize and use these throughout plan.md:
+- `[ ]` - Pending
+- `[~]` - In Progress
+- `[x]` - Completed
+- `[!]` - Blocked
+

package/integrations/copilot/.github/copilot-instructions.md.DoBdtd

@@ -0,0 +1,91 @@
+# Draft - Context-Driven Development
+
+You are operating with the Draft methodology for Context-Driven Development.
+
+**Measure twice, code once.**
+
+## Core Workflow
+
+**Context -> Spec & Plan -> Implement**
+
+Every feature follows this lifecycle:
+1. **Setup** - Initialize project context (once per project)
+2. **New Track** - Create specification and plan
+3. **Implement** - Execute tasks with TDD workflow
+4. **Verify** - Confirm acceptance criteria met
+
+## Project Context Files
+
+When `draft/` exists in the project, always consider:
+- `draft/.ai-context.md` - Source of truth for AI agents (dense codebase understanding)
+- `draft/architecture.md` - Human-readable engineering guide (derived from .ai-context.md)
+- `draft/product.md` - Product vision and goals
+- `draft/tech-stack.md` - Technical constraints
+- `draft/workflow.md` - TDD and commit preferences
+- `draft/tracks.md` - Active work items
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `draft` | Show overview and available commands |
+| `draft init` | Initialize project (run once) |
+| `draft index [--init-missing]` | Aggregate monorepo service contexts |
+| `draft new-track <description>` | Create feature/bug track |
+| `draft decompose` | Module decomposition with dependency mapping |
+| `draft implement` | Execute tasks from plan |
+| `draft coverage` | Code coverage report (target 95%+) |
+| `draft bughunt [--track <id>]` | Systematic bug discovery |
+| `draft review [--track <id>]` | Three-stage code review |
+| `draft deep-review [module]` | Exhaustive production-grade module audit |
+| `draft learn [promote\|migrate]` | Discover coding patterns, update guardrails |
+| `draft adr [title]` | Architecture Decision Records |
+| `draft status` | Show progress overview |
+| `draft revert` | Git-aware rollback |
+| `draft change <description>` | Handle mid-track requirement changes |
+| `draft jira-preview [track-id]` | Generate jira-export.md for review |
+| `draft jira-create [track-id]` | Create Jira issues from export via MCP |
+
+## Intent Mapping
+
+Recognize these natural language patterns:
+
+| User Says | Action |
+|-----------|--------|
+| "set up the project" | Run init |
+| "index services", "aggregate context" | Run index |
+| "new feature", "add X" | Create new track |
+| "break into modules", "decompose" | Run decompose |
+| "start implementing" | Execute implement |
+| "check coverage", "test coverage" | Run coverage |
+| "hunt bugs", "find bugs" | Run bug hunt |
+| "review code", "review track", "check quality" | Run review |
+| "deep review", "production audit", "module audit" | Run deep-review |
+| "learn patterns", "update guardrails", "discover conventions" | Run learn |
+| "what's the status" | Show status |
+| "undo", "revert" | Run revert |
+| "requirements changed", "scope changed", "update the spec" | Run change |
+| "preview jira", "export to jira" | Run jira-preview |
+| "create jira", "push to jira" | Run jira-create |
+| "document decision", "create ADR" | Create architecture decision record |
+| "help", "what commands" | Show draft overview |
+| "the plan" | Read active track's plan.md |
+| "the spec" | Read active track's spec.md |
+
+## Tracks
+
+A **track** is a high-level unit of work (feature, bug fix, refactor). Each track contains:
+- `spec.md` - Requirements and acceptance criteria
+- `plan.md` - Phased task breakdown
+- `metadata.json` - Status and timestamps
+
+Located at: `draft/tracks/<track-id>/`
+
+## Status Markers
+
+Recognize and use these throughout plan.md:
+- `[ ]` - Pending
+- `[~]` - In Progress
+- `[x]` - Completed
+- `[!]` - Blocked
+

package/integrations/copilot/.github/copilot-instructions.md.McGoBW

@@ -0,0 +1,122 @@
+# Draft - Context-Driven Development
+
+You are operating with the Draft methodology for Context-Driven Development.
+
+**Measure twice, code once.**
+
+## Core Workflow
+
+**Context -> Spec & Plan -> Implement**
+
+Every feature follows this lifecycle:
+1. **Setup** - Initialize project context (once per project)
+2. **New Track** - Create specification and plan
+3. **Implement** - Execute tasks with TDD workflow
+4. **Verify** - Confirm acceptance criteria met
+
+## Project Context Files
+
+When `draft/` exists in the project, always consider:
+- `draft/.ai-context.md` - Source of truth for AI agents (dense codebase understanding)
+- `draft/.ai-profile.md` - Ultra-compact profile (always loaded, 20-50 lines)
+- `draft/architecture.md` - Human-readable engineering guide (source of truth)
+- `draft/product.md` - Product vision and goals
+- `draft/tech-stack.md` - Technical constraints
+- `draft/workflow.md` - TDD and commit preferences
+- `draft/tracks.md` - Active work items
+- `draft/guardrails.md` - Hard rules and learned patterns
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `draft` | Show overview and available commands |
+| `draft init` | Initialize project (run once) |
+| `draft index [--init-missing]` | Aggregate monorepo service contexts |
+| `draft new-track <description>` | Create feature/bug track |
+| `draft decompose` | Module decomposition with dependency mapping |
+| `draft implement` | Execute tasks from plan |
+| `draft coverage` | Code coverage report (target 95%+) |
+| `draft deploy-checklist [track <id>]` | Pre-deployment verification checklist |
+| `draft bughunt [--track <id>]` | Systematic bug discovery |
+| `draft review [--track <id>]` | Three-stage code review |
+| `draft quick-review [file|pr <number>]` | Lightweight 4-dimension review |
+| `draft deep-review [module]` | Exhaustive production-grade module audit |
+| `draft testing-strategy [track <id>|path]` | Design test strategy with coverage targets |
+| `draft learn [promote\|migrate]` | Discover coding patterns, update guardrails |
+| `draft adr [title]` | Architecture Decision Records |
+| `draft debug [description|track <id>]` | Structured debugging session |
+| `draft standup [date|week|save]` | Generate standup summary |
+| `draft tech-debt [path|track <id>]` | Identify and prioritize tech debt |
+| `draft incident-response [new|update|postmortem]` | Incident management lifecycle |
+| `draft documentation [readme|runbook|api|onboarding]` | Technical documentation |
+| `draft status` | Show progress overview |
+| `draft revert` | Git-aware rollback |
+| `draft change <description>` | Handle mid-track requirement changes |
+| `draft jira-preview [track-id]` | Generate jira-export.md for review |
+| `draft jira-create [track-id]` | Create Jira issues from export via MCP |
+| `draft tour` | Interactive onboarding tour |
+| `draft impact` | Telemetry and analytics insights |
+| `draft assist-review` | Assist human reviewers with architectural risk audit |
+
+## Intent Mapping
+
+Recognize these natural language patterns:
+
+| User Says | Action |
+|-----------|--------|
+| "set up the project" | Run init |
+| "index services", "aggregate context" | Run index |
+| "new feature", "add X" | Create new track |
+| "break into modules", "decompose" | Run decompose |
+| "start implementing" | Execute implement |
+| "check coverage", "test coverage" | Run coverage |
+| "deploy checklist", "pre-deploy check" | Run deploy-checklist |
+| "hunt bugs", "find bugs" | Run bughunt |
+| "review code", "review track", "check quality" | Run review |
+| "quick review", "lightweight review" | Run quick-review |
+| "deep review", "production audit", "module audit" | Run deep-review |
+| "test strategy", "plan tests" | Run testing-strategy |
+| "learn patterns", "update guardrails", "discover conventions" | Run learn |
+| "document decision", "create ADR" | Create architecture decision record |
+| "debug bug", "investigate issue" | Run debug |
+| "standup", "daily summary" | Run standup |
+| "tech debt", "identify debt" | Run tech-debt |
+| "incident", "outage", "postmortem" | Run incident-response |
+| "write docs", "document" | Run documentation |
+| "what's the status" | Show status |
+| "undo", "revert" | Run revert |
+| "requirements changed", "scope changed", "update the spec" | Run change |
+| "preview jira", "export to jira" | Run jira-preview |
+| "create jira", "push to jira" | Run jira-create |
+| "tour", "onboard me" | Run tour |
+| "impact", "analytics" | Run impact |
+| "assist review", "help reviewer" | Run assist-review |
+| "help", "what commands" | Show draft overview |
+| "the plan" | Read active track's plan.md |
+| "the spec" | Read active track's spec.md |
+
+## Tracks
+
+A **track** is a high-level unit of work (feature, bug fix, refactor). Each track contains:
+- `spec.md` - Requirements and acceptance criteria
+- `plan.md` - Phased task breakdown
+- `metadata.json` - Status and timestamps
+
+Located at: `draft/tracks/<track-id>/`
+
+## Status Markers
+
+Recognize and use these throughout plan.md:
+- `[ ]` - Pending
+- `[~]` - In Progress
+- `[x]` - Completed
+- `[!]` - Blocked
+
+
+---
+
+## Init Command
+
+When user says "init draft" or "draft init [refresh]":
+

package/integrations/copilot/.github/copilot-instructions.md.VsPyLB

@@ -0,0 +1,91 @@
+# Draft - Context-Driven Development
+
+You are operating with the Draft methodology for Context-Driven Development.
+
+**Measure twice, code once.**
+
+## Core Workflow
+
+**Context -> Spec & Plan -> Implement**
+
+Every feature follows this lifecycle:
+1. **Setup** - Initialize project context (once per project)
+2. **New Track** - Create specification and plan
+3. **Implement** - Execute tasks with TDD workflow
+4. **Verify** - Confirm acceptance criteria met
+
+## Project Context Files
+
+When `draft/` exists in the project, always consider:
+- `draft/.ai-context.md` - Source of truth for AI agents (dense codebase understanding)
+- `draft/architecture.md` - Human-readable engineering guide (derived from .ai-context.md)
+- `draft/product.md` - Product vision and goals
+- `draft/tech-stack.md` - Technical constraints
+- `draft/workflow.md` - TDD and commit preferences
+- `draft/tracks.md` - Active work items
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `draft` | Show overview and available commands |
+| `draft init` | Initialize project (run once) |
+| `draft index [--init-missing]` | Aggregate monorepo service contexts |
+| `draft new-track <description>` | Create feature/bug track |
+| `draft decompose` | Module decomposition with dependency mapping |
+| `draft implement` | Execute tasks from plan |
+| `draft coverage` | Code coverage report (target 95%+) |
+| `draft bughunt [--track <id>]` | Systematic bug discovery |
+| `draft review [--track <id>]` | Three-stage code review |
+| `draft deep-review [module]` | Exhaustive production-grade module audit |
+| `draft learn [promote\|migrate]` | Discover coding patterns, update guardrails |
+| `draft adr [title]` | Architecture Decision Records |
+| `draft status` | Show progress overview |
+| `draft revert` | Git-aware rollback |
+| `draft change <description>` | Handle mid-track requirement changes |
+| `draft jira-preview [track-id]` | Generate jira-export.md for review |
+| `draft jira-create [track-id]` | Create Jira issues from export via MCP |
+
+## Intent Mapping
+
+Recognize these natural language patterns:
+
+| User Says | Action |
+|-----------|--------|
+| "set up the project" | Run init |
+| "index services", "aggregate context" | Run index |
+| "new feature", "add X" | Create new track |
+| "break into modules", "decompose" | Run decompose |
+| "start implementing" | Execute implement |
+| "check coverage", "test coverage" | Run coverage |
+| "hunt bugs", "find bugs" | Run bug hunt |
+| "review code", "review track", "check quality" | Run review |
+| "deep review", "production audit", "module audit" | Run deep-review |
+| "learn patterns", "update guardrails", "discover conventions" | Run learn |
+| "what's the status" | Show status |
+| "undo", "revert" | Run revert |
+| "requirements changed", "scope changed", "update the spec" | Run change |
+| "preview jira", "export to jira" | Run jira-preview |
+| "create jira", "push to jira" | Run jira-create |
+| "document decision", "create ADR" | Create architecture decision record |
+| "help", "what commands" | Show draft overview |
+| "the plan" | Read active track's plan.md |
+| "the spec" | Read active track's spec.md |
+
+## Tracks
+
+A **track** is a high-level unit of work (feature, bug fix, refactor). Each track contains:
+- `spec.md` - Requirements and acceptance criteria
+- `plan.md` - Phased task breakdown
+- `metadata.json` - Status and timestamps
+
+Located at: `draft/tracks/<track-id>/`
+
+## Status Markers
+
+Recognize and use these throughout plan.md:
+- `[ ]` - Pending
+- `[~]` - In Progress
+- `[x]` - Completed
+- `[!]` - Blocked
+

package/integrations/copilot/.github/copilot-instructions.md.XAVr7D

@@ -0,0 +1,91 @@
+# Draft - Context-Driven Development
+
+You are operating with the Draft methodology for Context-Driven Development.
+
+**Measure twice, code once.**
+
+## Core Workflow
+
+**Context -> Spec & Plan -> Implement**
+
+Every feature follows this lifecycle:
+1. **Setup** - Initialize project context (once per project)
+2. **New Track** - Create specification and plan
+3. **Implement** - Execute tasks with TDD workflow
+4. **Verify** - Confirm acceptance criteria met
+
+## Project Context Files
+
+When `draft/` exists in the project, always consider:
+- `draft/.ai-context.md` - Source of truth for AI agents (dense codebase understanding)
+- `draft/architecture.md` - Human-readable engineering guide (derived from .ai-context.md)
+- `draft/product.md` - Product vision and goals
+- `draft/tech-stack.md` - Technical constraints
+- `draft/workflow.md` - TDD and commit preferences
+- `draft/tracks.md` - Active work items
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `draft` | Show overview and available commands |
+| `draft init` | Initialize project (run once) |
+| `draft index [--init-missing]` | Aggregate monorepo service contexts |
+| `draft new-track <description>` | Create feature/bug track |
+| `draft decompose` | Module decomposition with dependency mapping |
+| `draft implement` | Execute tasks from plan |
+| `draft coverage` | Code coverage report (target 95%+) |
+| `draft bughunt [--track <id>]` | Systematic bug discovery |
+| `draft review [--track <id>]` | Three-stage code review |
+| `draft deep-review [module]` | Exhaustive production-grade module audit |
+| `draft learn [promote\|migrate]` | Discover coding patterns, update guardrails |
+| `draft adr [title]` | Architecture Decision Records |
+| `draft status` | Show progress overview |
+| `draft revert` | Git-aware rollback |
+| `draft change <description>` | Handle mid-track requirement changes |
+| `draft jira-preview [track-id]` | Generate jira-export.md for review |
+| `draft jira-create [track-id]` | Create Jira issues from export via MCP |
+
+## Intent Mapping
+
+Recognize these natural language patterns:
+
+| User Says | Action |
+|-----------|--------|
+| "set up the project" | Run init |
+| "index services", "aggregate context" | Run index |
+| "new feature", "add X" | Create new track |
+| "break into modules", "decompose" | Run decompose |
+| "start implementing" | Execute implement |
+| "check coverage", "test coverage" | Run coverage |
+| "hunt bugs", "find bugs" | Run bug hunt |
+| "review code", "review track", "check quality" | Run review |
+| "deep review", "production audit", "module audit" | Run deep-review |
+| "learn patterns", "update guardrails", "discover conventions" | Run learn |
+| "what's the status" | Show status |
+| "undo", "revert" | Run revert |
+| "requirements changed", "scope changed", "update the spec" | Run change |
+| "preview jira", "export to jira" | Run jira-preview |
+| "create jira", "push to jira" | Run jira-create |
+| "document decision", "create ADR" | Create architecture decision record |
+| "help", "what commands" | Show draft overview |
+| "the plan" | Read active track's plan.md |
+| "the spec" | Read active track's spec.md |
+
+## Tracks
+
+A **track** is a high-level unit of work (feature, bug fix, refactor). Each track contains:
+- `spec.md` - Requirements and acceptance criteria
+- `plan.md` - Phased task breakdown
+- `metadata.json` - Status and timestamps
+
+Located at: `draft/tracks/<track-id>/`
+
+## Status Markers
+
+Recognize and use these throughout plan.md:
+- `[ ]` - Pending
+- `[~]` - In Progress
+- `[x]` - Completed
+- `[!]` - Blocked
+

package/integrations/copilot/.github/copilot-instructions.md.YoFVFa

@@ -0,0 +1,91 @@
+# Draft - Context-Driven Development
+
+You are operating with the Draft methodology for Context-Driven Development.
+
+**Measure twice, code once.**
+
+## Core Workflow
+
+**Context -> Spec & Plan -> Implement**
+
+Every feature follows this lifecycle:
+1. **Setup** - Initialize project context (once per project)
+2. **New Track** - Create specification and plan
+3. **Implement** - Execute tasks with TDD workflow
+4. **Verify** - Confirm acceptance criteria met
+
+## Project Context Files
+
+When `draft/` exists in the project, always consider:
+- `draft/.ai-context.md` - Source of truth for AI agents (dense codebase understanding)
+- `draft/architecture.md` - Human-readable engineering guide (derived from .ai-context.md)
+- `draft/product.md` - Product vision and goals
+- `draft/tech-stack.md` - Technical constraints
+- `draft/workflow.md` - TDD and commit preferences
+- `draft/tracks.md` - Active work items
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `draft` | Show overview and available commands |
+| `draft init` | Initialize project (run once) |
+| `draft index [--init-missing]` | Aggregate monorepo service contexts |
+| `draft new-track <description>` | Create feature/bug track |
+| `draft decompose` | Module decomposition with dependency mapping |
+| `draft implement` | Execute tasks from plan |
+| `draft coverage` | Code coverage report (target 95%+) |
+| `draft bughunt [--track <id>]` | Systematic bug discovery |
+| `draft review [--track <id>]` | Three-stage code review |
+| `draft deep-review [module]` | Exhaustive production-grade module audit |
+| `draft learn [promote\|migrate]` | Discover coding patterns, update guardrails |
+| `draft adr [title]` | Architecture Decision Records |
+| `draft status` | Show progress overview |
+| `draft revert` | Git-aware rollback |
+| `draft change <description>` | Handle mid-track requirement changes |
+| `draft jira-preview [track-id]` | Generate jira-export.md for review |
+| `draft jira-create [track-id]` | Create Jira issues from export via MCP |
+
+## Intent Mapping
+
+Recognize these natural language patterns:
+
+| User Says | Action |
+|-----------|--------|
+| "set up the project" | Run init |
+| "index services", "aggregate context" | Run index |
+| "new feature", "add X" | Create new track |
+| "break into modules", "decompose" | Run decompose |
+| "start implementing" | Execute implement |
+| "check coverage", "test coverage" | Run coverage |
+| "hunt bugs", "find bugs" | Run bug hunt |
+| "review code", "review track", "check quality" | Run review |
+| "deep review", "production audit", "module audit" | Run deep-review |
+| "learn patterns", "update guardrails", "discover conventions" | Run learn |
+| "what's the status" | Show status |
+| "undo", "revert" | Run revert |
+| "requirements changed", "scope changed", "update the spec" | Run change |
+| "preview jira", "export to jira" | Run jira-preview |
+| "create jira", "push to jira" | Run jira-create |
+| "document decision", "create ADR" | Create architecture decision record |
+| "help", "what commands" | Show draft overview |
+| "the plan" | Read active track's plan.md |
+| "the spec" | Read active track's spec.md |
+
+## Tracks
+
+A **track** is a high-level unit of work (feature, bug fix, refactor). Each track contains:
+- `spec.md` - Requirements and acceptance criteria
+- `plan.md` - Phased task breakdown
+- `metadata.json` - Status and timestamps
+
+Located at: `draft/tracks/<track-id>/`
+
+## Status Markers
+
+Recognize and use these throughout plan.md:
+- `[ ]` - Pending
+- `[~]` - In Progress
+- `[x]` - Completed
+- `[!]` - Blocked
+

package/integrations/copilot/.github/copilot-instructions.md.a9DeW0

@@ -0,0 +1,91 @@
+# Draft - Context-Driven Development
+
+You are operating with the Draft methodology for Context-Driven Development.
+
+**Measure twice, code once.**
+
+## Core Workflow
+
+**Context -> Spec & Plan -> Implement**
+
+Every feature follows this lifecycle:
+1. **Setup** - Initialize project context (once per project)
+2. **New Track** - Create specification and plan
+3. **Implement** - Execute tasks with TDD workflow
+4. **Verify** - Confirm acceptance criteria met
+
+## Project Context Files
+
+When `draft/` exists in the project, always consider:
+- `draft/.ai-context.md` - Source of truth for AI agents (dense codebase understanding)
+- `draft/architecture.md` - Human-readable engineering guide (derived from .ai-context.md)
+- `draft/product.md` - Product vision and goals
+- `draft/tech-stack.md` - Technical constraints
+- `draft/workflow.md` - TDD and commit preferences
+- `draft/tracks.md` - Active work items
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `draft` | Show overview and available commands |
+| `draft init` | Initialize project (run once) |
+| `draft index [--init-missing]` | Aggregate monorepo service contexts |
+| `draft new-track <description>` | Create feature/bug track |
+| `draft decompose` | Module decomposition with dependency mapping |
+| `draft implement` | Execute tasks from plan |
+| `draft coverage` | Code coverage report (target 95%+) |
+| `draft bughunt [--track <id>]` | Systematic bug discovery |
+| `draft review [--track <id>]` | Three-stage code review |
+| `draft deep-review [module]` | Exhaustive production-grade module audit |
+| `draft learn [promote\|migrate]` | Discover coding patterns, update guardrails |
+| `draft adr [title]` | Architecture Decision Records |
+| `draft status` | Show progress overview |
+| `draft revert` | Git-aware rollback |
+| `draft change <description>` | Handle mid-track requirement changes |
+| `draft jira-preview [track-id]` | Generate jira-export.md for review |
+| `draft jira-create [track-id]` | Create Jira issues from export via MCP |
+
+## Intent Mapping
+
+Recognize these natural language patterns:
+
+| User Says | Action |
+|-----------|--------|
+| "set up the project" | Run init |
+| "index services", "aggregate context" | Run index |
+| "new feature", "add X" | Create new track |
+| "break into modules", "decompose" | Run decompose |
+| "start implementing" | Execute implement |
+| "check coverage", "test coverage" | Run coverage |
+| "hunt bugs", "find bugs" | Run bug hunt |
+| "review code", "review track", "check quality" | Run review |
+| "deep review", "production audit", "module audit" | Run deep-review |
+| "learn patterns", "update guardrails", "discover conventions" | Run learn |
+| "what's the status" | Show status |
+| "undo", "revert" | Run revert |
+| "requirements changed", "scope changed", "update the spec" | Run change |
+| "preview jira", "export to jira" | Run jira-preview |
+| "create jira", "push to jira" | Run jira-create |
+| "document decision", "create ADR" | Create architecture decision record |
+| "help", "what commands" | Show draft overview |
+| "the plan" | Read active track's plan.md |
+| "the spec" | Read active track's spec.md |
+
+## Tracks
+
+A **track** is a high-level unit of work (feature, bug fix, refactor). Each track contains:
+- `spec.md` - Requirements and acceptance criteria
+- `plan.md` - Phased task breakdown
+- `metadata.json` - Status and timestamps
+
+Located at: `draft/tracks/<track-id>/`
+
+## Status Markers
+
+Recognize and use these throughout plan.md:
+- `[ ]` - Pending
+- `[~]` - In Progress
+- `[x]` - Completed
+- `[!]` - Blocked
+

package/integrations/copilot/.github/copilot-instructions.md.oxQs3B

@@ -0,0 +1,91 @@
+# Draft - Context-Driven Development
+
+You are operating with the Draft methodology for Context-Driven Development.
+
+**Measure twice, code once.**
+
+## Core Workflow
+
+**Context -> Spec & Plan -> Implement**
+
+Every feature follows this lifecycle:
+1. **Setup** - Initialize project context (once per project)
+2. **New Track** - Create specification and plan
+3. **Implement** - Execute tasks with TDD workflow
+4. **Verify** - Confirm acceptance criteria met
+
+## Project Context Files
+
+When `draft/` exists in the project, always consider:
+- `draft/.ai-context.md` - Source of truth for AI agents (dense codebase understanding)
+- `draft/architecture.md` - Human-readable engineering guide (derived from .ai-context.md)
+- `draft/product.md` - Product vision and goals
+- `draft/tech-stack.md` - Technical constraints
+- `draft/workflow.md` - TDD and commit preferences
+- `draft/tracks.md` - Active work items
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `draft` | Show overview and available commands |
+| `draft init` | Initialize project (run once) |
+| `draft index [--init-missing]` | Aggregate monorepo service contexts |
+| `draft new-track <description>` | Create feature/bug track |
+| `draft decompose` | Module decomposition with dependency mapping |
+| `draft implement` | Execute tasks from plan |
+| `draft coverage` | Code coverage report (target 95%+) |
+| `draft bughunt [--track <id>]` | Systematic bug discovery |
+| `draft review [--track <id>]` | Three-stage code review |
+| `draft deep-review [module]` | Exhaustive production-grade module audit |
+| `draft learn [promote\|migrate]` | Discover coding patterns, update guardrails |
+| `draft adr [title]` | Architecture Decision Records |
+| `draft status` | Show progress overview |
+| `draft revert` | Git-aware rollback |
+| `draft change <description>` | Handle mid-track requirement changes |
+| `draft jira-preview [track-id]` | Generate jira-export.md for review |
+| `draft jira-create [track-id]` | Create Jira issues from export via MCP |
+
+## Intent Mapping
+
+Recognize these natural language patterns:
+
+| User Says | Action |
+|-----------|--------|
+| "set up the project" | Run init |
+| "index services", "aggregate context" | Run index |
+| "new feature", "add X" | Create new track |
+| "break into modules", "decompose" | Run decompose |
+| "start implementing" | Execute implement |
+| "check coverage", "test coverage" | Run coverage |
+| "hunt bugs", "find bugs" | Run bug hunt |
+| "review code", "review track", "check quality" | Run review |
+| "deep review", "production audit", "module audit" | Run deep-review |
+| "learn patterns", "update guardrails", "discover conventions" | Run learn |
+| "what's the status" | Show status |
+| "undo", "revert" | Run revert |
+| "requirements changed", "scope changed", "update the spec" | Run change |
+| "preview jira", "export to jira" | Run jira-preview |
+| "create jira", "push to jira" | Run jira-create |
+| "document decision", "create ADR" | Create architecture decision record |
+| "help", "what commands" | Show draft overview |
+| "the plan" | Read active track's plan.md |
+| "the spec" | Read active track's spec.md |
+
+## Tracks
+
+A **track** is a high-level unit of work (feature, bug fix, refactor). Each track contains:
+- `spec.md` - Requirements and acceptance criteria
+- `plan.md` - Phased task breakdown
+- `metadata.json` - Status and timestamps
+
+Located at: `draft/tracks/<track-id>/`
+
+## Status Markers
+
+Recognize and use these throughout plan.md:
+- `[ ]` - Pending
+- `[~]` - In Progress
+- `[x]` - Completed
+- `[!]` - Blocked
+

package/integrations/copilot/.github/copilot-instructions.md.ww33Ly

@@ -0,0 +1,91 @@
+# Draft - Context-Driven Development
+
+You are operating with the Draft methodology for Context-Driven Development.
+
+**Measure twice, code once.**
+
+## Core Workflow
+
+**Context -> Spec & Plan -> Implement**
+
+Every feature follows this lifecycle:
+1. **Setup** - Initialize project context (once per project)
+2. **New Track** - Create specification and plan
+3. **Implement** - Execute tasks with TDD workflow
+4. **Verify** - Confirm acceptance criteria met
+
+## Project Context Files
+
+When `draft/` exists in the project, always consider:
+- `draft/.ai-context.md` - Source of truth for AI agents (dense codebase understanding)
+- `draft/architecture.md` - Human-readable engineering guide (derived from .ai-context.md)
+- `draft/product.md` - Product vision and goals
+- `draft/tech-stack.md` - Technical constraints
+- `draft/workflow.md` - TDD and commit preferences
+- `draft/tracks.md` - Active work items
+
+## Available Commands
+
+| Command | Purpose |
+|---------|---------|
+| `draft` | Show overview and available commands |
+| `draft init` | Initialize project (run once) |
+| `draft index [--init-missing]` | Aggregate monorepo service contexts |
+| `draft new-track <description>` | Create feature/bug track |
+| `draft decompose` | Module decomposition with dependency mapping |
+| `draft implement` | Execute tasks from plan |
+| `draft coverage` | Code coverage report (target 95%+) |
+| `draft bughunt [--track <id>]` | Systematic bug discovery |
+| `draft review [--track <id>]` | Three-stage code review |
+| `draft deep-review [module]` | Exhaustive production-grade module audit |
+| `draft learn [promote\|migrate]` | Discover coding patterns, update guardrails |
+| `draft adr [title]` | Architecture Decision Records |
+| `draft status` | Show progress overview |
+| `draft revert` | Git-aware rollback |
+| `draft change <description>` | Handle mid-track requirement changes |
+| `draft jira-preview [track-id]` | Generate jira-export.md for review |
+| `draft jira-create [track-id]` | Create Jira issues from export via MCP |
+
+## Intent Mapping
+
+Recognize these natural language patterns:
+
+| User Says | Action |
+|-----------|--------|
+| "set up the project" | Run init |
+| "index services", "aggregate context" | Run index |
+| "new feature", "add X" | Create new track |
+| "break into modules", "decompose" | Run decompose |
+| "start implementing" | Execute implement |
+| "check coverage", "test coverage" | Run coverage |
+| "hunt bugs", "find bugs" | Run bug hunt |
+| "review code", "review track", "check quality" | Run review |
+| "deep review", "production audit", "module audit" | Run deep-review |
+| "learn patterns", "update guardrails", "discover conventions" | Run learn |
+| "what's the status" | Show status |
+| "undo", "revert" | Run revert |
+| "requirements changed", "scope changed", "update the spec" | Run change |
+| "preview jira", "export to jira" | Run jira-preview |
+| "create jira", "push to jira" | Run jira-create |
+| "document decision", "create ADR" | Create architecture decision record |
+| "help", "what commands" | Show draft overview |
+| "the plan" | Read active track's plan.md |
+| "the spec" | Read active track's spec.md |
+
+## Tracks
+
+A **track** is a high-level unit of work (feature, bug fix, refactor). Each track contains:
+- `spec.md` - Requirements and acceptance criteria
+- `plan.md` - Phased task breakdown
+- `metadata.json` - Status and timestamps
+
+Located at: `draft/tracks/<track-id>/`
+
+## Status Markers
+
+Recognize and use these throughout plan.md:
+- `[ ]` - Pending
+- `[~]` - In Progress
+- `[x]` - Completed
+- `[!]` - Blocked
+

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@drafthq/draft",
-  "version": "2.8.1",
+  "version": "2.8.3",
   "description": "Context-Driven Development for AI coding agents — install Draft into Claude Code, Cursor, Codex, or opencode.",
   "bin": {
     "draft": "cli/bin/draft.js"