specweave 1.0.497 → 1.0.498
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/package.json
CHANGED
|
@@ -1,6 +1,6 @@
|
|
|
1
1
|
{
|
|
2
2
|
"name": "specweave",
|
|
3
|
-
"version": "1.0.
|
|
3
|
+
"version": "1.0.498",
|
|
4
4
|
"description": "100+ domain-expert AI skills — PM, Architect, Frontend, QA, Security and more. Skills learn your team's patterns permanently. Spec-first planning, autonomous execution, multi-agent teams, synced to GitHub/JIRA. Claude Code, Cursor, Copilot & more.",
|
|
5
5
|
"type": "module",
|
|
6
6
|
"main": "dist/index.js",
|
|
@@ -2,7 +2,7 @@
|
|
|
2
2
|
|
|
3
3
|
**A SpecWeave project** - where specifications drive development.
|
|
4
4
|
|
|
5
|
-
##
|
|
5
|
+
## Quick Start
|
|
6
6
|
|
|
7
7
|
Your project is initialized! Now describe what you want to build.
|
|
8
8
|
|
|
@@ -14,16 +14,16 @@ Your project is initialized! Now describe what you want to build.
|
|
|
14
14
|
|
|
15
15
|
```bash
|
|
16
16
|
# Plan a new feature
|
|
17
|
-
/
|
|
17
|
+
/sw:increment "user authentication with JWT"
|
|
18
18
|
|
|
19
19
|
# Execute the implementation
|
|
20
|
-
/
|
|
20
|
+
/sw:do
|
|
21
21
|
|
|
22
22
|
# Check progress
|
|
23
|
-
/
|
|
23
|
+
/sw:progress
|
|
24
24
|
|
|
25
25
|
# Close when done
|
|
26
|
-
/
|
|
26
|
+
/sw:done 0001
|
|
27
27
|
```
|
|
28
28
|
|
|
29
29
|
3. **Or describe your project** in natural language (works with slash command workflows):
|
|
@@ -36,127 +36,113 @@ Your project is initialized! Now describe what you want to build.
|
|
|
36
36
|
|
|
37
37
|
4. **SpecWeave will automatically**:
|
|
38
38
|
- Detect your tech stack (or ask you to choose)
|
|
39
|
-
- Use the right agents
|
|
39
|
+
- Use the right agents and skills (all pre-installed)
|
|
40
40
|
- Create strategic documentation
|
|
41
41
|
- Generate specifications (spec.md, plan.md, tasks.md)
|
|
42
42
|
- Guide implementation
|
|
43
43
|
- Generate tests
|
|
44
44
|
|
|
45
|
-
That's it! All components ready - just use `/
|
|
45
|
+
That's it! All components ready - just use `/sw:increment` to start!
|
|
46
46
|
|
|
47
47
|
---
|
|
48
48
|
|
|
49
|
-
##
|
|
49
|
+
## Project Structure
|
|
50
50
|
|
|
51
51
|
```
|
|
52
52
|
{{PROJECT_NAME}}/
|
|
53
53
|
├── .specweave/ # SpecWeave framework
|
|
54
54
|
│ ├── config.json # Project configuration
|
|
55
|
-
│ ├── increments/ # Features (created via /
|
|
55
|
+
│ ├── increments/ # Features (created via /sw:increment)
|
|
56
56
|
│ │ └── 0001-feature/
|
|
57
57
|
│ │ ├── spec.md # WHAT & WHY
|
|
58
58
|
│ │ ├── plan.md # HOW
|
|
59
59
|
│ │ ├── tasks.md # Implementation steps
|
|
60
|
-
│ │ ├── tests.md # Test strategy
|
|
61
|
-
│ │ ├── logs/ # Execution logs
|
|
62
|
-
│ │ ├── scripts/ # Helper scripts
|
|
63
60
|
│ │ └── reports/ # Analysis reports
|
|
64
|
-
│
|
|
65
|
-
│
|
|
66
|
-
│
|
|
67
|
-
│ └── tests/ # Centralized test repository
|
|
68
|
-
├── .claude/ # Claude Code integration (optional)
|
|
69
|
-
│ ├── commands/ # Slash commands (10 installed)
|
|
70
|
-
│ ├── agents/ # AI agents (10 installed)
|
|
71
|
-
│ └── skills/ # AI skills (35+ installed)
|
|
61
|
+
│ └── docs/ # Strategic documentation
|
|
62
|
+
│ ├── internal/ # Internal docs (strategy, architecture)
|
|
63
|
+
│ └── public/ # Published docs
|
|
72
64
|
├── CLAUDE.md # Instructions for AI assistant
|
|
73
65
|
└── README.md # This file
|
|
74
66
|
```
|
|
75
67
|
|
|
76
68
|
---
|
|
77
69
|
|
|
78
|
-
##
|
|
70
|
+
## What is SpecWeave?
|
|
79
71
|
|
|
80
72
|
SpecWeave is a specification-first development framework where:
|
|
81
73
|
- **Specifications are the source of truth** (code follows specs, not reverse)
|
|
82
|
-
- **Slash commands drive workflow** (`/
|
|
74
|
+
- **Slash commands drive workflow** (`/sw:increment` → `/sw:do` → `/sw:done`)
|
|
83
75
|
- **AI agents work autonomously** (PM, Architect, Security, QA, DevOps)
|
|
84
|
-
- **All components pre-installed** (10 agents + 35+ skills ready!)
|
|
85
76
|
- **Works with ANY tech stack** (TypeScript, Python, Go, Rust, Java, .NET, etc.)
|
|
86
77
|
- **Works with multiple AI assistants** (Claude Code, Cursor, Windsurf, etc.)
|
|
87
78
|
|
|
88
79
|
---
|
|
89
80
|
|
|
90
|
-
##
|
|
81
|
+
## Core Workflow
|
|
91
82
|
|
|
92
83
|
```
|
|
93
|
-
/
|
|
84
|
+
/sw:increment "feature" → /sw:do → /sw:progress → /sw:done → repeat
|
|
94
85
|
```
|
|
95
86
|
|
|
96
87
|
| Command | Purpose | When to Use |
|
|
97
88
|
|---------|---------|-------------|
|
|
98
|
-
| `/
|
|
99
|
-
| `/
|
|
100
|
-
| `/
|
|
101
|
-
| `/
|
|
102
|
-
| `/
|
|
103
|
-
| `/
|
|
104
|
-
| `/specweave:sync-jira` | Sync to Jira | Export to Jira |
|
|
89
|
+
| `/sw:increment "feature"` | Plan new increment | Starting new feature |
|
|
90
|
+
| `/sw:do` | Execute tasks | Ready to implement |
|
|
91
|
+
| `/sw:progress` | Check status | Want to see progress |
|
|
92
|
+
| `/sw:validate 0001` | Validate quality | Before completion |
|
|
93
|
+
| `/sw:done 0001` | Close increment | Feature finished |
|
|
94
|
+
| `/sw:progress-sync` | Sync to external tools | Export to GitHub/JIRA/ADO |
|
|
105
95
|
|
|
106
96
|
See `CLAUDE.md` for complete workflow guide.
|
|
107
97
|
|
|
108
98
|
---
|
|
109
99
|
|
|
110
|
-
##
|
|
100
|
+
## File Organization
|
|
111
101
|
|
|
112
102
|
**Keep project root clean!** All AI-generated files go into increment folders:
|
|
113
103
|
|
|
114
104
|
```
|
|
115
|
-
|
|
105
|
+
CORRECT:
|
|
116
106
|
.specweave/increments/0001-auth/
|
|
117
|
-
├──
|
|
118
|
-
|
|
119
|
-
└── reports/analysis.md
|
|
107
|
+
├── reports/analysis.md
|
|
108
|
+
└── logs/execution.log
|
|
120
109
|
|
|
121
|
-
|
|
110
|
+
WRONG:
|
|
122
111
|
project-root/
|
|
123
|
-
├── execution.log
|
|
124
|
-
|
|
125
|
-
└── analysis.md # NO!
|
|
112
|
+
├── execution.log
|
|
113
|
+
└── analysis.md
|
|
126
114
|
```
|
|
127
115
|
|
|
128
116
|
---
|
|
129
117
|
|
|
130
|
-
##
|
|
118
|
+
## AI Assistant Compatibility
|
|
131
119
|
|
|
132
120
|
SpecWeave works with:
|
|
133
|
-
-
|
|
134
|
-
-
|
|
135
|
-
-
|
|
136
|
-
-
|
|
137
|
-
- ✅ **Any AI IDE** - As long as it supports slash commands or custom prompts
|
|
121
|
+
- **Claude Code** (recommended) - Full slash command support
|
|
122
|
+
- **Cursor** - Slash commands via composer
|
|
123
|
+
- **Windsurf** - Cascade mode compatible
|
|
124
|
+
- **Any AI IDE** - As long as it supports slash commands or custom prompts
|
|
138
125
|
|
|
139
126
|
**Setup**: See `CLAUDE.md` for AI assistant instructions.
|
|
140
127
|
|
|
141
128
|
---
|
|
142
129
|
|
|
143
|
-
##
|
|
130
|
+
## Learn More
|
|
144
131
|
|
|
145
132
|
- **Documentation**: https://verified-skill.com
|
|
146
133
|
- **GitHub**: https://github.com/anton-abyzov/specweave
|
|
147
134
|
- **Quick Reference**: See `CLAUDE.md` in your project
|
|
148
|
-
- **Examples**: Check `.specweave/docs/` after creating your first increment
|
|
149
135
|
|
|
150
136
|
---
|
|
151
137
|
|
|
152
|
-
##
|
|
138
|
+
## Ready to Build?
|
|
153
139
|
|
|
154
140
|
**Start with your first feature**:
|
|
155
141
|
```bash
|
|
156
|
-
/
|
|
142
|
+
/sw:increment "describe your feature here"
|
|
157
143
|
```
|
|
158
144
|
|
|
159
|
-
Or just describe what you want to build, and SpecWeave will guide you through the process!
|
|
145
|
+
Or just describe what you want to build, and SpecWeave will guide you through the process!
|
|
160
146
|
|
|
161
147
|
---
|
|
162
148
|
|
|
@@ -159,10 +159,10 @@ Before closing this increment, the following MUST be true:
|
|
|
159
159
|
**Validation commands**:
|
|
160
160
|
```bash
|
|
161
161
|
# Check AC coverage and task linkage
|
|
162
|
-
/
|
|
162
|
+
/sw:validate {{INCREMENT_ID}}
|
|
163
163
|
|
|
164
164
|
# Close increment (validates automatically)
|
|
165
|
-
/
|
|
165
|
+
/sw:done {{INCREMENT_ID}}
|
|
166
166
|
```
|
|
167
167
|
|
|
168
168
|
---
|