specweave 0.8.16 → 0.8.18
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 +3 -3
- package/CLAUDE.md +77 -21
- package/README.md +11 -3
- package/README.md.bak +304 -0
- package/dist/cli/commands/init.d.ts.map +1 -1
- package/dist/cli/commands/init.js +76 -22
- package/dist/cli/commands/init.js.map +1 -1
- package/dist/cli/helpers/issue-tracker/ado.js +1 -1
- package/dist/cli/helpers/issue-tracker/ado.js.map +1 -1
- package/dist/cli/helpers/issue-tracker/github.js +1 -1
- package/dist/cli/helpers/issue-tracker/github.js.map +1 -1
- package/dist/cli/helpers/issue-tracker/index.d.ts.map +1 -1
- package/dist/cli/helpers/issue-tracker/index.js +8 -3
- package/dist/cli/helpers/issue-tracker/index.js.map +1 -1
- package/dist/cli/helpers/issue-tracker/jira.js +1 -1
- package/dist/cli/helpers/issue-tracker/jira.js.map +1 -1
- package/dist/cli/helpers/issue-tracker/utils.d.ts +5 -2
- package/dist/cli/helpers/issue-tracker/utils.d.ts.map +1 -1
- package/dist/cli/helpers/issue-tracker/utils.js +13 -6
- package/dist/cli/helpers/issue-tracker/utils.js.map +1 -1
- package/dist/locales/en/cli.json +1 -1
- package/dist/utils/agents-md-compiler.js +2 -2
- package/dist/utils/env-multi-project-parser.d.ts +210 -0
- package/dist/utils/env-multi-project-parser.d.ts.map +1 -0
- package/dist/utils/env-multi-project-parser.js +406 -0
- package/dist/utils/env-multi-project-parser.js.map +1 -0
- package/package.json +1 -1
- package/plugins/specweave/hooks/post-first-increment.sh +79 -0
- package/plugins/specweave/skills/increment-planner/SKILL.md +50 -16
- package/plugins/specweave/skills/plugin-expert/SKILL.md +344 -0
- package/plugins/specweave/skills/specweave-framework/SKILL.md +2 -2
- package/plugins/specweave/skills/translator/SKILL.md +29 -0
- package/plugins/specweave/skills/translator/SKILL.md.bak +172 -0
- package/src/templates/.gitignore.template +1 -0
- package/src/templates/AGENTS.md.template +6 -6
- package/src/templates/CLAUDE.md.template +10 -10
package/.claude-plugin/README.md
CHANGED
|
@@ -17,7 +17,7 @@ When you clone this repo and **trust the folder** in Claude Code:
|
|
|
17
17
|
/plugin install specweave
|
|
18
18
|
```
|
|
19
19
|
4. **Restart Claude Code**
|
|
20
|
-
5. Commands are now available: `/specweave:
|
|
20
|
+
5. Commands are now available: `/specweave:increment`, `/specweave:do`, etc.
|
|
21
21
|
|
|
22
22
|
**How it works**: The `.claude/settings.json` file contains:
|
|
23
23
|
```json
|
|
@@ -54,7 +54,7 @@ If automatic setup doesn't work (or folder not trusted):
|
|
|
54
54
|
### Verify Installation
|
|
55
55
|
|
|
56
56
|
After installing plugins, type `/specweave:` to see available commands:
|
|
57
|
-
- `/specweave:
|
|
57
|
+
- `/specweave:increment` - Plan new increment
|
|
58
58
|
- `/specweave:do` - Execute tasks
|
|
59
59
|
- `/specweave:next` - Smart transition
|
|
60
60
|
- `/specweave:done` - Close increment
|
|
@@ -130,7 +130,7 @@ SpecWeave's marketplace.json follows Claude's official schema format. Here's the
|
|
|
130
130
|
- No namespacing
|
|
131
131
|
|
|
132
132
|
**With Plugin System** (new):
|
|
133
|
-
- Commands: `/specweave:
|
|
133
|
+
- Commands: `/specweave:increment`, `/specweave:do`, `/specweave-github:sync`
|
|
134
134
|
- Plugin-namespaced via `.claude-plugin/`
|
|
135
135
|
- Proper marketplace structure
|
|
136
136
|
- Each plugin has its own namespace (e.g., `specweave`, `specweave-github`)
|
package/CLAUDE.md
CHANGED
|
@@ -144,7 +144,7 @@ Claude Code isn't just another AI coding assistant - **Anthropic defines the ind
|
|
|
144
144
|
```
|
|
145
145
|
|
|
146
146
|
**Enforcement**:
|
|
147
|
-
- `/specweave:
|
|
147
|
+
- `/specweave:increment` command validates naming (rejects bare numbers)
|
|
148
148
|
- Code review requirement (descriptive names mandatory)
|
|
149
149
|
- This document serves as the source of truth
|
|
150
150
|
|
|
@@ -244,7 +244,7 @@ This is **NOT negotiable**. It is a **hard enforcement** to prevent chaos, scope
|
|
|
244
244
|
- Quality degradation (tests not run, docs not updated)
|
|
245
245
|
|
|
246
246
|
**The Solution**:
|
|
247
|
-
- ✅ **Hard block** on `/specweave:
|
|
247
|
+
- ✅ **Hard block** on `/specweave:increment` if previous increments incomplete
|
|
248
248
|
- ✅ **Helper commands** to close increments properly
|
|
249
249
|
- ✅ **Clear guidance** on how to resolve incomplete work
|
|
250
250
|
- ✅ **Force discipline** = force quality
|
|
@@ -403,7 +403,7 @@ Simplest option: **Don't start a new increment**. Just extend the current one:
|
|
|
403
403
|
|
|
404
404
|
### Enforcement Points
|
|
405
405
|
|
|
406
|
-
1. **`/specweave:
|
|
406
|
+
1. **`/specweave:increment` command** - Hard block (Step 0A)
|
|
407
407
|
2. **PM agent** - Pre-flight validation before planning
|
|
408
408
|
3. **CI/CD** (future) - Prevent PR merges with incomplete increments
|
|
409
409
|
|
|
@@ -830,7 +830,7 @@ if (parentSpecweave) {
|
|
|
830
830
|
**Plugin**: `specweave` - The essential SpecWeave plugin loaded in every project:
|
|
831
831
|
- **Skills**: 9 skills (increment-planner, tdd-workflow, spec-generator, context-loader, project-kickstarter, brownfield-analyzer, brownfield-onboarder, increment-quality-judge, context-optimizer)
|
|
832
832
|
- **Agents**: 22 agents (PM, Architect, Tech Lead, + 19 specialized including tdd-orchestrator)
|
|
833
|
-
- **Commands**: 22 commands (/specweave:
|
|
833
|
+
- **Commands**: 22 commands (/specweave:increment, /specweave:do, /specweave:next, /specweave:done, /specweave:progress, /specweave:validate, /specweave:sync-docs, + 15 specialized)
|
|
834
834
|
- **Hooks**: 8 lifecycle hooks
|
|
835
835
|
- **Size**: ~12K tokens
|
|
836
836
|
|
|
@@ -939,39 +939,58 @@ When you run `specweave init`:
|
|
|
939
939
|
- Success message: "✔ SpecWeave core plugin installed automatically!"
|
|
940
940
|
- Graceful fallback: If CLI unavailable, shows manual install instructions
|
|
941
941
|
|
|
942
|
-
3.
|
|
943
|
-
-
|
|
944
|
-
-
|
|
942
|
+
3. ✅ **Issue Tracker Plugin Auto-Installation** (NEW! v0.8.18+)
|
|
943
|
+
- Detects GitHub/Jira/Azure DevOps from project structure
|
|
944
|
+
- Prompts for credentials (API tokens, PATs)
|
|
945
|
+
- **Automatically installs** corresponding plugin (specweave-github, specweave-jira, specweave-ado)
|
|
946
|
+
- Happens AFTER marketplace registration (ensures plugin installation succeeds)
|
|
947
|
+
- Shows detailed error messages if auto-install fails
|
|
948
|
+
- Example: Jira detected → credentials saved → `specweave-jira` plugin installed automatically
|
|
949
|
+
|
|
950
|
+
4. ℹ️ **Optional Plugins Available**
|
|
951
|
+
- Suggested based on project type (frontend, backend, infrastructure)
|
|
952
|
+
- User can install later via `/plugin install specweave-{name}`
|
|
945
953
|
|
|
946
954
|
**Key Architectural Change**:
|
|
947
955
|
- ❌ Old: Copied `.claude-plugin/` + `plugins/` to every project (~2MB bloat)
|
|
948
956
|
- ✅ New: Reference GitHub marketplace (~2KB settings.json, always up-to-date)
|
|
949
957
|
|
|
950
|
-
#### Phase 2: Increment Planning (
|
|
958
|
+
#### Phase 2: Increment Planning (Intelligent Plugin Detection)
|
|
951
959
|
|
|
952
960
|
When you create increments (e.g., `/specweave:increment "Add Stripe billing"`):
|
|
953
961
|
|
|
954
|
-
1. **Spec Analysis** (
|
|
962
|
+
1. **Spec Analysis** (v0.6.0+, Enhanced v0.8.18+)
|
|
955
963
|
- increment-planner skill scans spec.md content
|
|
956
964
|
- Detects keywords: "Stripe", "GitHub", "Kubernetes", "React", etc.
|
|
957
965
|
- Maps keywords → required plugins (see Step 6 in increment-planner/SKILL.md)
|
|
958
966
|
|
|
959
|
-
2.
|
|
967
|
+
2. **🚨 AUTOMATIC Plugin Recommendation** (Enhanced v0.8.18+)
|
|
960
968
|
```
|
|
961
|
-
🔌
|
|
969
|
+
🔌 Detected plugin requirements from spec content:
|
|
970
|
+
|
|
971
|
+
REQUIRED (will significantly improve implementation):
|
|
972
|
+
• specweave-payments - Stripe integration
|
|
973
|
+
Detected: "billing", "Stripe", "subscriptions"
|
|
974
|
+
Provides: Stripe expert agent, payment flow validation, webhook handling
|
|
975
|
+
→ Without this: Manual Stripe integration, no validation
|
|
962
976
|
|
|
963
|
-
|
|
964
|
-
|
|
977
|
+
📦 Install recommended plugins:
|
|
978
|
+
/plugin install specweave-payments
|
|
965
979
|
|
|
966
|
-
|
|
980
|
+
💡 Benefits:
|
|
981
|
+
• Plugins provide specialized AI agents (Stripe expert, etc.)
|
|
982
|
+
• Skills auto-activate based on context (zero manual invocation)
|
|
983
|
+
• 70%+ context reduction (only load what you need)
|
|
984
|
+
• Best practices built-in (from real-world experience)
|
|
967
985
|
|
|
968
|
-
|
|
986
|
+
Would you like me to wait while you install these plugins? (Recommended)
|
|
987
|
+
Or shall I continue without them? (Limited capabilities)
|
|
969
988
|
```
|
|
970
989
|
|
|
971
990
|
3. **User Decision**
|
|
972
|
-
- Install now → Plugin activates immediately (
|
|
973
|
-
- Install later → Skills won't be available until plugin installed
|
|
974
|
-
- Skip → Increment creation continues (not blocked)
|
|
991
|
+
- Install now → Plugin activates immediately (skills available during implementation)
|
|
992
|
+
- Install later → Skills won't be available until plugin installed (can add mid-work)
|
|
993
|
+
- Skip → Increment creation continues (not blocked, but capabilities limited)
|
|
975
994
|
|
|
976
995
|
#### Phase 3: Implementation (Auto-Activation)
|
|
977
996
|
|
|
@@ -987,6 +1006,43 @@ When plugins are installed:
|
|
|
987
1006
|
- 70%+ reduction vs. monolithic approach
|
|
988
1007
|
- Real-time: Simple React app = 16K tokens (was 50K in v0.3.7)
|
|
989
1008
|
|
|
1009
|
+
#### Phase 4: First Increment Completion (Documentation Preview)
|
|
1010
|
+
|
|
1011
|
+
After completing your first increment:
|
|
1012
|
+
|
|
1013
|
+
1. **🎉 Post-First-Increment Hook** (NEW! v0.8.18+)
|
|
1014
|
+
- Automatically triggers when first increment is marked complete
|
|
1015
|
+
- Suggests docs-preview plugin for beautiful documentation UI
|
|
1016
|
+
- Shows clear benefits and install command
|
|
1017
|
+
|
|
1018
|
+
2. **Suggestion Format**:
|
|
1019
|
+
```
|
|
1020
|
+
🎉 Congratulations! You completed your first increment!
|
|
1021
|
+
|
|
1022
|
+
📚 Preview your documentation in a beautiful UI?
|
|
1023
|
+
|
|
1024
|
+
The specweave-docs-preview plugin can generate a Docusaurus site from
|
|
1025
|
+
your .specweave/docs/ folder with:
|
|
1026
|
+
|
|
1027
|
+
✓ Auto-generated sidebar from folder structure
|
|
1028
|
+
✓ Hot reload (edit markdown, see changes instantly)
|
|
1029
|
+
✓ Mermaid diagram rendering
|
|
1030
|
+
✓ Priority sorting (Strategy → Specs → Architecture → ...)
|
|
1031
|
+
|
|
1032
|
+
📦 Install with:
|
|
1033
|
+
/plugin install specweave-docs-preview
|
|
1034
|
+
|
|
1035
|
+
🚀 Then launch:
|
|
1036
|
+
/specweave:docs preview
|
|
1037
|
+
```
|
|
1038
|
+
|
|
1039
|
+
3. **Benefits**:
|
|
1040
|
+
- Beautiful, searchable documentation site (Docusaurus 3.x)
|
|
1041
|
+
- Live preview with hot reload (see changes in real-time)
|
|
1042
|
+
- Auto-generated navigation from folder structure
|
|
1043
|
+
- Mermaid diagrams rendered automatically
|
|
1044
|
+
- Share docs with stakeholders (export static site)
|
|
1045
|
+
|
|
990
1046
|
### Manual Plugin Management
|
|
991
1047
|
|
|
992
1048
|
All plugin management happens through Claude Code's native commands:
|
|
@@ -2052,7 +2108,7 @@ Is this feature...
|
|
|
2052
2108
|
│ Examples: increment-planner, spec-generator, tdd-workflow, PM/Architect agents
|
|
2053
2109
|
│
|
|
2054
2110
|
├─ Part of increment lifecycle? → specweave (auto-loaded)
|
|
2055
|
-
│ Examples: /specweave:
|
|
2111
|
+
│ Examples: /specweave:increment, /specweave:do, living docs hooks
|
|
2056
2112
|
│
|
|
2057
2113
|
├─ Tech stack specific? → New plugin: specweave-{stack}
|
|
2058
2114
|
│ Examples: specweave-frontend (React, Next.js), specweave-kubernetes
|
|
@@ -2113,7 +2169,7 @@ vim .claude-plugin/marketplace.json
|
|
|
2113
2169
|
|
|
2114
2170
|
# 5. Test locally
|
|
2115
2171
|
/plugin marketplace add ./.claude-plugin
|
|
2116
|
-
/plugin install myplugin
|
|
2172
|
+
/plugin install specweave-myplugin
|
|
2117
2173
|
```
|
|
2118
2174
|
|
|
2119
2175
|
**See**: [.claude-plugin/README.md](/.claude-plugin/README.md) for marketplace documentation
|
|
@@ -2378,7 +2434,7 @@ specweave migrate-to-profiles
|
|
|
2378
2434
|
|
|
2379
2435
|
### 4. Incremental Development
|
|
2380
2436
|
- Work in small, measurable increments
|
|
2381
|
-
- Use SpecWeave's own workflow (`/specweave:
|
|
2437
|
+
- Use SpecWeave's own workflow (`/specweave:increment`, `/specweave:do`, etc.)
|
|
2382
2438
|
- All work traces back to specs
|
|
2383
2439
|
|
|
2384
2440
|
### 5. Adapter-First Design
|
package/README.md
CHANGED
|
@@ -149,10 +149,18 @@ Auto-updates after every task via Claude Code hooks - never outdated
|
|
|
149
149
|
### 🤖 Intelligent Agents
|
|
150
150
|
PM Agent, Architect, test-aware-planner, Quality Judge - specialized AI agents guide you
|
|
151
151
|
|
|
152
|
-
### 🌍 Multilingual Support
|
|
153
|
-
Work in 9 languages (Russian, Spanish, Chinese, German, French, Japanese, Korean, Portuguese) with zero-cost LLM-native translation
|
|
154
152
|
|
|
155
|
-
|
|
153
|
+
### 🌍 Multilingual Support ($0 Cost!)
|
|
154
|
+
|
|
155
|
+
Work in 11 languages with **FREE zero-cost translation**:
|
|
156
|
+
|
|
157
|
+
- **Primary Approach**: In-session translation (FREE, works with any model)
|
|
158
|
+
- **Optional Approach**: Automated hooks (convenience, ~$0.003/increment)
|
|
159
|
+
- **11 Languages**: English, Russian, Spanish, Chinese, German, French, Japanese, Korean, Portuguese, Arabic, Hebrew
|
|
160
|
+
- **Any Model**: Claude, GPT-4, Gemini, DeepSeek, and more
|
|
161
|
+
- **Any Tool**: Claude Code, Cursor, Copilot, ChatGPT
|
|
162
|
+
|
|
163
|
+
**Zero API costs** - uses your current conversation context for translation!
|
|
156
164
|
|
|
157
165
|
---
|
|
158
166
|
|
package/README.md.bak
ADDED
|
@@ -0,0 +1,304 @@
|
|
|
1
|
+
# SpecWeave
|
|
2
|
+
|
|
3
|
+
> **AI made us fast. SpecWeave makes us sustainable.**
|
|
4
|
+
|
|
5
|
+
[](https://opensource.org/licenses/MIT)
|
|
6
|
+
[](https://github.com/anton-abyzov/specweave/actions/workflows/test.yml)
|
|
7
|
+
[](https://github.com/anton-abyzov/specweave/actions/workflows/e2e-smoke-test.yml)
|
|
8
|
+
[](https://discord.gg/UYg4BGJ65V)
|
|
9
|
+
[](https://www.youtube.com/@antonabyzov)
|
|
10
|
+
|
|
11
|
+
---
|
|
12
|
+
|
|
13
|
+
## The Problem Everyone Feels But Nobody Talks About
|
|
14
|
+
|
|
15
|
+
Your AI coding assistant writes features in 30 minutes.
|
|
16
|
+
|
|
17
|
+
You spend 3 days updating documentation.
|
|
18
|
+
|
|
19
|
+
By day 4, the code has changed again.
|
|
20
|
+
|
|
21
|
+
**The docs? Already wrong.**
|
|
22
|
+
|
|
23
|
+
---
|
|
24
|
+
|
|
25
|
+
## The Dirty Secret of AI Coding
|
|
26
|
+
|
|
27
|
+
AI coding assistants made us:
|
|
28
|
+
- ✅ **10x faster at shipping**
|
|
29
|
+
- ❌ **100x worse at maintaining**
|
|
30
|
+
|
|
31
|
+
We're all "vibe coding" now. Fast. Fun. Chaotic.
|
|
32
|
+
|
|
33
|
+
No structure. No boundaries. No memory of why we built it this way.
|
|
34
|
+
|
|
35
|
+
New developers? Lost in 1 hour.
|
|
36
|
+
|
|
37
|
+
**This is not sustainable.**
|
|
38
|
+
|
|
39
|
+
---
|
|
40
|
+
|
|
41
|
+
## The Fortune 500 Gap
|
|
42
|
+
|
|
43
|
+
Big companies don't have this problem.
|
|
44
|
+
|
|
45
|
+
They have systems:
|
|
46
|
+
- **PRDs** (Product Requirements) - What and why
|
|
47
|
+
- **HLDs** (High-Level Design) - Architecture decisions
|
|
48
|
+
- **ADRs** (Architecture Decision Records) - Why we chose X over Y
|
|
49
|
+
- **Runbooks** (Operations) - How to actually run this
|
|
50
|
+
- **Glossaries** (Terms) - What these acronyms mean
|
|
51
|
+
|
|
52
|
+
Their docs stay updated because there's a team, a process, a **discipline**.
|
|
53
|
+
|
|
54
|
+
But for solo developers and small teams?
|
|
55
|
+
|
|
56
|
+
**Impossible to maintain manually.**
|
|
57
|
+
|
|
58
|
+
---
|
|
59
|
+
|
|
60
|
+
## What is SpecWeave?
|
|
61
|
+
|
|
62
|
+
**Fortune 500 discipline. Zero overhead. AI-native.**
|
|
63
|
+
|
|
64
|
+
SpecWeave is a spec-driven development framework that brings enterprise-grade processes to developers of any size—without the bureaucracy.
|
|
65
|
+
|
|
66
|
+
It's not just a tool. **It's a movement.**
|
|
67
|
+
|
|
68
|
+
> *"Dad, AI writes your code but you update docs MANUALLY?"*
|
|
69
|
+
> — My 14-year-old daughter (who was absolutely right)
|
|
70
|
+
|
|
71
|
+
**The new way:**
|
|
72
|
+
- Living docs that ACTUALLY stay synced (automatically)
|
|
73
|
+
- Complete knowledge system (PRDs, HLDs, ADRs, glossaries, runbooks)
|
|
74
|
+
- Tests embedded in tasks (BDD format, full traceability)
|
|
75
|
+
- Enterprise structure without enterprise overhead
|
|
76
|
+
- **Vibe coding... but with boundaries**
|
|
77
|
+
|
|
78
|
+
---
|
|
79
|
+
|
|
80
|
+
## What Changes
|
|
81
|
+
|
|
82
|
+
**BEFORE (Vibe Coding):**
|
|
83
|
+
- "I think we used JWT tokens?"
|
|
84
|
+
- "Why did we choose PostgreSQL again?"
|
|
85
|
+
- "What does this acronym mean?"
|
|
86
|
+
- New developer: **Lost in 1 hour**
|
|
87
|
+
|
|
88
|
+
**AFTER (SpecWeave):**
|
|
89
|
+
- Check ADR-003: JWT vs Session Tokens (we chose JWT, here's why)
|
|
90
|
+
- Check HLD: Database section (Postgres for ACID compliance)
|
|
91
|
+
- Check Glossary: All technical terms defined
|
|
92
|
+
- New developer: **Productive in 1 hour**
|
|
93
|
+
|
|
94
|
+
---
|
|
95
|
+
|
|
96
|
+
## 📊 Engineering Metrics (DORA)
|
|
97
|
+
|
|
98
|
+
[](https://spec-weave.com/docs/metrics)
|
|
99
|
+
[](https://spec-weave.com/docs/metrics)
|
|
100
|
+
[](https://spec-weave.com/docs/metrics)
|
|
101
|
+
[](https://spec-weave.com/docs/metrics)
|
|
102
|
+
|
|
103
|
+
[View detailed metrics dashboard →](https://spec-weave.com/docs/metrics)
|
|
104
|
+
|
|
105
|
+
---
|
|
106
|
+
|
|
107
|
+
## 📖 Full Documentation
|
|
108
|
+
|
|
109
|
+
**For complete guides, tutorials, and API reference:**
|
|
110
|
+
|
|
111
|
+
### **[spec-weave.com](https://spec-weave.com)**
|
|
112
|
+
|
|
113
|
+
---
|
|
114
|
+
|
|
115
|
+
## Quick Start
|
|
116
|
+
|
|
117
|
+
```bash
|
|
118
|
+
# Install SpecWeave CLI
|
|
119
|
+
npm install -g specweave
|
|
120
|
+
|
|
121
|
+
# Initialize your project
|
|
122
|
+
specweave init my-project
|
|
123
|
+
cd my-project
|
|
124
|
+
|
|
125
|
+
# Start building - SpecWeave guides you through the entire workflow
|
|
126
|
+
/specweave:increment "User authentication" # Plan increment
|
|
127
|
+
/specweave:do # Implement tasks (auto-pauses if blocked, auto-resumes when ready)
|
|
128
|
+
/specweave:done 0001 # Complete increment
|
|
129
|
+
```
|
|
130
|
+
|
|
131
|
+
**New to SpecWeave?** → **[Getting Started Guide](https://spec-weave.com/docs/guides/getting-started/quickstart)**
|
|
132
|
+
|
|
133
|
+
---
|
|
134
|
+
|
|
135
|
+
## Key Features
|
|
136
|
+
|
|
137
|
+
### 🧪 Test-Aware Planning
|
|
138
|
+
Embedded test plans in every task with BDD format (Given/When/Then) for clarity
|
|
139
|
+
|
|
140
|
+
### 🎯 Disciplined Progress
|
|
141
|
+
Cannot start increment N+1 until N is DONE - enforces completion before moving forward
|
|
142
|
+
|
|
143
|
+
### ⏸️ Intelligent Status Management
|
|
144
|
+
Automatically detects when you're blocked (missing API keys, waiting for approval), pauses work with clear context, and resumes when ready - no manual intervention needed
|
|
145
|
+
|
|
146
|
+
### 📚 Living Documentation
|
|
147
|
+
Auto-updates after every task via Claude Code hooks - never outdated
|
|
148
|
+
|
|
149
|
+
### 🤖 Intelligent Agents
|
|
150
|
+
PM Agent, Architect, test-aware-planner, Quality Judge - specialized AI agents guide you
|
|
151
|
+
|
|
152
|
+
### 🌍 Multilingual Support
|
|
153
|
+
Work in 9 languages (Russian, Spanish, Chinese, German, French, Japanese, Korean, Portuguese) with zero-cost LLM-native translation
|
|
154
|
+
|
|
155
|
+
**[→ Explore All Features](https://spec-weave.com/docs/overview/features)**
|
|
156
|
+
|
|
157
|
+
---
|
|
158
|
+
|
|
159
|
+
## Enterprise Features
|
|
160
|
+
|
|
161
|
+
### 🏢 Multi-Project Support (v0.8.0+)
|
|
162
|
+
|
|
163
|
+
Organize documentation by team, repo, or microservice:
|
|
164
|
+
|
|
165
|
+
- **Team-Based Organization**: Frontend, Backend, Mobile, Platform teams with separate documentation
|
|
166
|
+
- **Microservices Architecture**: Each service gets its own specs, modules, and team playbooks
|
|
167
|
+
- **Per-Project Sync**: Link projects to different GitHub repos, JIRA projects, or ADO boards
|
|
168
|
+
- **Unified Architecture**: Single project = multi-project with 1 project (NO special cases!)
|
|
169
|
+
|
|
170
|
+
**Five Documentation Types Per Project**:
|
|
171
|
+
1. **specs/** - Living documentation specs (user stories, AC)
|
|
172
|
+
2. **modules/** - Module/component documentation (architecture, APIs)
|
|
173
|
+
3. **team/** - Team playbooks (onboarding, conventions, workflows)
|
|
174
|
+
4. **architecture/** - Project-specific ADRs (optional)
|
|
175
|
+
5. **legacy/** - Brownfield imports (temporary)
|
|
176
|
+
|
|
177
|
+
**[→ Multi-Project Setup Guide](https://spec-weave.com/docs/guides/multi-project-setup)**
|
|
178
|
+
|
|
179
|
+
### 📦 Brownfield Import
|
|
180
|
+
|
|
181
|
+
Import existing documentation from external sources:
|
|
182
|
+
|
|
183
|
+
- **Automatic Classification**: AI-powered keyword detection (85%+ accuracy)
|
|
184
|
+
- **Supported Sources**: Notion, Confluence, GitHub Wiki, custom markdown folders
|
|
185
|
+
- **Smart Organization**: Classifies into specs, modules, team docs, or legacy
|
|
186
|
+
- **Migration Reports**: Complete audit trail with confidence scores and manual review checklist
|
|
187
|
+
|
|
188
|
+
**Example**:
|
|
189
|
+
```bash
|
|
190
|
+
# Import Notion export to web-app project
|
|
191
|
+
/specweave:import-docs ~/Downloads/notion-export --source=notion --project=web-app
|
|
192
|
+
|
|
193
|
+
# Result:
|
|
194
|
+
# ✅ Classified 127 files
|
|
195
|
+
# - 37 specs → projects/web-app/specs/
|
|
196
|
+
# - 18 modules → projects/web-app/modules/
|
|
197
|
+
# - 12 team docs → projects/web-app/team/
|
|
198
|
+
# - 60 legacy → projects/web-app/legacy/notion/
|
|
199
|
+
```
|
|
200
|
+
|
|
201
|
+
**[→ Brownfield Integration Guide](https://spec-weave.com/docs/workflows/brownfield)**
|
|
202
|
+
|
|
203
|
+
---
|
|
204
|
+
|
|
205
|
+
## Documentation Hub
|
|
206
|
+
|
|
207
|
+
**Learn SpecWeave:**
|
|
208
|
+
- 📘 [What is SpecWeave?](https://spec-weave.com/docs/overview/introduction)
|
|
209
|
+
- 🚀 [Quickstart Guide](https://spec-weave.com/docs/guides/getting-started/quickstart)
|
|
210
|
+
- 🏗️ [Complete Workflow Journey](https://spec-weave.com/docs/workflows/overview)
|
|
211
|
+
- ❓ [FAQ - Common Questions](https://spec-weave.com/docs/faq)
|
|
212
|
+
|
|
213
|
+
**Commands & API:**
|
|
214
|
+
- 📋 [Commands Reference](https://spec-weave.com/docs/commands/status-management)
|
|
215
|
+
- 🔧 [API Documentation](https://spec-weave.com/docs/api)
|
|
216
|
+
|
|
217
|
+
**Advanced Topics:**
|
|
218
|
+
- 📊 [DORA Metrics Dashboard](https://spec-weave.com/docs/metrics)
|
|
219
|
+
- 🏢 [Brownfield Integration](https://spec-weave.com/docs/workflows/brownfield)
|
|
220
|
+
- 🌍 [Multilingual Support](https://spec-weave.com/docs/tutorial-extras/multilingual-support)
|
|
221
|
+
- 🔗 [GitHub Actions Setup](https://spec-weave.com/docs/guides/github-action-setup)
|
|
222
|
+
|
|
223
|
+
---
|
|
224
|
+
|
|
225
|
+
## Community & Support
|
|
226
|
+
|
|
227
|
+
**Join the Community:**
|
|
228
|
+
|
|
229
|
+
- 💬 **[Discord Server](https://discord.gg/UYg4BGJ65V)** - Get help, share tips, discuss features
|
|
230
|
+
- 🎥 **[YouTube Channel](https://www.youtube.com/@antonabyzov)** - Tutorials, demos, deep dives
|
|
231
|
+
- 📖 **[Documentation](https://spec-weave.com)** - Complete guides and API reference
|
|
232
|
+
- 🐛 **[GitHub Issues](https://github.com/anton-abyzov/specweave/issues)** - Bug reports and feature requests
|
|
233
|
+
- 💡 **[GitHub Discussions](https://github.com/anton-abyzov/specweave/discussions)** - Q&A and community discussions
|
|
234
|
+
|
|
235
|
+
**Need Help?**
|
|
236
|
+
1. Check the **[FAQ](https://spec-weave.com/docs/faq)** first
|
|
237
|
+
2. Ask in **[Discord](https://discord.gg/UYg4BGJ65V)** for quick answers
|
|
238
|
+
3. Create a **[GitHub Discussion](https://github.com/anton-abyzov/specweave/discussions)** for detailed questions
|
|
239
|
+
|
|
240
|
+
---
|
|
241
|
+
|
|
242
|
+
## Contributing
|
|
243
|
+
|
|
244
|
+
**Development Setup:**
|
|
245
|
+
|
|
246
|
+
```bash
|
|
247
|
+
# Clone and setup
|
|
248
|
+
git clone https://github.com/anton-abyzov/specweave.git
|
|
249
|
+
cd specweave
|
|
250
|
+
npm install
|
|
251
|
+
npm run build
|
|
252
|
+
|
|
253
|
+
# Run tests
|
|
254
|
+
npm test
|
|
255
|
+
```
|
|
256
|
+
|
|
257
|
+
**To Contribute:**
|
|
258
|
+
1. Fork repository
|
|
259
|
+
2. Create feature branch: `git checkout -b features/002-new-feature`
|
|
260
|
+
3. Follow SpecWeave conventions (see CLAUDE.md)
|
|
261
|
+
4. Add tests (minimum 3 test cases)
|
|
262
|
+
5. Create PR to `develop` branch
|
|
263
|
+
|
|
264
|
+
**[→ Contributor Guide](https://spec-weave.com/docs/guides/contributing)**
|
|
265
|
+
|
|
266
|
+
---
|
|
267
|
+
|
|
268
|
+
## Best Results with Claude Code
|
|
269
|
+
|
|
270
|
+
SpecWeave gives **best results with Claude Code** due to unique capabilities:
|
|
271
|
+
|
|
272
|
+
- ✅ **Native Plugin Marketplace** - Skills and agents auto-activate (no manual setup)
|
|
273
|
+
- ✅ **Auto-Activating Skills** - Context-aware activation (no @ mentions)
|
|
274
|
+
- ✅ **Isolated Agent Contexts** - True multi-agent role separation
|
|
275
|
+
- ✅ **Pre/Post Lifecycle Hooks** - Automated living docs sync after every task
|
|
276
|
+
- ✅ **MCP Protocol** - Industry standard for context management
|
|
277
|
+
|
|
278
|
+
**Also works with**: Cursor, GitHub Copilot, ChatGPT (with manual workflow, reduced automation)
|
|
279
|
+
|
|
280
|
+
**[→ Tool Comparison](https://spec-weave.com/docs/overview/features#claude-code-native)**
|
|
281
|
+
|
|
282
|
+
---
|
|
283
|
+
|
|
284
|
+
## Status & License
|
|
285
|
+
|
|
286
|
+
**Status**: Beta - Ready for testing and contributions
|
|
287
|
+
**License**: MIT
|
|
288
|
+
**Repository**: [github.com/anton-abyzov/specweave](https://github.com/anton-abyzov/specweave)
|
|
289
|
+
|
|
290
|
+
---
|
|
291
|
+
|
|
292
|
+
## Acknowledgments
|
|
293
|
+
|
|
294
|
+
SpecWeave is inspired by:
|
|
295
|
+
- [spec-kit](https://github.com/github/spec-kit) - GitHub's specification toolkit
|
|
296
|
+
- [BMAD-METHOD](https://github.com/bmad-code-org/BMAD-METHOD) - Agentic agile framework
|
|
297
|
+
- [Claude Code](https://claude.com/claude-code) - Anthropic's native plugin system
|
|
298
|
+
- [C4 Model](https://c4model.com/) - Software architecture diagrams
|
|
299
|
+
|
|
300
|
+
---
|
|
301
|
+
|
|
302
|
+
**SpecWeave** - AI made us fast. SpecWeave makes us sustainable.
|
|
303
|
+
|
|
304
|
+
**Get started**: `npm install -g specweave` → `specweave init my-project` → **[Read the Docs](https://spec-weave.com)**
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAoBA,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,WAAW,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,
|
|
1
|
+
{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/init.ts"],"names":[],"mappings":"AAoBA,UAAU,WAAW;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAsB,WAAW,CAC/B,WAAW,CAAC,EAAE,MAAM,EACpB,OAAO,GAAE,WAAgB,GACxB,OAAO,CAAC,IAAI,CAAC,CA6qBf"}
|