specweave 1.0.435 → 1.0.437

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 (2) hide show
  1. package/README.md +63 -31
  2. package/package.json +2 -2
package/README.md CHANGED
@@ -1,6 +1,8 @@
1
1
  # SpecWeave
2
2
 
3
- **The spec-driven Skill Fabric for AI coding agents.** Program your AI in English. Ship features while you sleep.
3
+ **AI-assisted development, under control.**
4
+
5
+ Your AI responds to natural language — and now follows a structured, spec-first, quality-gated process every time. Configure your standards once. Every developer, every AI tool, every session enforces them automatically.
4
6
 
5
7
  *Works with Claude Code, Cursor, Copilot, Codex, Antigravity & any LLM-powered coding tool.*
6
8
 
@@ -15,36 +17,61 @@ npm install -g specweave # Requires Node.js 20.12.0+
15
17
 
16
18
  ---
17
19
 
18
- ## What Are Skills?
20
+ ## No Commands to Memorize
19
21
 
20
- **Skills are programs written in English** — not prompts, not templates, but reusable logic that controls how AI thinks, decides, and acts.
22
+ SpecWeave is not a workflow you switch into. It is a behavior layer that changes how your AI works — installed once, active in every conversation.
21
23
 
22
- ```
23
- Without SpecWeave: With SpecWeave:
24
- ───────────────── ───────────────
25
- "Use React Hook Form with Zod..." "Add a login form"
26
- "Remember, we use Tailwind..." → AI already knows your patterns.
27
- "Don't forget the test pattern..." → It remembered from last time.
28
- "Wait, I told you this yesterday..." → Fix once, learned permanently.
29
- ```
24
+ When you describe what you want, your AI routes internally to the right skill. You just work naturally:
30
25
 
31
- Each skill is a **programmable AI behavior** you can customize without forking. Fix once, remembered permanently. 100+ skills ship out of the box — PM, Architect, QA, Security, DevOps, Frontend, Backend, Mobile, ML.
26
+ | You say | Your AI runs — automatically |
27
+ |---------|------------------------------|
28
+ | "Build me X" / "Let's add Y" | `/sw:increment` → spec + plan + tasks |
29
+ | "Go ahead" / "Build it" | `/sw:auto` → autonomous execution |
30
+ | "Ship it" / "We're done" | `/sw:done` → quality gates + close |
31
+ | "Split this into teams" | `/sw:team-lead` → parallel agents |
32
+ | "Review the code" | `/sw:grill` → critical code review |
32
33
 
33
- **You don't need to learn Claude Code docs.** SpecWeave handles hooks, plugins, CLAUDE.md, and context management for you. Install, describe your feature, skills do the rest.
34
+ You can also invoke these directly for fine-grained control — but you rarely need to.
35
+
36
+ ---
37
+
38
+ ## What You Control
39
+
40
+ SpecWeave's behavior is driven by configuration. Define your standards once; every AI interaction in your project enforces them.
41
+
42
+ ```json
43
+ // .specweave/config.json
44
+ {
45
+ "testing": {
46
+ "defaultTestMode": "TDD", // AI always follows red-green-refactor
47
+ "tddEnforcement": "strict" // Tasks cannot close without passing tests
48
+ },
49
+ "quality": {
50
+ "grillRequired": true, // Code review gate before every close
51
+ "judgeLlmRequired": true // Independent AI validation gate
52
+ },
53
+ "sync": {
54
+ "github": true, // Auto-sync to GitHub Issues / PRs
55
+ "jira": true // Bidirectional JIRA sync on close
56
+ }
57
+ }
58
+ ```
59
+
60
+ This is the difference between **asking** an AI to follow a process and **configuring** it to. No prompting required. No hoping it remembers. The config is the contract.
34
61
 
35
62
  ---
36
63
 
37
64
  ## The Workflow
38
65
 
39
- Just describe what you want. SpecWeave handles the rest.
66
+ Just describe what you want. Your AI handles the orchestration.
40
67
 
41
68
  ```
42
69
  You: "Build me a checkout flow with Stripe"
43
70
  ↓
44
- SpecWeave asks 5-10 clarifying questions
71
+ AI asks 5-10 clarifying questions
45
72
  (What payment methods? Guest checkout? Subscriptions? Which UI library?)
46
73
  ↓
47
- Creates: spec.md → plan.md → tasks.md
74
+ Creates: spec.md → plan.md → tasks.md ← you review the plan here
48
75
  ↓
49
76
  You: "Go ahead and build it"
50
77
  → autonomous execution for hours
@@ -54,13 +81,13 @@ You wake up. Review finished work.
54
81
  Tests cover technical correctness. You check the UI and UX.
55
82
  ↓
56
83
  You: "Looks good, ship it"
57
- → validated, documented, shipped.
84
+ → validated, documented, closed.
58
85
  ```
59
86
 
60
87
  **Solo developer:**
61
88
  ```
62
89
  You: "I need user authentication with OAuth and magic links"
63
- → SpecWeave interviews you, creates spec + plan + tasks
90
+ → AI interviews you, creates spec + plan + tasks
64
91
  You: "Build it"
65
92
  → AI works autonomously for hours
66
93
  You: "Ship it"
@@ -81,23 +108,28 @@ You: "Migrate the checkout page to React"
81
108
  → TDD-first autonomous execution
82
109
  ```
83
110
 
84
- <details>
85
- <summary><strong>Under the hood</strong> — SpecWeave auto-activates these skills from natural language:</summary>
111
+ ---
86
112
 
87
- | You say | SpecWeave runs |
88
- |---------|---------------|
89
- | "Build me X" | `/sw:increment` → spec + plan + tasks |
90
- | "Go ahead" / "Build it" | `/sw:auto` → autonomous execution |
91
- | "Ship it" / "We're done" | `/sw:done` → quality gates + close |
92
- | "Split this into teams" | `/sw:team-lead` → parallel agents |
93
- | "Review the code" | `/sw:grill` → critical code review |
113
+ ## What Are Skills?
114
+
115
+ **Skills are programs written in English** — not prompts, not templates, but reusable logic that controls how AI thinks, decides, and acts.
94
116
 
95
- You can also invoke commands directly for fine-grained control.
96
- </details>
117
+ ```
118
+ Without SpecWeave: With SpecWeave:
119
+ ───────────────── ───────────────
120
+ "Use React Hook Form with Zod..." "Add a login form"
121
+ "Remember, we use Tailwind..." → AI already knows your patterns.
122
+ "Don't forget the test pattern..." → It remembered from last time.
123
+ "Wait, I told you this yesterday..." → Fix once, learned permanently.
124
+ ```
125
+
126
+ Each skill is a **programmable AI behavior** you can customize without forking. Fix once, remembered permanently. 100+ skills ship out of the box — PM, Architect, QA, Security, DevOps, Frontend, Backend, Mobile, ML.
127
+
128
+ **You don't need to learn Claude Code docs.** SpecWeave handles hooks, plugins, CLAUDE.md, and context management for you. Install, describe your feature, skills do the rest.
97
129
 
98
130
  ---
99
131
 
100
- ## Why SpecWeave?
132
+ ## Why Spec-First?
101
133
 
102
134
  **The plan is more important than the code.**
103
135
 
@@ -271,7 +303,7 @@ You: "Add dark mode to the app"
271
303
 
272
304
  ## Core Commands
273
305
 
274
- All commands activate automatically from natural language. Use directly for fine-grained control.
306
+ These run automatically from natural language — see the table above. Use directly when you want fine-grained control.
275
307
 
276
308
  | Command | Purpose | Natural trigger |
277
309
  |---------|---------|----------------|
package/package.json CHANGED
@@ -1,7 +1,7 @@
1
1
  {
2
2
  "name": "specweave",
3
- "version": "1.0.435",
4
- "description": "Spec-driven development framework for AI coding agents. Works with Claude Code, Codex, Antigravity, Cursor, Copilot & more. 100+ skills, 49 CLI commands, verified skill certification, autonomous execution, and living documentation.",
3
+ "version": "1.0.437",
4
+ "description": "AI-assisted development, under control. Configure your standards once — spec-first, TDD, quality gates — and every AI interaction enforces them automatically. Works with Claude Code, Cursor, Copilot, Codex & more.",
5
5
  "type": "module",
6
6
  "main": "dist/index.js",
7
7
  "bin": {