Purpose
Ground the project in where and how it runs — for the developer inner loop and for production.
Questions to ask (in order)
Production
- Hosting target: self-hosted (VM or Kubernetes), managed PaaS (Fly, Render, Railway, Heroku), serverless (AWS Lambda, Cloudflare Workers, Vercel, Netlify), managed containers (ECS, Cloud Run, App Runner), on-prem, or hybrid.
- Cloud provider (if any): AWS, GCP, Azure, Cloudflare, DigitalOcean, other.
- Infrastructure as Code: none (manual), Terraform, Pulumi, CDK, CloudFormation, or provider-native manifests (
fly.toml,render.yaml, etc.). - CI/CD: GitHub Actions, GitLab CI, CircleCI, Jenkins, Buildkite, or none.
- Environments: prod only / prod + staging / prod + staging + preview-per-PR.
- Secrets management:
.envplus platform secrets, HashiCorp Vault, AWS Secrets Manager, Doppler, 1Password CLI, SOPS. - Observability in production: log sink, metrics sink, tracing sink.
- Backup and disaster-recovery expectations: none, daily snapshot, point-in-time recovery, multi-region.
Development
- Local dev environment: native toolchain, devcontainer, Nix, Docker Compose, Vagrant, or remote dev (Codespaces, Gitpod).
- Containerization: not used, optional, or required (include Dockerfile).
- Hot reload / fast feedback expectations.
- Seed data strategy: none, fixtures, factories, synthetic generator, or anonymized prod snapshot.
- Database migrations tool (if applicable).
Use AskUserQuestion for the multi-choice items.
Solution space to present
- Hosting tradeoffs: serverless (scale-to-zero, cold starts, vendor shape) vs. managed containers (flexible, some ops) vs. PaaS (simple, opinionated) vs. Kubernetes (powerful, heavy).
- IaC tradeoffs: Terraform (ubiquitous, HCL), Pulumi/CDK (real languages, narrower ecosystem), provider-native (fast start, vendor-locked), manual (only acceptable for prototypes).
- Local dev tradeoffs: native (fastest inner loop, more per-machine setup) vs. devcontainer/Docker (reproducible, slower iteration) vs. remote dev (zero local setup, requires connectivity).
Required schema
prod:{hosting, cloud, iac, ci_cd, environments, secrets, observability, dr}dev:{environment, containerization, hot_reload, seed_data, migrations}
Output
Write to PROJECT_BRIEF.md under a ## Deployment heading. Replace any prior ## Deployment section when re-run.
Frontmatter contribution
Update these YAML frontmatter fields (see CLAUDE.md for the full schema). Leave every other field untouched:
deployment.provider— the cloud provider or hosting target (e.g.,aws,gcp,azure,fly,render,self-hosted,on-prem)deployment.iac— the IaC tool (terraform,pulumi,cdk,cloudformation,sam,none)deployment.environments— list of environments (e.g.,[prod],[dev, staging, prod])