A strict Spec Agent workflow for spec-driven development
Project description
Spec Agent CLI
Spec Agent turns unclear feature requests into approved, product-only specifications
before any implementation planning begins. It installs three Agent Skills under the
open .agents/skills convention and keeps specification evolution and code drift
observation available without mixing them into implementation work.
Install
Python 3.11 or newer is required.
uv tool install spec-agent-cli
Alternatives:
pipx install spec-agent-cli
pip install spec-agent-cli
Initialize a repository
cd /path/to/your-project
spec-agent init
This creates only missing project files and installs:
.agents/skills/spec-request-flow/
.agents/skills/spec-drift-sync/
.agents/skills/spec-evolution/
AGENTS.md # managed rules block; user content is preserved
SPEC.md # created only when absent
spec/features/
spec/evolution/events.jsonl
spec/evolution/timeline.md
spec/traceability.json
Use spec-agent init --check for a read-only status check. Use
spec-agent init --force to refresh locally modified managed skill files after a CLI
upgrade. --force never replaces project specifications or history.
Start a feature
Ask a compatible agent:
Use spec-request-flow to define feature X. Do not implement it.
The Spec Agent repeatedly clarifies blocking product questions, compares meaningful
product approaches, writes spec.md and acceptance.md, asks for approval, records
the approved product evolution, and then gives you the prompt for a separate Code
Agent.
License
MIT
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 spec_agent_cli-0.1.0.tar.gz.
File metadata
- Download URL: spec_agent_cli-0.1.0.tar.gz
- Upload date:
- Size: 28.2 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
3ec7e4d1eaa1182e1feb852fb25d3c00cfaa073e9435932d31a3d9bfff185283
|
|
| MD5 |
25c5ca040e2b93e4b90d7a31cba3541d
|
|
| BLAKE2b-256 |
51fc5b26ceaabdccb5457f15a6721e78ab6720c558f078cfa6b90421513b74b8
|
File details
Details for the file spec_agent_cli-0.1.0-py3-none-any.whl.
File metadata
- Download URL: spec_agent_cli-0.1.0-py3-none-any.whl
- Upload date:
- Size: 27.5 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: uv/0.11.29 {"installer":{"name":"uv","version":"0.11.29","subcommand":["publish"]},"python":null,"implementation":{"name":null,"version":null},"distro":{"name":"Ubuntu","version":"24.04","id":"noble","libc":null},"system":{"name":null,"release":null},"cpu":null,"openssl_version":null,"setuptools_version":null,"rustc_version":null,"ci":true}
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0c65312641d4f4c7877e2d4980645da624e6523d087c16b846d45d8c084ce4e2
|
|
| MD5 |
200b5d760d9152e383f78760b1aeddc4
|
|
| BLAKE2b-256 |
f882a62f40cadda8e3c94320df92ba44a53231f093e2032bf732ad919046580e
|
