| name | cicd-starter |
| description | Bootstrap an existing codebase for the CKS lifecycle — scans the project, runs guided intake, generates CLAUDE.md, and initializes .prd/ state. Use when: "bootstrap", "set up", "initialize", "configure for this project", "generate CLAUDE.md", "scan my codebase", or any variation of setting up CKS tooling in an existing project.
|
| allowed-tools | Read, Write, Edit, Bash, Grep, Glob, AskUserQuestion |
CKS Bootstrap — Set Up Any Existing Codebase
Scans an existing project, asks smart questions based on what it finds, generates CLAUDE.md, and initializes the PRD lifecycle.
Flow
/cks:bootstrap → scan codebase → guided intake → CLAUDE.md → .prd/ init → done
When to Use
- Existing codebase →
/cks:bootstrap (this skill)
- New project from scratch →
/cks:kickstart (different skill)
Agents
| Phase | Agent | Role |
|---|
| 1 — Scan & Intake | bootstrap-scanner | Scans codebase, detects stack, runs guided Q&A |
| 2 — Generate | bootstrap-generator | Produces CLAUDE.md, .prd/, rules, config from scan context |
Agents load this skill via skills: cicd-starter and read workflow files for step-by-step process.
What It Produces
CLAUDE.md ← Project-specific instructions (no placeholders)
.prd/PRD-STATE.md ← Lifecycle initialized (idle, ready for /cks:new)
.prd/PRD-PROJECT.md ← Project context from scan + intake
.prd/PRD-ROADMAP.md ← Empty, ready for features
.context/config.md ← Research sources configured for detected stack
Reference Files
| File | When to Read |
|---|
references/claude-md-template.md | When generating CLAUDE.md |
references/deploy-platforms.md | When detecting deploy platform and generating deploy config |
references/railway-deploy.md | When Railway is the detected/chosen platform |
Customization
This skill ships with opinionated defaults. Review and adapt to your needs:
- CLAUDE.md template: Project constitution template — edit
references/claude-md-template.md
- Scan patterns: What bootstrap looks for in the codebase — edit SKILL.md
- Intake questions: Guided Q&A during bootstrap — edit
assets/ files
- Deploy config: Multi-platform templates — edit
references/deploy-platforms.md
- allowed-tools: Currently
Read, Write, Edit, Bash, Grep, Glob, AskUserQuestion.
Rules
- Scan first, ask second — detect everything you can before asking
- Pre-fill from scan — user confirms, not types from scratch
- No placeholders — every line in CLAUDE.md must be real content
- Idempotent — safe to re-run (offers update/regenerate/cancel)
- Don't touch source code — only generate CLAUDE.md and .prd/ files
