Claude Code Kickstarter

🌀 Claude-Code-Kickstarter

_The one-file setup that drops a full "plan → tests → code → docs → PR" workflow into **any** Git repo—powered by Claude Code._

---

✨ What is this?

Inside this repo you'll find **one magic Markdown file**:

.claude/commands/setup-claude-workflow.md

Copy that file into _any_ existing project (monorepo, single package, JavaScript, Bun, TypeScript—doesn't matter). Then run:

/user:setup-claude-workflow "My Awesome Project"

Claude will:

1. **Detect** which canonical docs you already have.

2. **Write** the missing ones (architecture diagram stub, glossary, API guide, ADR README, onboarding checklist).

3. **Drop** a battle-tested `CLAUDE.md` that enforces:

   • Branch → Plan → Tests → Code → Verify → Docs → Changelog → PR

4. **Install** repo-local helper commands (`/project:regen-docs`, `/project:next`, etc.).

5. **Merge** a minimal GitHub Actions workflow if you don't have one.

6. Stage everything with `git add` and politely remind you to commit.

No `git init`, no history rewrite, no yak-shaving.

---

🏄‍♂️ Quick start

# Option A – install once globally
mkdir -p ~/.claude/commands
curl -o ~/.claude/commands/setup-claude-workflow.md \
  https://raw.githubusercontent.com/gmickel/Claude-Code-Kickstarter/refs/heads/main/setup-claude-workflow.md

# In any repo
cd my-existing-repo
/user:setup-claude-workflow "My Existing Repo"
git commit -m "chore: add Claude workflow"

# Option B – keep the file in the repo
mkdir -p .claude/commands
curl -o .claude/commands/setup-claude-workflow.md \
  https://raw.githubusercontent.com/gmickel/Claude-Code-Kickstarter/refs/heads/main/setup-claude-workflow.md
/project:setup-claude-workflow "My Existing Repo"
git commit -m "chore: add Claude workflow"

Then write a PRD and let Claude take the wheel:

echo "# PRD #42 – Super Search" > docs/prd_42.m