SpecCraft

Spec-driven development for AI coding assistants

SpecCraft brings structure to AI-assisted development by adding a lightweight "spec layer" to your workflow. Before any code is written, you and your AI assistant align on what to build through structured specifications.

🚀 Quick Start

# Install the CLI
bun install -g @speccraft/cli

# Initialize in your project
cd your-project
speccraft init

# Create your first spec
speccraft propose add-dark-mode --description "Add dark mode toggle"

# Generate tasks
speccraft tasks add-dark-mode

# View all specs
speccraft list

📦 Packages

Package	Version	Description
@speccraft/cli		CLI tool for spec-driven development
@speccraft/core		Core library for spec management

🎯 Philosophy

• Fluid not rigid — Update specs anytime, no phase gates
• Iterative not waterfall — Build, test, refine continuously
• Easy not complex — Simple CLI commands, minimal ceremony
• Built for brownfield — Works with existing projects
• Scalable — From personal projects to enterprise teams

📚 Documentation

Visit our documentation site for:

• Getting Started
• CLI Reference
• Core Concepts

🛠️ Development

# Clone the repository
git clone https://github.com/iAziz786/speccraft.git
cd speccraft

# Install dependencies
bun install

# Run tests
bun test

# Build CLI
bun run build:cli

# Run CLI locally
./speccraft --help

📄 License

MIT © Aziz

---

Built with 💜 for developers who value clarity