Spec-driven SDLC skills for AI coding agents — Claude Code, Cursor, Windsurf, Gemini CLI
Project description
ai-sdlc-kit
Spec-driven SDLC skills that make AI coding agents work like real engineers.
What is it?
ai-sdlc-kit installs a set of skills for Claude Code, Cursor, Windsurf, and Gemini CLI that take an agent through a real engineering workflow instead of one-shot code generation:
understand → decide → plan in verifiable steps → build with checks after every step → gate → ship
| Skill | Does |
|---|---|
sdlc-init |
One-time project setup: stack, layout, commands, conventions |
roadmap |
Splits a PRD into ordered, shippable features |
spec |
Plans one feature: decisions, tasks with contracts + verify commands |
build |
Executes the spec task-by-task, verifying after every step |
qa |
Re-runs verifies + acceptance checks; failures become fix-tasks |
ship |
Branch guard, staged commit built from the spec — never pushes |
architecture-diagram |
Renders a self-contained HTML/SVG architecture diagram |
Install
pip install ai-sdlc-kit
# or: uv tool install ai-sdlc-kit
Use
ai-sdlc install --agent claude # or cursor / windsurf / gemini / all
This copies the skills into your agent's skills directory. They then appear as slash commands: /sdlc-init, /roadmap, /spec, /build, /qa, /ship.
| Flag | Effect |
|---|---|
--agent all |
install for every supported agent at once |
--target PATH |
install into a specific project directory (default: .) |
--global |
install into your home directory instead of a project |
--force |
overwrite existing skill folders |
ai-sdlc list # see bundled skills
ai-sdlc --version # print the installed version
Changelog
-
0.1.2— automated PyPI releases via GitHub Actions trusted publishing -
0.1.1— cleaner README, professional package presentation -
0.1.0— initial release: 6 core skills + architecture-diagram, pip-installable CLI
Related prior art: github/spec-kit.
Project details
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 ai_sdlc_kit-0.1.2.tar.gz.
File metadata
- Download URL: ai_sdlc_kit-0.1.2.tar.gz
- Upload date:
- Size: 18.1 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
fb7967f90b6effa375f02ee9a697d4ba0602c0e2a0cd821629816c478faa5c75
|
|
| MD5 |
af072c942151a0fc7ba55636e7f147b3
|
|
| BLAKE2b-256 |
461ce786aa13736ba71e0a46a63ba5c3b5cfea7c62a46efc08e95fcadfdfd0ce
|
Provenance
The following attestation bundles were made for ai_sdlc_kit-0.1.2.tar.gz:
Publisher:
publish.yml on xajeel/AI-SDLC
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ai_sdlc_kit-0.1.2.tar.gz -
Subject digest:
fb7967f90b6effa375f02ee9a697d4ba0602c0e2a0cd821629816c478faa5c75 - Sigstore transparency entry: 2150637776
- Sigstore integration time:
-
Permalink:
xajeel/AI-SDLC@fad20de7305cf58a74ef8966fa2bb5d04b872115 -
Branch / Tag:
refs/tags/v0.1.2 - Owner: https://github.com/xajeel
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@fad20de7305cf58a74ef8966fa2bb5d04b872115 -
Trigger Event:
release
-
Statement type:
File details
Details for the file ai_sdlc_kit-0.1.2-py3-none-any.whl.
File metadata
- Download URL: ai_sdlc_kit-0.1.2-py3-none-any.whl
- Upload date:
- Size: 23.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via: twine/6.1.0 CPython/3.13.12
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
ec5f1d62235fd178566c3cdbb3e12b971a6223dec2ac32e402b8c36a01cb4c64
|
|
| MD5 |
aec977f5d3cb3dbf3d205a665b88689d
|
|
| BLAKE2b-256 |
1ed6c520a8dbfeb908eb8f00acf66e8ff139801800642adf68921387b7c434c2
|
Provenance
The following attestation bundles were made for ai_sdlc_kit-0.1.2-py3-none-any.whl:
Publisher:
publish.yml on xajeel/AI-SDLC
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
ai_sdlc_kit-0.1.2-py3-none-any.whl -
Subject digest:
ec5f1d62235fd178566c3cdbb3e12b971a6223dec2ac32e402b8c36a01cb4c64 - Sigstore transparency entry: 2150637915
- Sigstore integration time:
-
Permalink:
xajeel/AI-SDLC@fad20de7305cf58a74ef8966fa2bb5d04b872115 -
Branch / Tag:
refs/tags/v0.1.2 - Owner: https://github.com/xajeel
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
publish.yml@fad20de7305cf58a74ef8966fa2bb5d04b872115 -
Trigger Event:
release
-
Statement type: