Magic Specification-Driven Development (SDD) Workflow
Project description
🪄 Magic Spec
The Specification-Driven Development (SDD) Operating System for AI Agents.
Stop your AI from writing code before it understands the problem. magic-spec installs a high-performance, structured pipeline — Thought → Spec → Task → Run → Code — directly into any project.
✨ Features
- 🏗️ Deterministic Pipeline: Forced structure ensures architectural integrity.
- 🎯 Multi-Agent Core: Works with Cursor, Windsurf, Claude, Gemini, and more.
- 🔍 Auto-Retrospective: Built-in self-analysis engine that improves your workflow automatically.
- 📦 Thin-Client Installers: Lightweight Node.js and Python installers for zero-friction setup.
- 🗺️ Phased Planning: Intelligent dependency tracking and implementation roadmaps.
🚀 Quick Start
Works with any project — Rust, Go, Python, JavaScript, C++, or anything else.
Option A: Node.js (npx)
npx magic-spec@latest
Option B: Python (uvx)
uvx magic-spec
What happens next?
- Magic Spec deploys the
.magic/engine and.agent/workflows. - An interactive onboarding tutorial (
magic.onboard) helps you and your AI get started. - Your project gains a dedicated
.design/workspace for Specifications, Rules, and Plans.
🧭 The Workflow
- Specification: Convert raw ideas into formal, versioned specs.
- Task & Plan: Generate a phased roadmap with atomic, trackable tasks.
- Run: Execute the plan with automatic progress tracking and quality gates.
- Rule: Manage project conventions in a central
RULES.mdconstitution.
📖 Documentation & Guides
- Main Documentation — Detailed guide on workflows and architecture.
- Installers Guide — Advanced CLI options and platform specifics.
- Contributing — How to develop and extend the engine.
🤝 Compatibility
Magic Spec is optimized for the world's most powerful AI development environments:
- Cursor (Rule definitions & Agent Mode)
- Windsurf (Cascade & Flows)
- GitHub Copilot (Custom Instructions)
- Claude (Project context)
📄 License
Distributed under the MIT License.
© 2026 Oleg Alexandrov & teratron. ✨
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file magic_spec-1.3.0.tar.gz.
File metadata
- Download URL: magic_spec-1.3.0.tar.gz
- Upload date:
- Size: 12.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ed287fa2b136d8f905c6101338667d1129fb0aea2a6c1832e9a69e85c0445e2b
|
|
| MD5 |
f0e7d7f467be37f4f4434f3e73ffd89c
|
|
| BLAKE2b-256 |
ac143352fd060cb8b56bac1b5adbb9f999d0c14dec132ad95fe7669611677237
|
File details
Details for the file magic_spec-1.3.0-py3-none-any.whl.
File metadata
- Download URL: magic_spec-1.3.0-py3-none-any.whl
- Upload date:
- Size: 12.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.10.4 {"installer":{"name":"uv","version":"0.10.4","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":null,"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":null}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
9e32af92594fa8710b1bf0c1e422faed25644bf578530097b2b4c350605543eb
|
|
| MD5 |
f21ee2e54d0a9bceb8721191065680e7
|
|
| BLAKE2b-256 |
168d3e7a4bc65ef17fdc7623b7002442d83e6cea530a08f59dcd7645529c6832
|
