specweave

specweave

Autonomous AI Development Framework. Build production software with specs, tests, and docs that write themselves. Works with Claude, Cursor, Copilot.

Stars: 58

Visit
 screenshot

SpecWeave is a spec-driven Skill Fabric for AI coding agents that allows programming AI in English. It provides first-class support for Claude Code and offers reusable logic for controlling AI behavior. With over 100 skills out of the box, SpecWeave eliminates the need to learn Claude Code docs and handles various aspects of feature development. The tool enables users to describe what they want, and SpecWeave autonomously executes tasks, including writing code, running tests, and syncing to GitHub/JIRA. It supports solo developers, agent teams working in parallel, and brownfield projects, offering file-based coordination, autonomous teams, and enterprise-ready features. SpecWeave also integrates LSP Code Intelligence for semantic understanding of codebases and allows for extensible skills without forking.

README:

SpecWeave

The spec-driven Skill Fabric for AI coding agents. Program your AI in English. Ship features while you sleep.

First-class support for Claude Code — compatible with any LLM-powered coding tool.

NPM Version License: MIT Test & Validate Discord

npm install -g specweave   # Requires Node.js 20.12.0+

What Are Skills?

Skills are programs written in English — not prompts, not templates, but reusable logic that controls how AI thinks, decides, and acts.

Without SpecWeave:                          With SpecWeave:
─────────────────                           ───────────────
"Use React Hook Form with Zod..."           "Add a login form"
"Remember, we use Tailwind..."              → AI already knows your patterns.
"Don't forget the test pattern..."          → It remembered from last time.
"Wait, I told you this yesterday..."        → Fix once, learned permanently.

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.

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.


The Workflow

Just describe what you want. SpecWeave handles the rest.

You: "Build me a checkout flow with Stripe"
  ↓
SpecWeave asks 5-10 clarifying questions
  (What payment methods? Guest checkout? Subscriptions? Which UI library?)
  ↓
Creates: spec.md → plan.md → tasks.md
  ↓
You: "Go ahead and build it"
  → autonomous execution for hours
  (writes code, runs tests, fixes failures, syncs to GitHub/JIRA)
  ↓
You wake up. Review finished work.
  Tests cover technical correctness. You check the UI and UX.
  ↓
You: "Looks good, ship it"
  → validated, documented, shipped.

Solo developer:

You: "I need user authentication with OAuth and magic links"
  → SpecWeave interviews you, creates spec + plan + tasks
You: "Build it"
  → AI works autonomously for hours
You: "Ship it"
  → reviewed, validated, done.

Agent team (parallel):

You: "Build an e-commerce MVP"
  → SpecWeave splits into auth, payments, catalog
  → 3 agents work in parallel across iTerm/tmux panes

Brownfield project:

You: "Migrate the checkout page to React"
  → SpecWeave analyzes existing code, plans strangler fig migration
  → TDD-first autonomous execution
Under the hood — SpecWeave auto-activates these skills from natural language:
You say SpecWeave runs
"Build me X" /sw:increment → spec + plan + tasks
"Go ahead" / "Build it" /sw:auto → autonomous execution
"Ship it" / "We're done" /sw:done → quality gates + close
"Split this into teams" /sw:team-lead → parallel agents
"Review the code" /sw:grill → critical code review

You can also invoke commands directly for fine-grained control.


Why SpecWeave?

AI coding agents are powerful individually. Run three of them on the same codebase and you get conflicts, duplicated work, and zero traceability.

SpecWeave solves this with file-based coordination:

.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

Three Pillars

Programmable AI — Skills are programs in English. Customize any skill's behavior via skill-memories/*.md without forking. Your rules override defaults. Original skills keep getting updates.

Autonomous Teams — Run agent swarms across iTerm/tmux panes. Each agent owns an increment. File-based coordination prevents conflicts. Work on auth, payments, and notifications simultaneously.

Enterprise Ready — Compliance audit trails in git. Brownfield analysis for legacy code. Bidirectional sync with GitHub, JIRA, Azure DevOps. Multi-repo coordination. Production-grade from day one.


Agent Swarms

Run multiple AI agents on the same repository — locally, in the cloud, or with OpenClaw. Each agent owns an isolated increment. No conflicts.

iTerm2 / tmux split panes:
┌──────────────────┬──────────────────┬──────────────────┐
│  Agent 1 (auth)  │ Agent 2 (payments)│ Agent 3 (catalog)│
│  /sw:auto        │  /sw:auto         │  /sw:auto        │
│  ████████░░ 80%  │  ██████░░░░ 60%   │  ████░░░░░░ 40%  │
└──────────────────┴──────────────────┴──────────────────┘

/sw:team-lead "feature" splits work → each agent runs /sw:auto → quality gates ensure consistency → progress syncs to GitHub/JIRA.

Full agent teams guide


Enterprise Ready

SpecWeave is built for the reality of enterprise development.

  • Compliance audit trails — every decision tracked in version-controlled spec files. SOC 2, HIPAA, FDA ready.
  • Brownfield excellence — automated codebase analysis, strangler fig migrations, knowledge preservation. 90%+ of enterprise work is brownfield.
  • Multi-repo coordination — specs reference cross-repo dependencies. Agent teams work across repositories.
  • External sync — GitHub Issues, JIRA, Azure DevOps — bidirectional, real-time. Local-first, works offline.
  • Multi-environment — dev, QA, staging, UAT, production deployment pipelines.

Enterprise documentation


LSP Code Intelligence

AI agents waste tokens on grep — slow, noisy, full of false positives. SpecWeave ships with LSP integration that gives agents semantic understanding of your codebase.

                    Grep (text search)          LSP (semantic)
                    ──────────────────          ──────────────
Speed:              69ms                        0.35ms (198x faster)
"read" symbol:      254 matches                 32 references
False positives:    222 noise results            0

Grep matches read, readFile, readFileSync, readdir, and every comment containing "read". LSP resolves the actual MetadataManager.read() calls — nothing else.

LSP Benchmark Results

Supported languages: TypeScript, Python, Go, Rust, Java, C#

How it works: SpecWeave starts a language server alongside your agent session. Every "find references", "go to definition", and "show type" query goes through the LSP instead of grep — 198x faster with zero false positives.

specweave lsp refs src/core/metadata.ts read     # Semantic references
specweave lsp def src/cli/commands/init.ts init   # Go to definition
specweave lsp hover src/core/config.ts Config     # Type information

LSP documentation


Extensible Skills (Open/Closed Principle)

Customize any skill without forking.

# First time
You: "Generate a login form"
Claude: *creates form with useState*
You: "No, we always use React Hook Form + Zod"

# SpecWeave learns this → .specweave/skill-memories/frontend.md

# Next session — any agent, any skill
You: "Generate a signup form"
Claude: *automatically uses React Hook Form + Zod*
Traditional Tools SpecWeave Skills
Obfuscated behavior Transparent SKILL.md
Can't customize Extend via skill-memories
Vendor lock-in You control the logic
Suggestions only Programmable reasoning

Enable auto-learning:

/sw:reflect-on       # Corrections become permanent knowledge
/sw:reflect-status   # See what Claude has learned

Skills deep dive | Skill development guidelines


Install

npm install -g specweave
cd your-project
specweave init .

Then in Claude Code:

You: "Add dark mode to the app"
→ SpecWeave creates spec, plans architecture, builds it autonomously.

Node.js 20.12.0+ required (22 LTS recommended). Getting SyntaxError? Upgrade instructions.


Core Commands

All commands activate automatically from natural language. Use directly for fine-grained control.

Command Purpose Natural trigger
/sw:increment "feature" Create spec + plan + tasks "Build me X"
/sw:auto Autonomous execution "Go ahead and build it"
/sw:do Execute one task at a time "Do the next task"
/sw:grill Code review before close "Review the code"
/sw:done Close with quality validation "Ship it"
/sw:progress-sync Push to GitHub / JIRA / ADO "Sync progress"
/sw:next Auto-close + suggest next "What's next?"

Full command reference


Integrations

Platform What Syncs
GitHub Issues, PRs, milestones — bidirectional
JIRA Epics, stories, status
Azure DevOps Work items, area paths

When you close an increment, external tools update automatically.


How It Compares

Capability SpecWeave BMAD Method GitHub SpecKit
Parallel agent coordination Increment-scoped isolation No No
Autonomous execution Hours of unattended /sw:auto No No
Agent swarms (iTerm/tmux) Visual parallel monitoring No No
Quality gates Code Grill before every release No No
Living documentation Auto-updated after every task Manual Manual
Self-improving AI Learns from corrections No No
Enterprise compliance SOC 2, HIPAA, FDA audit trails No No
External sync GitHub / JIRA / ADO bidirectional No No
Brownfield support Analyzer + migration patterns No No
LSP code intelligence 198x faster, semantic accuracy No No
Specialized skills 100+ (PM, QA, DevOps, ML...) 21 agents None
Spec/plan/tasks workflow Yes Yes Yes
Agent-agnostic Claude Code + OpenClaw + Copilot + Codex Multi-IDE Multi-IDE

Built With SpecWeave

SpecWeave builds itself. Every feature, bug fix, and release is spec-driven.

Browse increments — see how SpecWeave develops SpecWeave.


Documentation

spec-weave.com — guides, examples, and full reference.

Community

Discord · YouTube · GitHub Issues

License

MIT — github.com/anton-abyzov/specweave

For Tasks:

Click tags to check more tools for each tasks

For Jobs:

Alternative AI tools for specweave

Similar Open Source Tools

For similar tasks

For similar jobs