API process
src/main.py and generated routes.
Opinionated scaffolds for agent-assisted projects.
kickstart
Starter repos for humans and agents.
Files, commands, tests, docs, and boundaries from one project intent.
python service
kickstart create service api --lang python --database postgres --cache redis --auth jwtgenerated shape
./Dockerfile
./Makefile
./pyproject.toml
./requirements.txt
./.env.example
./src/main.py
./src/routes/health.py
./src/routes/users.py
./src/clients/database.py
./src/clients/cache.py
./src/handler/auth.py
./src/model/repository.py
./migrations/001_initial.sql
./tests/test_smoke.py
./.kickstart/scaffold.json
./AGENTS.md
./docs/architecture/README.md
./docs/contracts/README.md
./docs/operations/README.md
./docs/decisions/README.mdWrites a Python API with Dockerfile, Postgres/Redis clients, JWT hook, migrations, docs, and tests.
component map
Postgres client
src/clients/database.py plus migration SQL.
Redis client
src/clients/cache.py and dependency entries.
JWT auth
src/handler/auth.py extension hook.
Container boundary
Dockerfile builds the app; services are explicit.
[position]
Useful setup. Not architecture.
It is
Scaffold factory
Turns a stack profile into a deterministic starter repo.
Agent contract
Writes layout, docs, commands, and boundaries.
Repeatable bootstrap
Same input, same starting shape.
It is not
Universal create-app
It is intentionally narrow.
Product architect
It does not design the domain model.
Runtime platform
It does not run every dependency for you.
[release]
Releases
v0.4.0
First supported baseline
First supported release line for typed scaffolds, release assets, and Worker website deployment.
- Modern Python metadata, validation commands, and Linux/macOS binary release workflow.
- Cloudflare provider and Worker scaffolding, including TypeScript and Rust Workers.
- Typed specs, layout plans, stack registry, template plans, and agent-readable scaffold docs.