@drafthq/draft 3.6.0 → 3.7.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (117) hide show
  1. package/.claude-plugin/marketplace.json +1 -1
  2. package/.claude-plugin/plugin.json +1 -1
  3. package/.cursor-plugin/plugin.json +1 -1
  4. package/README.md +28 -49
  5. package/bin/README.md +47 -1
  6. package/cli/src/installer.js +1 -1
  7. package/cli/src/lib/cursor-registry.js +10 -0
  8. package/core/agents/architect.md +21 -9
  9. package/core/agents/debugger.md +5 -0
  10. package/core/agents/ops.md +7 -2
  11. package/core/agents/planner.md +7 -0
  12. package/core/agents/rca.md +14 -3
  13. package/core/agents/reviewer.md +1 -0
  14. package/core/agents/writer.md +6 -0
  15. package/core/knowledge-base.md +22 -3
  16. package/core/methodology.md +30 -5
  17. package/core/shared/condensation.md +27 -17
  18. package/core/shared/context-verify.md +3 -1
  19. package/core/shared/cross-skill-dispatch.md +7 -3
  20. package/core/shared/draft-context-loading.md +3 -0
  21. package/core/shared/git-report-metadata.md +1 -0
  22. package/core/shared/graph-query.md +0 -2
  23. package/core/shared/graph-usage-report.md +1 -1
  24. package/core/shared/jira-sync.md +10 -6
  25. package/core/shared/okf-retrieval.md +1 -1
  26. package/core/shared/parallel-analysis.md +14 -7
  27. package/core/shared/pattern-learning.md +2 -0
  28. package/core/shared/template-contract.md +1 -1
  29. package/core/shared/vcs-commands.md +5 -2
  30. package/core/templates/ai-context.md +3 -2
  31. package/core/templates/ai-profile.md +7 -0
  32. package/core/templates/architecture.md +6 -2
  33. package/core/templates/discovery.md +1 -1
  34. package/core/templates/guardrails.md +9 -0
  35. package/core/templates/hld.md +5 -4
  36. package/core/templates/intake-questions.md +45 -0
  37. package/core/templates/jira.md +11 -2
  38. package/core/templates/lld.md +8 -5
  39. package/core/templates/okf/concept.md +0 -1
  40. package/core/templates/product.md +11 -2
  41. package/core/templates/rca.md +6 -0
  42. package/core/templates/service-index.md +1 -0
  43. package/core/templates/spec.md +15 -0
  44. package/core/templates/tech-stack.md +12 -0
  45. package/core/templates/workflow.md +20 -0
  46. package/integrations/agents/AGENTS.md +1272 -292
  47. package/integrations/copilot/.github/copilot-instructions.md +1272 -292
  48. package/package.json +1 -1
  49. package/scripts/fetch-memory-engine.sh +24 -6
  50. package/scripts/lib.sh +11 -4
  51. package/scripts/tools/_graph_queries.sh +10 -3
  52. package/scripts/tools/_lib.sh +33 -11
  53. package/scripts/tools/check-repo-size.sh +125 -0
  54. package/scripts/tools/check-skill-line-caps.sh +1 -2
  55. package/scripts/tools/check-template-noop.sh +0 -1
  56. package/scripts/tools/classify-files.sh +2 -2
  57. package/scripts/tools/cycle-detect.sh +16 -8
  58. package/scripts/tools/fix-whitespace.sh +3 -0
  59. package/scripts/tools/git-metadata.sh +6 -0
  60. package/scripts/tools/graph-arch.sh +1 -1
  61. package/scripts/tools/graph-callers.sh +6 -3
  62. package/scripts/tools/graph-impact.sh +4 -2
  63. package/scripts/tools/graph-init.sh +12 -8
  64. package/scripts/tools/graph-preflight.sh +3 -0
  65. package/scripts/tools/graph-query.sh +70 -7
  66. package/scripts/tools/graph-snapshot.sh +29 -5
  67. package/scripts/tools/hotspot-rank.sh +2 -1
  68. package/scripts/tools/install-smoke-test.sh +223 -0
  69. package/scripts/tools/mermaid-from-graph.sh +2 -1
  70. package/scripts/tools/migrate-track-frontmatter.sh +9 -10
  71. package/scripts/tools/okf-coverage-check.sh +4 -3
  72. package/scripts/tools/okf-fix-links.sh +18 -93
  73. package/scripts/tools/okf-plan-concepts.sh +5 -8
  74. package/scripts/tools/okf-render-views.sh +19 -14
  75. package/scripts/tools/okf-validate-quality.sh +13 -2
  76. package/scripts/tools/okf-validate.sh +13 -2
  77. package/scripts/tools/parse-git-log.sh +19 -1
  78. package/scripts/tools/resolve-tools.sh +24 -8
  79. package/scripts/tools/verify-citations.sh +1 -2
  80. package/scripts/tools/verify-doc-anchors.sh +13 -33
  81. package/scripts/tools/verify-graph-binary.sh +13 -3
  82. package/skills/GRAPH.md +21 -10
  83. package/skills/adr/SKILL.md +24 -6
  84. package/skills/assist-review/SKILL.md +2 -1
  85. package/skills/bughunt/SKILL.md +54 -11
  86. package/skills/bughunt/references/regression-tests.md +14 -4
  87. package/skills/change/SKILL.md +19 -9
  88. package/skills/coverage/SKILL.md +26 -10
  89. package/skills/debug/SKILL.md +12 -2
  90. package/skills/decompose/SKILL.md +39 -9
  91. package/skills/deep-review/SKILL.md +17 -4
  92. package/skills/deploy-checklist/SKILL.md +9 -2
  93. package/skills/documentation/SKILL.md +12 -1
  94. package/skills/draft/SKILL.md +40 -29
  95. package/skills/draft/context-files.md +8 -1
  96. package/skills/draft/quality-guide.md +10 -2
  97. package/skills/graph/SKILL.md +1 -1
  98. package/skills/impact/SKILL.md +3 -1
  99. package/skills/implement/SKILL.md +60 -18
  100. package/skills/incident-response/SKILL.md +5 -2
  101. package/skills/init/SKILL.md +102 -23
  102. package/skills/init/references/architecture-spec.md +31 -7
  103. package/skills/init/references/okf-emitter.md +3 -3
  104. package/skills/jira/SKILL.md +33 -13
  105. package/skills/jira/references/review.md +61 -19
  106. package/skills/learn/SKILL.md +29 -6
  107. package/skills/new-track/SKILL.md +73 -18
  108. package/skills/quick-review/SKILL.md +7 -2
  109. package/skills/revert/SKILL.md +11 -5
  110. package/skills/review/SKILL.md +123 -24
  111. package/skills/review/references/zero-setup-mode.md +117 -0
  112. package/skills/standup/SKILL.md +9 -1
  113. package/skills/status/SKILL.md +6 -6
  114. package/skills/tech-debt/SKILL.md +7 -1
  115. package/skills/testing-strategy/SKILL.md +10 -2
  116. package/skills/tour/SKILL.md +2 -1
  117. package/skills/upload/SKILL.md +3 -2
@@ -31,6 +31,7 @@ synced_to_commit: "{FULL_SHA}"
31
31
  **Mode:** [strict | flexible | none]
32
32
 
33
33
  **Coverage Target:**
34
+
34
35
  ```yaml
35
36
  coverage_target: 95 # Minimum coverage percentage (default: 95%)
36
37
  ```
@@ -40,11 +41,13 @@ coverage_target: 95 # Minimum coverage percentage (default: 95%)
40
41
  **Iron Law:** No production code without a failing test first.
41
42
 
42
43
  The Cycle:
44
+
43
45
  1. **RED** - Write failing test, run it, VERIFY it FAILS
44
46
  2. **GREEN** - Write minimum code, run test, VERIFY it PASSES
45
47
  3. **REFACTOR** - Clean up, keep tests green throughout
46
48
 
47
49
  **Red Flags - Delete and Restart if:**
50
+
48
51
  - Code written before test exists
49
52
  - Test passes immediately (testing wrong thing or wrong code)
50
53
  - "Just this once" rationalization
@@ -52,17 +55,20 @@ The Cycle:
52
55
  - Running test mentally instead of actually
53
56
 
54
57
  **Checklist:**
58
+
55
59
  - [ ] Test written and committed BEFORE implementation
56
60
  - [ ] Test fails with expected failure (not syntax error)
57
61
  - [ ] Minimum code to pass (no extra features)
58
62
  - [ ] Refactor preserves green state
59
63
 
60
64
  ### Flexible TDD
65
+
61
66
  - [ ] Tests required but can be written after implementation
62
67
  - [ ] All code must have tests before marking complete
63
68
  - [ ] Refactoring encouraged
64
69
 
65
70
  ### No TDD
71
+
66
72
  - [ ] Tests optional
67
73
  - [ ] Manual verification acceptable
68
74
 
@@ -73,6 +79,7 @@ The Cycle:
73
79
  **Format:** `type(scope): description`
74
80
 
75
81
  ### Types
82
+
76
83
  | Type | Use For |
77
84
  |------|---------|
78
85
  | `feat` | New feature |
@@ -84,10 +91,12 @@ The Cycle:
84
91
  | `chore` | Build, tooling, dependencies |
85
92
 
86
93
  ### Scope
94
+
87
95
  - Use track ID for Draft work: `feat(add-auth): ...`
88
96
  - Use component name otherwise: `fix(api): ...`
89
97
 
90
98
  ### Commit Frequency
99
+
91
100
  - [ ] After each task completion
92
101
  - [ ] At phase boundaries
93
102
  - [ ] End of session
@@ -97,6 +106,7 @@ The Cycle:
97
106
  ## Code Review
98
107
 
99
108
  ### Self-Review Checklist
109
+
100
110
  - [ ] Code follows project style guide
101
111
  - [ ] Tests pass locally
102
112
  - [ ] No console.log or debug statements
@@ -104,6 +114,7 @@ The Cycle:
104
114
  - [ ] Edge cases considered
105
115
 
106
116
  ### Before Marking Task Complete
117
+
107
118
  - [ ] Run linter
108
119
  - [ ] Run tests
109
120
  - [ ] Review diff
@@ -126,11 +137,13 @@ Do not proceed to next phase until verification passes.
126
137
  ## Review Settings
127
138
 
128
139
  ### Auto-Review
140
+
129
141
  - [ ] Auto-review at track completion
130
142
 
131
143
  When enabled, runs `/draft:review track <id>` automatically when `/draft:implement` completes a track.
132
144
 
133
145
  ### Blocking Behavior
146
+
134
147
  - [ ] Block on review failures
135
148
 
136
149
  When enabled, halt track completion if critical (✗) issues found. Requires fixes before marking complete.
@@ -138,6 +151,7 @@ When enabled, halt track completion if critical (✗) issues found. Requires fix
138
151
  When disabled (default), review failures produce warnings only. Issues documented in `draft/tracks/<id>/review-report.md`.
139
152
 
140
153
  ### Review Scope (Stage 1 Automation)
154
+
141
155
  - [x] Architecture conformance
142
156
  - [x] Dead code detection
143
157
  - [x] Dependency cycle detection
@@ -153,17 +167,21 @@ Uncheck categories to skip during validation phase of review. All enabled by def
153
167
  ## Session Management
154
168
 
155
169
  ### Starting a Session
170
+
156
171
  1. Run `/draft:status` to see current state
157
172
  2. Read active track's spec.md and plan.md
158
173
  3. Find current task (marked `[~]` or first `[ ]`)
159
174
 
160
175
  ### Ending a Session
176
+
161
177
  1. Commit any pending changes
162
178
  2. Update plan.md with progress
163
179
  3. Add notes for next session if mid-task
164
180
 
165
181
  ### Context Handoff
182
+
166
183
  If task exceeds 5 iterations:
184
+
167
185
  1. Document current state in plan.md
168
186
  2. Note any discoveries or blockers
169
187
  3. Suggest resumption approach
@@ -173,9 +191,11 @@ If task exceeds 5 iterations:
173
191
  ## Toolchain
174
192
 
175
193
  ### VCS
194
+
176
195
  - [x] git + GitHub Pull Requests
177
196
 
178
197
  ### MCP Auto-Connect (optional)
198
+
179
199
  - [ ] Jira MCP — for ticket linking via `/draft:jira` (preview / create / review)
180
200
  - [ ] Confluence MCP — for design-doc and runbook lookups
181
201