docusaurus

```bash

/sw:increment "User authentication"

/sw:auto # Ship while you sleep

```

What happens:

• AI creates spec + plan + tasks
• Executes autonomously for hours
• Tests, fixes failures, syncs to GitHub/JIRA
• You review finished work

```

[08:23:41] [Planning] Analyzing T-003: Implement refresh token rotation

[08:24:12] [Implementing] Writing src/auth/token-manager.ts

[08:25:33] [Testing] Running tests... FAILED

[08:25:47] [Fixing] Adjusting implementation...

[08:26:15] [Testing] Re-running... PASSED

[08:26:22] [Done] T-003 complete. Moving to T-004...

```

---

Every AI coding tool loses context when the chat ends. SpecWeave creates permanent documentation:

```

.specweave/increments/0001-oauth/

├── spec.md <- WHAT: User stories, acceptance criteria

├── plan.md <- HOW: Architecture decisions, tech choices

└── tasks.md <- DO: Implementation tasks with tests

```

After 6 months: Search "OAuth" → find exact decisions, who approved, why it was built that way.

---

Lazy Plugin Loading (99% Token Savings)

SpecWeave loads plugins on-demand based on your prompt keywords:

| Scenario | Without Lazy Loading | With Lazy Loading |

|----------|---------------------|-------------------|

| Non-SpecWeave work | ~60k tokens | ~500 tokens |

| SpecWeave work | ~60k tokens | ~60k (when needed) |

Say "React frontend" → frontend plugin loads. Say "Kubernetes deploy" → k8s plugin loads. No manual configuration.

Self-Improving Skills

SpecWeave learns from corrections. When you fix something, it captures the learning:

```markdown

• Always use vi.hoisted() for ESM mocking in Vitest 4.x+
• Prefer native fs over fs-extra in new code

```

Next time, it won't make the same mistake.

Structured Documentation (No Root Bloat)

Everything stays organized in .specweave/:

```

.specweave/

├── increments/####-name/ # Feature specs + tasks

├── docs/internal/ # Living documentation

│ ├── architecture/adr/ # Architecture Decision Records

│ └── specs/ # Feature specifications

└── config.json # Project configuration

```

Your project root stays clean. No scattered markdown files.

15+ AI Agents Working Together

| Agent | Role |

|-------|------|

| PM | Requirements, user stories, acceptance criteria |

| Architect | System design, ADRs, tech decisions |

| QA Lead | Test strategy, quality gates |

| Security | OWASP review, vulnerability scanning |

| DevOps | CI/CD, infrastructure, deployment |

Agents auto-activate based on context. Mention "security" → security expertise loads.

---

Prerequisites

Node.js 20.12.0+ required (recommend Node.js 22 LTS).

```bash

node --version # Check version

```

> Getting SyntaxError: Unexpected token 'with'? Your Node.js is too old. [Upgrade instructions →](https://spec-weave.com/docs/guides/troubleshooting/common-err