wassden

Spec-Driven Development MCP server that transforms any LLM into a systematic development agent

🚀 Generate requirements → design → tasks → code with 100% traceability and validation

⚡ Quick Start (MCP)

# Add to Claude Code
claude mcp add wassden -- uvx --from git+https://github.com/tokusumi/wassden-mcp wassden start-mcp-server --transport stdio

# Test it
uvx --from git+https://github.com/tokusumi/wassden-mcp wassden prompt-requirements --userInput "Create a TODO app"

🎯 What It Does

✅ Requirements → Design → Tasks → Code - Complete SDD workflow with structured prompts
🔒 100% READ-ONLY - No file modification risk, only analysis and prompt generation
🌍 Auto Language Detection - Seamless Japanese/English support
⚡ Ultra-fast Performance - <0.01ms response time with 405+ tests passing
📊 100% Traceability - Complete REQ↔DESIGN↔TASK mapping enforcement

📦 Installation

Prerequisites

uv package manager (pip install uv)
MCP-compatible client (Claude Code, Cursor, GitHub Copilot, etc.)

Claude Code

claude mcp add wassden -- uvx --from git+https://github.com/tokusumi/wassden-mcp wassden start-mcp-server --transport stdio

Cursor, GitHub Copilot, Other MCP Clients

Edit your MCP settings file:

{
  "mcpServers": {
    "wassden": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/tokusumi/wassden-mcp",
        "wassden",
        "start-mcp-server",
        "--transport",
        "stdio"
      ]
    }
  }
}

📚 For detailed setup and development installation, see docs/development.md

🚀 Basic Usage

1. Analyze & Generate Requirements

# Analyze project description and generate requirements prompt
uvx --from git+https://github.com/tokusumi/wassden-mcp wassden prompt-requirements \
  --userInput "Create a task management API with authentication"

2. Validate Generated Specs

# Validate specifications with auto language detection
uvx --from git+https://github.com/tokusumi/wassden-mcp wassden validate-requirements specs/my-feature/requirements.md
uvx --from git+https://github.com/tokusumi/wassden-mcp wassden validate-design specs/my-feature/design.md  
uvx --from git+https://github.com/tokusumi/wassden-mcp wassden validate-tasks specs/my-feature/tasks.md

3. Get Traceability Matrix

# Generate complete dependency mapping
uvx --from git+https://github.com/tokusumi/wassden-mcp wassden get-traceability

🛠️ Core Tools

Requirements Generation

prompt-requirements - Analyzes input for completeness and generates EARS requirements prompt
- Default: Checks completeness, asks questions if incomplete, generates prompt if complete
- --force: Skip completeness verification and generate requirements prompt

Design & Planning

prompt-design - Generates architectural design prompt from requirements
prompt-tasks - Creates WBS task breakdown prompt from design

Validation Suite

validate-requirements - Ensures EARS format and completeness
validate-design - Checks architectural consistency
validate-tasks - Verifies task dependencies and coverage

Traceability & Analysis

get-traceability - Complete REQ↔DESIGN↔TASK dependency mapping
analyze-changes - Impact analysis for specification changes
generate-review-prompt - Task-specific implementation review

📚 See full tool documentation for detailed usage and examples

📊 Performance

Response Time: <0.01ms average (ultra-fast analysis)
Test Coverage: 405+ tests with 100% passing
Memory Efficient: <50MB growth per 1000 operations
Concurrent Support: Handles 20+ parallel tool calls efficiently

🧪 Run benchmarks: python benchmarks/run_all.py

🧪 Development Mode Features (Experimental)

⚠️ NOTE: Experimental features for internal validation and benchmarking. Requires dev installation.

The experiment framework provides validation and benchmarking capabilities for the wassden toolkit itself. These features are only available in development mode:

# Install with dev dependencies
git clone https://github.com/tokusumi/wassden-mcp
cd wassden-mcp
uv sync  # Installs all dependencies including dev extras

# Run experiments (dev mode only)
uv run wassden experiment run ears        # EARS pattern validation
uv run wassden experiment run performance # Performance benchmarking  
uv run wassden experiment run language    # Language detection testing

Key Capabilities

Statistical Analysis: Mean, variance, confidence intervals (REQ-04)
Experiment Management: Save/load/compare configurations (REQ-05, REQ-06)
Comparative Analysis: Statistical significance testing (REQ-07)
Resource Constraints: 10-minute timeout, 100MB memory limit (NFR-01, NFR-02)

📚 See Experiment Framework Documentation for detailed usage

🎯 Use Cases

Development Teams: Systematic requirements gathering and project planning
AI Agents: Structured prompts for complex development workflows
Technical Writers: Automated documentation validation and traceability
Quality Assurance: Built-in validation with actionable feedback

📚 Documentation

Getting Started - Installation and first steps
Tool Reference - Complete tool documentation
Spec Format Guide - Requirements, design, and tasks format
Validation Rules - EARS format and traceability requirements
Validation System - Comprehensive validation with AST-based analysis
Development - Development setup and contributing
Experiment Framework - Experimental validation features (dev only)
Examples - Sample specifications (Japanese/English)

🤝 Contributing

Contributions are welcome! See docs/development.md for development setup.

make check  # Run all quality checks before committing

📄 License

MIT License - see LICENSE file for details.

Built with ❤️ for the AI-driven development community