Scaffold AI-development-ready FastAPI projects: pinned upstream template plus Claude Code skills, MCP config, and design docs
Project description
dev-ready
Scaffold a production-grade, AI-development-ready FastAPI project in one command:
uvx dev-ready init my-app
Status: bootstrap phase. Repository structure and design docs are in place; the CLI is not yet implemented.
What it generates
- Base: fastapi/full-stack-fastapi-template at a pinned, CI-verified commit (never untested "latest")
- Overlay: CLAUDE.md, Claude Code skills, MCP server configuration, and design-doc templates so the generated project is immediately workable with AI coding agents
Tech stack
Python >= 3.12, uv/uvx for distribution, questionary for prompts, GitHub Actions for upstream tracking and releases. Design details and ADRs: docs/architecture.md.
Development
uv sync --dev
uv run dev-ready # run the CLI
uv run pytest # tests
uv run ruff check . # lint
Development workflow (multi-agent)
This repo is developed with an AI-agent workflow: Architect -> Engineer -> QA -> Security -> Release. Agent instructions live in CLAUDE.md and reviewer roles in .bob/.
Repository layout
docs/ requirements, architecture (ADRs), CLI spec
src/dev_ready cli / prompts / fetch / overlay / manifest / report
templates/ overlay assets copied into generated projects
tests/ unit / integration / e2e
.bob/ IBM Bob reviewer role definitions (QA, Security, SRE)
.github/ CI, weekly upstream bump, release workflows
Upstream pins live in src/dev_ready/manifest.json (bundled with the package,
so a released CLI always carries the pin it was tested with).
License
MIT — see LICENSE. Generated projects include content derived from fastapi/full-stack-fastapi-template (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 dev_ready-0.1.1.tar.gz.
File metadata
- Download URL: dev_ready-0.1.1.tar.gz
- Upload date:
- Size: 37.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.22 {"installer":{"name":"uv","version":"0.9.22","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 |
29d32f50e9f864cb369e04bf04b444f37f06912a974367f355dc07eebdba9df6
|
|
| MD5 |
68c559803d0a5e19aea03644ad75d4e5
|
|
| BLAKE2b-256 |
8e9046112004b399cb7048251fd3a3265467375726d884ab651617a9a3728f1d
|
File details
Details for the file dev_ready-0.1.1-py3-none-any.whl.
File metadata
- Download URL: dev_ready-0.1.1-py3-none-any.whl
- Upload date:
- Size: 10.7 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: uv/0.9.22 {"installer":{"name":"uv","version":"0.9.22","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 |
70fef274803c8ed8e78df91ab23b9dfd4b7c6303e8611f580d11444610929fd8
|
|
| MD5 |
e92127f3c1fc05e60d441b2b4f1bd3b7
|
|
| BLAKE2b-256 |
5faddc68aa12568094856ecc379fafa090050fb60f0bbc990112b89a732e1c39
|
