@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.
- package/.claude-plugin/marketplace.json +1 -1
- package/.claude-plugin/plugin.json +1 -1
- package/.cursor-plugin/plugin.json +1 -1
- package/README.md +28 -49
- package/bin/README.md +47 -1
- package/cli/src/installer.js +1 -1
- package/cli/src/lib/cursor-registry.js +10 -0
- package/core/agents/architect.md +21 -9
- package/core/agents/debugger.md +5 -0
- package/core/agents/ops.md +7 -2
- package/core/agents/planner.md +7 -0
- package/core/agents/rca.md +14 -3
- package/core/agents/reviewer.md +1 -0
- package/core/agents/writer.md +6 -0
- package/core/knowledge-base.md +22 -3
- package/core/methodology.md +30 -5
- package/core/shared/condensation.md +27 -17
- package/core/shared/context-verify.md +3 -1
- package/core/shared/cross-skill-dispatch.md +7 -3
- package/core/shared/draft-context-loading.md +3 -0
- package/core/shared/git-report-metadata.md +1 -0
- package/core/shared/graph-query.md +0 -2
- package/core/shared/graph-usage-report.md +1 -1
- package/core/shared/jira-sync.md +10 -6
- package/core/shared/okf-retrieval.md +1 -1
- package/core/shared/parallel-analysis.md +14 -7
- package/core/shared/pattern-learning.md +2 -0
- package/core/shared/template-contract.md +1 -1
- package/core/shared/vcs-commands.md +5 -2
- package/core/templates/ai-context.md +3 -2
- package/core/templates/ai-profile.md +7 -0
- package/core/templates/architecture.md +6 -2
- package/core/templates/discovery.md +1 -1
- package/core/templates/guardrails.md +9 -0
- package/core/templates/hld.md +5 -4
- package/core/templates/intake-questions.md +45 -0
- package/core/templates/jira.md +11 -2
- package/core/templates/lld.md +8 -5
- package/core/templates/okf/concept.md +0 -1
- package/core/templates/product.md +11 -2
- package/core/templates/rca.md +6 -0
- package/core/templates/service-index.md +1 -0
- package/core/templates/spec.md +15 -0
- package/core/templates/tech-stack.md +12 -0
- package/core/templates/workflow.md +20 -0
- package/integrations/agents/AGENTS.md +1272 -292
- package/integrations/copilot/.github/copilot-instructions.md +1272 -292
- package/package.json +1 -1
- package/scripts/fetch-memory-engine.sh +24 -6
- package/scripts/lib.sh +11 -4
- package/scripts/tools/_graph_queries.sh +10 -3
- package/scripts/tools/_lib.sh +33 -11
- package/scripts/tools/check-repo-size.sh +125 -0
- package/scripts/tools/check-skill-line-caps.sh +1 -2
- package/scripts/tools/check-template-noop.sh +0 -1
- package/scripts/tools/classify-files.sh +2 -2
- package/scripts/tools/cycle-detect.sh +16 -8
- package/scripts/tools/fix-whitespace.sh +3 -0
- package/scripts/tools/git-metadata.sh +6 -0
- package/scripts/tools/graph-arch.sh +1 -1
- package/scripts/tools/graph-callers.sh +6 -3
- package/scripts/tools/graph-impact.sh +4 -2
- package/scripts/tools/graph-init.sh +12 -8
- package/scripts/tools/graph-preflight.sh +3 -0
- package/scripts/tools/graph-query.sh +70 -7
- package/scripts/tools/graph-snapshot.sh +29 -5
- package/scripts/tools/hotspot-rank.sh +2 -1
- package/scripts/tools/install-smoke-test.sh +223 -0
- package/scripts/tools/mermaid-from-graph.sh +2 -1
- package/scripts/tools/migrate-track-frontmatter.sh +9 -10
- package/scripts/tools/okf-coverage-check.sh +4 -3
- package/scripts/tools/okf-fix-links.sh +18 -93
- package/scripts/tools/okf-plan-concepts.sh +5 -8
- package/scripts/tools/okf-render-views.sh +19 -14
- package/scripts/tools/okf-validate-quality.sh +13 -2
- package/scripts/tools/okf-validate.sh +13 -2
- package/scripts/tools/parse-git-log.sh +19 -1
- package/scripts/tools/resolve-tools.sh +24 -8
- package/scripts/tools/verify-citations.sh +1 -2
- package/scripts/tools/verify-doc-anchors.sh +13 -33
- package/scripts/tools/verify-graph-binary.sh +13 -3
- package/skills/GRAPH.md +21 -10
- package/skills/adr/SKILL.md +24 -6
- package/skills/assist-review/SKILL.md +2 -1
- package/skills/bughunt/SKILL.md +54 -11
- package/skills/bughunt/references/regression-tests.md +14 -4
- package/skills/change/SKILL.md +19 -9
- package/skills/coverage/SKILL.md +26 -10
- package/skills/debug/SKILL.md +12 -2
- package/skills/decompose/SKILL.md +39 -9
- package/skills/deep-review/SKILL.md +17 -4
- package/skills/deploy-checklist/SKILL.md +9 -2
- package/skills/documentation/SKILL.md +12 -1
- package/skills/draft/SKILL.md +40 -29
- package/skills/draft/context-files.md +8 -1
- package/skills/draft/quality-guide.md +10 -2
- package/skills/graph/SKILL.md +1 -1
- package/skills/impact/SKILL.md +3 -1
- package/skills/implement/SKILL.md +60 -18
- package/skills/incident-response/SKILL.md +5 -2
- package/skills/init/SKILL.md +102 -23
- package/skills/init/references/architecture-spec.md +31 -7
- package/skills/init/references/okf-emitter.md +3 -3
- package/skills/jira/SKILL.md +33 -13
- package/skills/jira/references/review.md +61 -19
- package/skills/learn/SKILL.md +29 -6
- package/skills/new-track/SKILL.md +73 -18
- package/skills/quick-review/SKILL.md +7 -2
- package/skills/revert/SKILL.md +11 -5
- package/skills/review/SKILL.md +123 -24
- package/skills/review/references/zero-setup-mode.md +117 -0
- package/skills/standup/SKILL.md +9 -1
- package/skills/status/SKILL.md +6 -6
- package/skills/tech-debt/SKILL.md +7 -1
- package/skills/testing-strategy/SKILL.md +10 -2
- package/skills/tour/SKILL.md +2 -1
- 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
|
|