specweave 0.6.7 → 0.7.0
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/README.md +1 -1
- package/CLAUDE.md +920 -107
- package/README.md +143 -207
- package/bin/specweave.js +67 -0
- package/dist/adapters/adapter-interface.d.ts +11 -11
- package/dist/adapters/adapter-interface.d.ts.map +1 -1
- package/dist/adapters/adapter-interface.js +1 -1
- package/dist/adapters/adapter-loader.d.ts +1 -2
- package/dist/adapters/adapter-loader.d.ts.map +1 -1
- package/dist/adapters/adapter-loader.js +3 -6
- package/dist/adapters/adapter-loader.js.map +1 -1
- package/dist/adapters/agents-md-generator.d.ts +3 -3
- package/dist/adapters/agents-md-generator.js +3 -3
- package/dist/adapters/generic/adapter.d.ts +2 -2
- package/dist/adapters/generic/adapter.d.ts.map +1 -1
- package/dist/adapters/generic/adapter.js +28 -9
- package/dist/adapters/generic/adapter.js.map +1 -1
- package/dist/cli/commands/abandon.d.ts +13 -0
- package/dist/cli/commands/abandon.d.ts.map +1 -0
- package/dist/cli/commands/abandon.js +15 -0
- package/dist/cli/commands/abandon.js.map +1 -0
- package/dist/cli/commands/init.d.ts.map +1 -1
- package/dist/cli/commands/init.js +141 -40
- package/dist/cli/commands/init.js.map +1 -1
- package/dist/cli/commands/pause.d.ts +13 -0
- package/dist/cli/commands/pause.d.ts.map +1 -0
- package/dist/cli/commands/pause.js +15 -0
- package/dist/cli/commands/pause.js.map +1 -0
- package/dist/cli/commands/qa.d.ts +54 -0
- package/dist/cli/commands/qa.d.ts.map +1 -0
- package/dist/cli/commands/qa.js +98 -0
- package/dist/cli/commands/qa.js.map +1 -0
- package/dist/cli/commands/resume.d.ts +12 -0
- package/dist/cli/commands/resume.d.ts.map +1 -0
- package/dist/cli/commands/resume.js +14 -0
- package/dist/cli/commands/resume.js.map +1 -0
- package/dist/cli/commands/status.d.ts +12 -0
- package/dist/cli/commands/status.d.ts.map +1 -0
- package/dist/cli/commands/status.js +23 -0
- package/dist/cli/commands/status.js.map +1 -0
- package/dist/cli/helpers/issue-tracker/ado.d.ts +57 -0
- package/dist/cli/helpers/issue-tracker/ado.d.ts.map +1 -0
- package/dist/cli/helpers/issue-tracker/ado.js +223 -0
- package/dist/cli/helpers/issue-tracker/ado.js.map +1 -0
- package/dist/cli/helpers/issue-tracker/github.d.ts +65 -0
- package/dist/cli/helpers/issue-tracker/github.d.ts.map +1 -0
- package/dist/cli/helpers/issue-tracker/github.js +284 -0
- package/dist/cli/helpers/issue-tracker/github.js.map +1 -0
- package/dist/cli/helpers/issue-tracker/index.d.ts +22 -0
- package/dist/cli/helpers/issue-tracker/index.d.ts.map +1 -0
- package/dist/cli/helpers/issue-tracker/index.js +270 -0
- package/dist/cli/helpers/issue-tracker/index.js.map +1 -0
- package/dist/cli/helpers/issue-tracker/jira.d.ts +61 -0
- package/dist/cli/helpers/issue-tracker/jira.d.ts.map +1 -0
- package/dist/cli/helpers/issue-tracker/jira.js +265 -0
- package/dist/cli/helpers/issue-tracker/jira.js.map +1 -0
- package/dist/cli/helpers/issue-tracker/types.d.ts +86 -0
- package/dist/cli/helpers/issue-tracker/types.d.ts.map +1 -0
- package/dist/cli/helpers/issue-tracker/types.js +16 -0
- package/dist/cli/helpers/issue-tracker/types.js.map +1 -0
- package/dist/cli/helpers/issue-tracker/utils.d.ts +103 -0
- package/dist/cli/helpers/issue-tracker/utils.d.ts.map +1 -0
- package/dist/cli/helpers/issue-tracker/utils.js +240 -0
- package/dist/cli/helpers/issue-tracker/utils.js.map +1 -0
- package/dist/core/increment/limits.d.ts +68 -0
- package/dist/core/increment/limits.d.ts.map +1 -0
- package/dist/core/increment/limits.js +224 -0
- package/dist/core/increment/limits.js.map +1 -0
- package/dist/core/increment/metadata-manager.d.ts +114 -0
- package/dist/core/increment/metadata-manager.d.ts.map +1 -0
- package/dist/core/increment/metadata-manager.js +320 -0
- package/dist/core/increment/metadata-manager.js.map +1 -0
- package/dist/core/increment/status-commands.d.ts +43 -0
- package/dist/core/increment/status-commands.d.ts.map +1 -0
- package/dist/core/increment/status-commands.js +277 -0
- package/dist/core/increment/status-commands.js.map +1 -0
- package/dist/core/plugin-detector.d.ts +1 -0
- package/dist/core/plugin-detector.d.ts.map +1 -1
- package/dist/core/plugin-detector.js +25 -0
- package/dist/core/plugin-detector.js.map +1 -1
- package/dist/core/qa/qa-runner.d.ts +16 -0
- package/dist/core/qa/qa-runner.d.ts.map +1 -0
- package/dist/core/qa/qa-runner.js +404 -0
- package/dist/core/qa/qa-runner.js.map +1 -0
- package/dist/core/qa/quality-gate-decider.d.ts +53 -0
- package/dist/core/qa/quality-gate-decider.d.ts.map +1 -0
- package/dist/core/qa/quality-gate-decider.js +268 -0
- package/dist/core/qa/quality-gate-decider.js.map +1 -0
- package/dist/core/qa/risk-calculator.d.ts +126 -0
- package/dist/core/qa/risk-calculator.d.ts.map +1 -0
- package/dist/core/qa/risk-calculator.js +247 -0
- package/dist/core/qa/risk-calculator.js.map +1 -0
- package/dist/core/qa/types.d.ts +315 -0
- package/dist/core/qa/types.d.ts.map +1 -0
- package/dist/core/qa/types.js +8 -0
- package/dist/core/qa/types.js.map +1 -0
- package/dist/core/types/config.d.ts +37 -2
- package/dist/core/types/config.d.ts.map +1 -1
- package/dist/core/types/config.js +16 -0
- package/dist/core/types/config.js.map +1 -1
- package/dist/core/types/increment-metadata.d.ts +120 -0
- package/dist/core/types/increment-metadata.d.ts.map +1 -0
- package/dist/core/types/increment-metadata.js +138 -0
- package/dist/core/types/increment-metadata.js.map +1 -0
- package/dist/hooks/lib/invoke-translator-skill.d.ts +60 -0
- package/dist/hooks/lib/invoke-translator-skill.d.ts.map +1 -0
- package/dist/hooks/lib/invoke-translator-skill.js +201 -0
- package/dist/hooks/lib/invoke-translator-skill.js.map +1 -0
- package/dist/hooks/lib/translate-file.d.ts +59 -0
- package/dist/hooks/lib/translate-file.d.ts.map +1 -0
- package/dist/hooks/lib/translate-file.js +350 -0
- package/dist/hooks/lib/translate-file.js.map +1 -0
- package/dist/locales/en/cli.json +3 -1
- package/dist/metrics/calculators/change-failure-rate.d.ts +22 -0
- package/dist/metrics/calculators/change-failure-rate.d.ts.map +1 -0
- package/dist/metrics/calculators/change-failure-rate.js +70 -0
- package/dist/metrics/calculators/change-failure-rate.js.map +1 -0
- package/dist/metrics/calculators/deployment-frequency.d.ts +20 -0
- package/dist/metrics/calculators/deployment-frequency.d.ts.map +1 -0
- package/dist/metrics/calculators/deployment-frequency.js +61 -0
- package/dist/metrics/calculators/deployment-frequency.js.map +1 -0
- package/dist/metrics/calculators/lead-time.d.ts +22 -0
- package/dist/metrics/calculators/lead-time.d.ts.map +1 -0
- package/dist/metrics/calculators/lead-time.js +82 -0
- package/dist/metrics/calculators/lead-time.js.map +1 -0
- package/dist/metrics/calculators/mttr.d.ts +21 -0
- package/dist/metrics/calculators/mttr.d.ts.map +1 -0
- package/dist/metrics/calculators/mttr.js +60 -0
- package/dist/metrics/calculators/mttr.js.map +1 -0
- package/dist/metrics/dora-calculator.d.ts +24 -0
- package/dist/metrics/dora-calculator.d.ts.map +1 -0
- package/dist/metrics/dora-calculator.js +104 -0
- package/dist/metrics/dora-calculator.js.map +1 -0
- package/dist/metrics/github-client.d.ts +51 -0
- package/dist/metrics/github-client.d.ts.map +1 -0
- package/dist/metrics/github-client.js +133 -0
- package/dist/metrics/github-client.js.map +1 -0
- package/dist/metrics/types.d.ts +112 -0
- package/dist/metrics/types.d.ts.map +1 -0
- package/dist/metrics/types.js +10 -0
- package/dist/metrics/types.js.map +1 -0
- package/dist/metrics/utils/percentile.d.ts +25 -0
- package/dist/metrics/utils/percentile.d.ts.map +1 -0
- package/dist/metrics/utils/percentile.js +46 -0
- package/dist/metrics/utils/percentile.js.map +1 -0
- package/dist/metrics/utils/tier-classifier.d.ts +61 -0
- package/dist/metrics/utils/tier-classifier.d.ts.map +1 -0
- package/dist/metrics/utils/tier-classifier.js +100 -0
- package/dist/metrics/utils/tier-classifier.js.map +1 -0
- package/dist/utils/auth-helpers.d.ts +58 -0
- package/dist/utils/auth-helpers.d.ts.map +1 -0
- package/dist/utils/auth-helpers.js +108 -0
- package/dist/utils/auth-helpers.js.map +1 -0
- package/dist/utils/env-file.d.ts +88 -0
- package/dist/utils/env-file.d.ts.map +1 -0
- package/dist/utils/env-file.js +180 -0
- package/dist/utils/env-file.js.map +1 -0
- package/dist/utils/plugin-detection.d.ts +50 -0
- package/dist/utils/plugin-detection.d.ts.map +1 -0
- package/dist/utils/plugin-detection.js +229 -0
- package/dist/utils/plugin-detection.js.map +1 -0
- package/dist/utils/secrets-loader.d.ts +88 -0
- package/dist/utils/secrets-loader.d.ts.map +1 -0
- package/dist/utils/secrets-loader.js +271 -0
- package/dist/utils/secrets-loader.js.map +1 -0
- package/dist/utils/translation.d.ts +187 -0
- package/dist/utils/translation.d.ts.map +1 -0
- package/dist/utils/translation.js +414 -0
- package/dist/utils/translation.js.map +1 -0
- package/package.json +28 -44
- package/plugins/specweave/.claude-plugin/plugin.json +3 -3
- package/plugins/specweave/agents/pm/AGENT.md +330 -54
- package/plugins/specweave/agents/test-aware-planner/AGENT.md +1035 -0
- package/plugins/specweave/agents/test-aware-planner/templates/README.md +118 -0
- package/plugins/specweave/agents/test-aware-planner/templates/task-non-testable.md.template +24 -0
- package/plugins/specweave/agents/test-aware-planner/templates/task-testable.md.template +53 -0
- package/plugins/specweave/agents/test-aware-planner/templates/tasks-frontmatter.md.template +11 -0
- package/plugins/specweave/commands/README.md +88 -163
- package/plugins/specweave/commands/specweave-abandon.md +314 -0
- package/plugins/specweave/commands/specweave-check-tests.md +546 -0
- package/plugins/specweave/commands/{do.md → specweave-do.md} +5 -5
- package/plugins/specweave/commands/{done.md → specweave-done.md} +2 -0
- package/plugins/specweave/commands/{increment.md → specweave-increment.md} +231 -4
- package/plugins/specweave/commands/specweave-pause.md +189 -0
- package/plugins/specweave/commands/specweave-qa.md +245 -0
- package/plugins/specweave/commands/specweave-resume.md +216 -0
- package/plugins/specweave/commands/specweave-status.md +397 -0
- package/plugins/specweave/commands/specweave-sync-tasks.md +256 -0
- package/plugins/specweave/commands/{translate.md → specweave-translate.md} +3 -3
- package/plugins/specweave/commands/specweave-update-scope.md +351 -0
- package/plugins/specweave/commands/{validate.md → specweave-validate.md} +2 -0
- package/plugins/specweave/commands/specweave.md +21 -21
- package/plugins/specweave/hooks/docs-changed.sh +23 -3
- package/plugins/specweave/hooks/human-input-required.sh +23 -3
- package/plugins/specweave/hooks/post-increment-planning.sh +335 -0
- package/plugins/specweave/hooks/post-task-completion.sh +161 -1
- package/plugins/specweave/hooks/pre-implementation.sh +23 -3
- package/plugins/specweave/skills/SKILLS-INDEX.md +1 -1
- package/plugins/specweave/skills/brownfield-analyzer/SKILL.md +9 -9
- package/plugins/specweave/skills/increment-planner/SKILL.md +400 -212
- package/plugins/specweave/skills/increment-quality-judge-v2/SKILL.md +499 -0
- package/plugins/specweave/skills/plugin-detector/SKILL.md +114 -1
- package/plugins/specweave/skills/project-kickstarter/SKILL.md +74 -1
- package/plugins/specweave/skills/{rfc-generator → spec-generator}/SKILL.md +22 -29
- package/plugins/specweave/skills/specweave-detector/SKILL.md +3 -3
- package/plugins/specweave/skills/specweave-framework/SKILL.md +2 -2
- package/plugins/specweave-ado/.claude-plugin/plugin.json +18 -4
- package/plugins/specweave-ado/agents/ado-manager/AGENT.md +426 -0
- package/plugins/specweave-ado/commands/close-workitem.md +52 -0
- package/plugins/specweave-ado/commands/create-workitem.md +53 -0
- package/plugins/specweave-ado/commands/status.md +53 -0
- package/plugins/specweave-ado/commands/sync.md +55 -0
- package/plugins/specweave-ado/lib/ado-client.ts +361 -0
- package/plugins/specweave-ado/reference/ado-specweave-mapping.md +552 -0
- package/plugins/specweave-ado/skills/ado-sync/SKILL.md +344 -193
- package/plugins/specweave-docs/skills/docusaurus/SKILL.md +73 -0
- package/plugins/specweave-github/agents/github-manager/AGENT.md +49 -0
- package/plugins/specweave-github/commands/{github-close-issue.md → close-issue.md} +1 -1
- package/plugins/specweave-github/commands/{github-create-issue.md → create-issue.md} +1 -1
- package/plugins/specweave-github/commands/{github-status.md → status.md} +1 -1
- package/plugins/specweave-github/commands/{github-sync-tasks.md → sync-tasks.md} +1 -1
- package/plugins/specweave-github/commands/{github-sync.md → sync.md} +1 -1
- package/plugins/specweave-github/reference/github-specweave-mapping.md +377 -0
- package/plugins/specweave-github/skills/github-sync/SKILL.md +11 -3
- package/plugins/specweave-infrastructure/commands/{specweave.monitor-setup.md → monitor-setup.md} +5 -0
- package/plugins/specweave-infrastructure/commands/{specweave.slo-implement.md → slo-implement.md} +5 -0
- package/plugins/specweave-jira/agents/jira-manager/AGENT.md +380 -0
- package/plugins/specweave-jira/commands/{specweave.sync-jira.md → sync.md} +1 -1
- package/plugins/specweave-jira/reference/jira-specweave-mapping.md +508 -0
- package/plugins/specweave-ml/commands/ml-deploy.md +1 -1
- package/plugins/specweave-ml/commands/ml-evaluate.md +1 -1
- package/plugins/specweave-ml/commands/ml-explain.md +1 -1
- package/plugins/specweave-ml/commands/{specweave.ml-pipeline.md → ml-pipeline.md} +5 -0
- package/src/templates/AGENTS.md.template +652 -1
- package/src/templates/CLAUDE.md.template +36 -21
- package/src/templates/COMPLETION-REPORT.template.md +128 -0
- package/src/templates/README.md.template +17 -16
- package/src/templates/docs/README.md +11 -9
- package/src/templates/docs/spec-template.md +229 -0
- package/dist/adapters/copilot/adapter.d.ts +0 -86
- package/dist/adapters/copilot/adapter.d.ts.map +0 -1
- package/dist/adapters/copilot/adapter.js +0 -396
- package/dist/adapters/copilot/adapter.js.map +0 -1
- package/plugins/.specweave/logs/hooks-debug.log +0 -24
- package/plugins/.specweave/logs/last-hook-fire +0 -1
- package/plugins/.specweave/logs/last-todowrite-time +0 -1
- package/plugins/.specweave/logs/tasks.log +0 -6
- package/plugins/specweave/commands/inc.md +0 -85
- package/plugins/specweave/commands/list-increments.md +0 -180
- package/src/adapters/README.md +0 -311
- package/src/adapters/adapter-base.ts +0 -182
- package/src/adapters/adapter-interface.ts +0 -166
- package/src/adapters/adapter-loader.ts +0 -259
- package/src/adapters/agents-md-generator.ts +0 -228
- package/src/adapters/claude/README.md +0 -233
- package/src/adapters/claude/adapter.ts +0 -468
- package/src/adapters/claude-md-generator.ts +0 -377
- package/src/adapters/codex/README.md +0 -105
- package/src/adapters/codex/adapter.ts +0 -333
- package/src/adapters/copilot/README.md +0 -240
- package/src/adapters/copilot/adapter.ts +0 -444
- package/src/adapters/cursor/.cursor/context/docs-context.md +0 -62
- package/src/adapters/cursor/.cursor/context/increments-context.md +0 -71
- package/src/adapters/cursor/.cursor/context/strategy-context.md +0 -73
- package/src/adapters/cursor/.cursor/context/tests-context.md +0 -89
- package/src/adapters/cursor/README.md +0 -283
- package/src/adapters/cursor/adapter.ts +0 -451
- package/src/adapters/doc-generator.ts +0 -331
- package/src/adapters/gemini/README.md +0 -97
- package/src/adapters/gemini/adapter.ts +0 -298
- package/src/adapters/generic/README.md +0 -277
- package/src/adapters/generic/adapter.ts +0 -359
- package/src/adapters/registry.yaml +0 -187
- /package/plugins/specweave/commands/{costs.md → specweave-costs.md} +0 -0
- /package/plugins/specweave/commands/{next.md → specweave-next.md} +0 -0
- /package/plugins/specweave/commands/{progress.md → specweave-progress.md} +0 -0
- /package/plugins/specweave/commands/{sync-docs.md → specweave-sync-docs.md} +0 -0
- /package/plugins/specweave/commands/{tdd-cycle.md → specweave-tdd-cycle.md} +0 -0
- /package/plugins/specweave/commands/{tdd-green.md → specweave-tdd-green.md} +0 -0
- /package/plugins/specweave/commands/{tdd-red.md → specweave-tdd-red.md} +0 -0
- /package/plugins/specweave/commands/{tdd-refactor.md → specweave-tdd-refactor.md} +0 -0
|
@@ -121,7 +121,80 @@ Once I have these details, I'll guide you through SpecWeave's increment planning
|
|
|
121
121
|
**Low Confidence:**
|
|
122
122
|
Don't activate. Let other skills handle it.
|
|
123
123
|
|
|
124
|
-
### Step 4:
|
|
124
|
+
### Step 4: Detect External PM Tool (NEW v0.8.0)
|
|
125
|
+
|
|
126
|
+
**Purpose**: Check if user has external project management tool (GitHub/Jira/ADO) and offer sync
|
|
127
|
+
|
|
128
|
+
**Signals to Detect**:
|
|
129
|
+
1. **Environment Variables**:
|
|
130
|
+
- `GITHUB_TOKEN` → GitHub Issues
|
|
131
|
+
- `JIRA_URL` or `JIRA_API_TOKEN` → Jira
|
|
132
|
+
- `AZURE_DEVOPS_PAT` → Azure DevOps
|
|
133
|
+
|
|
134
|
+
2. **Git Remote**:
|
|
135
|
+
- Remote URL contains `github.com` → GitHub
|
|
136
|
+
- Remote URL contains `dev.azure.com` → Azure DevOps
|
|
137
|
+
|
|
138
|
+
3. **Existing Config**:
|
|
139
|
+
- `.specweave/config.json` has `externalPM.tool` set
|
|
140
|
+
|
|
141
|
+
4. **File Patterns**:
|
|
142
|
+
- `.github/` directory → GitHub
|
|
143
|
+
- Git commits contain `PROJ-123` → Jira
|
|
144
|
+
- Files mention ADO work item IDs `#12345` → ADO
|
|
145
|
+
|
|
146
|
+
**When to Ask**:
|
|
147
|
+
- **New project** (no `.specweave/config.json`): Always ask
|
|
148
|
+
- **Existing project with no PM tool**: Ask once, save preference
|
|
149
|
+
- **Existing project with PM tool**: Skip (already configured)
|
|
150
|
+
|
|
151
|
+
**Interactive Prompt**:
|
|
152
|
+
```
|
|
153
|
+
Great! Before we create the increment, quick question:
|
|
154
|
+
|
|
155
|
+
**Do you use an external project management tool?**
|
|
156
|
+
|
|
157
|
+
Options:
|
|
158
|
+
1. **GitHub Issues** (Recommended - detected GitHub repo)
|
|
159
|
+
2. **Jira**
|
|
160
|
+
3. **Azure DevOps**
|
|
161
|
+
4. **None** (Just SpecWeave)
|
|
162
|
+
|
|
163
|
+
I can automatically sync increment progress with your PM tool if configured.
|
|
164
|
+
```
|
|
165
|
+
|
|
166
|
+
**If User Selects GitHub/Jira/ADO**:
|
|
167
|
+
1. Check if plugin installed (`/plugin list --installed | grep specweave-{tool}`)
|
|
168
|
+
2. If not installed → Suggest: "Install {tool} plugin for sync?"
|
|
169
|
+
3. If installed → Test connection (API key valid?)
|
|
170
|
+
4. Save preference to `.specweave/config.json`
|
|
171
|
+
5. Proceed with increment creation
|
|
172
|
+
6. Auto-create external issue when increment created
|
|
173
|
+
|
|
174
|
+
**If User Selects None**:
|
|
175
|
+
1. Save preference: `externalPM.enabled: false`
|
|
176
|
+
2. Proceed with increment creation (local only)
|
|
177
|
+
|
|
178
|
+
**Example Flow**:
|
|
179
|
+
```
|
|
180
|
+
User: "Build SaaS app with user authentication"
|
|
181
|
+
|
|
182
|
+
project-kickstarter:
|
|
183
|
+
1. Detects: High confidence (project description)
|
|
184
|
+
2. Checks: Git remote = github.com/myorg/myapp
|
|
185
|
+
3. Detects: GITHUB_TOKEN environment variable set
|
|
186
|
+
4. Asks: "Do you use GitHub Issues for project management?"
|
|
187
|
+
5. User: "Yes"
|
|
188
|
+
6. Checks: specweave-github plugin installed? Yes
|
|
189
|
+
7. Tests: GitHub API connection? ✅ Success
|
|
190
|
+
8. Saves: externalPM.tool = "github" to config
|
|
191
|
+
9. Creates increment: /specweave:inc "User authentication"
|
|
192
|
+
10. Auto-creates: GitHub Issue #42 linked to increment
|
|
193
|
+
```
|
|
194
|
+
|
|
195
|
+
---
|
|
196
|
+
|
|
197
|
+
### Step 5: Hand Off
|
|
125
198
|
|
|
126
199
|
Based on clarity of requirements:
|
|
127
200
|
|
|
@@ -1,11 +1,11 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
3
|
-
description: Generates comprehensive
|
|
2
|
+
name: spec-generator
|
|
3
|
+
description: Generates comprehensive specifications (spec.md, plan.md, tasks.md with embedded tests) for SpecWeave increments using proven templates and flexible structure. Activates when users create new increments, plan features, or need structured documentation. Keywords: specification, spec, plan, tasks, tests, increment planning, feature planning, requirements.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
#
|
|
6
|
+
# Spec Generator - Flexible Increment Documentation
|
|
7
7
|
|
|
8
|
-
**Purpose**: Automatically generate comprehensive
|
|
8
|
+
**Purpose**: Automatically generate comprehensive specification documentation (spec.md, plan.md, tasks.md with embedded tests) for SpecWeave increments using proven templates and flexible, context-aware structure.
|
|
9
9
|
|
|
10
10
|
**When to Use**:
|
|
11
11
|
- Creating new increments (`/specweave:inc`)
|
|
@@ -13,11 +13,11 @@ description: Generates comprehensive RFCs (spec.md, plan.md, tasks.md, tests.md)
|
|
|
13
13
|
- Generating structured documentation
|
|
14
14
|
- Converting ideas into actionable specs
|
|
15
15
|
|
|
16
|
-
**Based On**:
|
|
16
|
+
**Based On**: Flexible Spec Generator (V2) - context-aware, non-rigid templates
|
|
17
17
|
|
|
18
18
|
---
|
|
19
19
|
|
|
20
|
-
## How
|
|
20
|
+
## How Spec Generator Works
|
|
21
21
|
|
|
22
22
|
### 1. Flexible Spec Generation (spec.md)
|
|
23
23
|
|
|
@@ -184,7 +184,7 @@ describe('[Component]', () => {
|
|
|
184
184
|
|
|
185
185
|
---
|
|
186
186
|
|
|
187
|
-
##
|
|
187
|
+
## Spec Generator Templates
|
|
188
188
|
|
|
189
189
|
### Template Selection Logic
|
|
190
190
|
|
|
@@ -229,12 +229,12 @@ END IF
|
|
|
229
229
|
```
|
|
230
230
|
User: /specweave:inc "Add dark mode toggle to settings"
|
|
231
231
|
|
|
232
|
-
|
|
232
|
+
Spec Generator:
|
|
233
233
|
✓ Detected: Frontend feature (UI component)
|
|
234
234
|
✓ Complexity: Simple
|
|
235
235
|
✓ Template: User Stories + Component Design
|
|
236
236
|
|
|
237
|
-
Generating
|
|
237
|
+
Generating specifications...
|
|
238
238
|
✓ spec.md: 3 user stories, UI mockups section
|
|
239
239
|
✓ plan.md: Component design, state management, CSS-in-JS
|
|
240
240
|
✓ tasks.md: 8 tasks (component, styles, state, tests)
|
|
@@ -245,12 +245,12 @@ Generating RFC...
|
|
|
245
245
|
```
|
|
246
246
|
User: /specweave:inc "Multi-tenant SaaS platform with billing"
|
|
247
247
|
|
|
248
|
-
|
|
248
|
+
Spec Generator:
|
|
249
249
|
✓ Detected: New product (SaaS, multi-tenant, payments)
|
|
250
250
|
✓ Complexity: High
|
|
251
251
|
✓ Template: Full PRD + System Architecture
|
|
252
252
|
|
|
253
|
-
Generating
|
|
253
|
+
Generating specifications...
|
|
254
254
|
✓ spec.md: Market analysis, personas, competitive landscape, 15 user stories
|
|
255
255
|
✓ plan.md: Multi-tenant architecture, database per tenant, Stripe integration, C4 diagrams
|
|
256
256
|
✓ tasks.md: 40 tasks across 4 weeks (auth, tenancy, billing, UI)
|
|
@@ -261,12 +261,12 @@ Generating RFC...
|
|
|
261
261
|
```
|
|
262
262
|
User: /specweave:inc "Fix race condition in user session handling"
|
|
263
263
|
|
|
264
|
-
|
|
264
|
+
Spec Generator:
|
|
265
265
|
✓ Detected: Bug fix (concurrency issue)
|
|
266
266
|
✓ Complexity: Moderate
|
|
267
267
|
✓ Template: Problem-Solution
|
|
268
268
|
|
|
269
|
-
Generating
|
|
269
|
+
Generating specifications...
|
|
270
270
|
✓ spec.md: Problem statement, root cause analysis, impact, solution
|
|
271
271
|
✓ plan.md: Current implementation, proposed fix, Redis locking
|
|
272
272
|
✓ tasks.md: 5 tasks (analysis, fix, tests, rollout, monitoring)
|
|
@@ -277,7 +277,7 @@ Generating RFC...
|
|
|
277
277
|
|
|
278
278
|
## Integration with /specweave:inc
|
|
279
279
|
|
|
280
|
-
The
|
|
280
|
+
The Spec Generator is automatically invoked by `/specweave:inc`:
|
|
281
281
|
|
|
282
282
|
1. **User Intent Analysis**:
|
|
283
283
|
- Analyze increment description
|
|
@@ -287,7 +287,7 @@ The RFC generator is automatically invoked by `/specweave:inc`:
|
|
|
287
287
|
- Choose appropriate templates
|
|
288
288
|
- Auto-include relevant sections
|
|
289
289
|
|
|
290
|
-
3. **
|
|
290
|
+
3. **Specification Generation**:
|
|
291
291
|
- Generate spec.md with PM context
|
|
292
292
|
- Generate plan.md with Architect context
|
|
293
293
|
- Generate tasks.md with breakdown
|
|
@@ -321,10 +321,10 @@ The RFC generator is automatically invoked by `/specweave:inc`:
|
|
|
321
321
|
|
|
322
322
|
## Configuration
|
|
323
323
|
|
|
324
|
-
Users can customize
|
|
324
|
+
Users can customize spec generation in `.specweave/config.yaml`:
|
|
325
325
|
|
|
326
326
|
```yaml
|
|
327
|
-
|
|
327
|
+
spec_generator:
|
|
328
328
|
# Default complexity level
|
|
329
329
|
default_complexity: moderate # simple | moderate | complex
|
|
330
330
|
|
|
@@ -350,20 +350,13 @@ rfc_generator:
|
|
|
350
350
|
|
|
351
351
|
## Related Skills
|
|
352
352
|
|
|
353
|
-
- **increment-planner**: Guides increment planning (uses
|
|
354
|
-
- **context-loader**: Loads relevant context for
|
|
355
|
-
- **increment-quality-judge**: Validates generated
|
|
353
|
+
- **increment-planner**: Guides increment planning (uses Spec Generator internally)
|
|
354
|
+
- **context-loader**: Loads relevant context for specification generation
|
|
355
|
+
- **increment-quality-judge**: Validates generated specifications for completeness
|
|
356
356
|
|
|
357
357
|
---
|
|
358
358
|
|
|
359
359
|
## Version History
|
|
360
360
|
|
|
361
|
-
- **v1.0.0** (0.
|
|
362
|
-
- Based on:
|
|
363
|
-
|
|
364
|
-
---
|
|
365
|
-
|
|
366
|
-
## References
|
|
367
|
-
|
|
368
|
-
- Flexible RFC Generator Design: `.specweave/increments/0001-core-framework/reports/rfc-generator-v2.md`
|
|
369
|
-
- Generator Comparison: `.specweave/increments/0001-core-framework/reports/rfc-generator-comparison.md`
|
|
361
|
+
- **v1.0.0** (0.8.0): Initial release with flexible template system
|
|
362
|
+
- Based on: Flexible Spec Generator (V2) - context-aware, non-rigid templates
|
|
@@ -3,14 +3,14 @@ name: specweave-detector
|
|
|
3
3
|
description: Detects SpecWeave context (.specweave/ directory exists) and provides workflow documentation. v0.3.8+ features PROACTIVE auto-detection - when in SpecWeave folder, product descriptions automatically trigger increment planning. Explicit slash commands still work (/inc, /do, /progress, /validate, /done, /specweave:sync-docs, /sync-github). Keywords slash commands, /inc, /increment, /do, /progress, /validate, /done, specweave commands, smart workflow, auto-detection, specweave folder.
|
|
4
4
|
---
|
|
5
5
|
|
|
6
|
-
# SpecWeave
|
|
6
|
+
# SpecWeave - Smart Workflow with Auto-Detection
|
|
7
7
|
|
|
8
|
-
|
|
8
|
+
SpecWeave features **PROACTIVE AUTO-DETECTION**!
|
|
9
9
|
|
|
10
10
|
When working in a SpecWeave-initialized project (.specweave/ directory exists), product descriptions automatically trigger increment planning.
|
|
11
11
|
|
|
12
12
|
**Two ways to use SpecWeave**:
|
|
13
|
-
1. ✅ **Auto-detection
|
|
13
|
+
1. ✅ **Auto-detection**: Describe your product → SpecWeave creates increment automatically
|
|
14
14
|
2. ✅ **Explicit commands**: Type `/inc "feature"` → Works as before
|
|
15
15
|
|
|
16
16
|
## How SpecWeave Works (v0.1.9)
|
|
@@ -316,7 +316,7 @@ Until hooks are fully automated, **YOU MUST**:
|
|
|
316
316
|
### Core vs. Plugin
|
|
317
317
|
|
|
318
318
|
**Core Framework** (always loaded):
|
|
319
|
-
- 8 core skills (increment-planner,
|
|
319
|
+
- 8 core skills (increment-planner, spec-generator, context-loader, etc.)
|
|
320
320
|
- 3 core agents (PM, Architect, Tech Lead)
|
|
321
321
|
- 7 core commands (/specweave:inc, /specweave:do, etc.)
|
|
322
322
|
|
|
@@ -487,7 +487,7 @@ I activate when you ask about:
|
|
|
487
487
|
- **PM agent** - Leading increment creation (auto-invoked by /specweave:inc)
|
|
488
488
|
- **Architect agent** - Designing system architecture
|
|
489
489
|
- **Tech Lead agent** - Code review, best practices
|
|
490
|
-
- **
|
|
490
|
+
- **spec-generator** - Creating detailed technical RFCs
|
|
491
491
|
- **context-loader** - Explaining context efficiency
|
|
492
492
|
- **diagrams-architect** - Creating C4/Mermaid diagrams
|
|
493
493
|
|
|
@@ -1,8 +1,22 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "specweave-ado",
|
|
3
|
-
"
|
|
4
|
-
"
|
|
3
|
+
"version": "0.1.0",
|
|
4
|
+
"description": "Azure DevOps integration for SpecWeave - sync increments with ADO work items, track progress, and manage project workflows",
|
|
5
5
|
"author": {
|
|
6
|
-
"name": "SpecWeave Team"
|
|
7
|
-
|
|
6
|
+
"name": "SpecWeave Team",
|
|
7
|
+
"url": "https://spec-weave.com"
|
|
8
|
+
},
|
|
9
|
+
"repository": {
|
|
10
|
+
"type": "git",
|
|
11
|
+
"url": "https://github.com/anton-abyzov/specweave"
|
|
12
|
+
},
|
|
13
|
+
"keywords": [
|
|
14
|
+
"azure-devops",
|
|
15
|
+
"ado",
|
|
16
|
+
"project-management",
|
|
17
|
+
"work-items",
|
|
18
|
+
"sync",
|
|
19
|
+
"integration"
|
|
20
|
+
],
|
|
21
|
+
"license": "MIT"
|
|
8
22
|
}
|