v0.1.0

SpecLeft v0.1.0 — Initial Beta Release

This is the first public beta of SpecLeft, a planning-first CLI for humans and AI coding agents to externalize feature intent before writing code, with optional CI enforcement for Python projects.

What’s included

🧭 Planning-first workflow

• Convert a prd.md into feature specifications with:

  specleft plan

• Generates human-reviewable feature files under features/*.md
• No code or tests are written by default

🧩 Canonical feature format

• One feature per file
• Scenarios with explicit priorities
• Optional metadata, safe defaults, and predictable parsing

🤖 Agent-aware tooling

• Agent contract introspection:

  specleft contract --format json

• Designed to support autonomous, plan-first agent workflows

🧪 Test skeletons & progress tracking

• Generate test skeletons from declared behaviour
• Identify the next scenario to implement
• Track status and coverage without enforcing by default

🚦 Optional CI enforcement (beta)

• Enforce declared critical/high behaviour using a signed policy:

  specleft enforce <policy.yml>

• Calm, explanatory output intended for real CI pipelines

What this release is (and isn’t)

This is a beta.
The goal of v0.1.0 is to validate:

• agent adoption
• CI tolerance
• intent-first workflows in real projects

SpecLeft:

• does not replace pytest
• does not reinterpret your tests
• does not mutate code unless explicitly requested

License

SpecLeft is source-available under the PolyForm Shield License 1.0.0.
See LICENSE for details.

Feedback

Early feedback is very welcome — especially from:

• platform / principal engineers
• teams experimenting with AI-assisted development
• anyone running SpecLeft in CI

Issues and discussions are open in the repository.

OR

Email at richard@specleft.dev

---

Thanks for trying SpecLeft.