Specil

Specil is a minimal and helpful tool for Spec-Driven Development.

https://github.com/user-attachments/assets/f56a15a3-b0b5-4446-8ca6-14c7bb50315a

What is Spec-Driven Development?

Spec-Driven Development is a development methodology that focuses on writing specifications before writing code.

Core Philosophy

Generate spec and code from an SSOT, inspired by DB migration tools.

Get Started

$3

``bash
npx specil setup
`

$3

SSOT is located at:
- .specil/_spec/_ARCHITECTURE.md
- .specil/_spec/feat/{feature-name}/spec.md

$3

Note: Please run this tool inside an AI Agent console (e.g., Claude Code).

`bash
npx specil run apply-spec
`

Generated spec will be saved to .specil/_spec-migration/{timestamp}/spec.md.

$3

Note: Please run this tool inside an AI Agent console (e.g., Claude Code).

`bash
npx specil run apply-code
`

$3

`bash
npx specil run review
`

CLI Reference

| Command | Description |
|-----------------------------|--------------------------|
| npx specil setup | Setup Specil environment |
| npx specil run apply-spec | Generate spec |
| npx specil run apply-code` | Generate code |

Support

Please send feedback to @jtakahashi0604.

License

MIT