Claude Setup

Claude Code Agent Setup

A template for setting up Claude Code (agents, skills, memory) in any project. Use it to bootstrap a new repo or add Claude to an existing one.

What you get: a set of specialized agents and slash-command pipelines for common software tasks:

Pipeline	What it does
/grill-me, /grill-with-docs	Fuzzy idea → relentless interview → sharpened plan (run before /build)
/build	PRD → cheap lite-routing → plan → parallel/direct implementation → diff-scoped code review
/build-lite	Feature → plan → approve → implement in one context — no fan-out, review separated
/debug-workflow	Bug report → investigate → diagnose → TDD fix → review
/refactor	Target → audit → (write tests) → refactor → behavior-preservation review
/refactor-lite	Target → audit → plan → approve → refactor in one context — no fan-out, review separated
/qa	Running app → exploratory browser testing → QA report + Playwright E2E tests
/craft-pr	Branch's task files + diff → polished PR description

Task/QA artifacts are branch-scoped so you can run multiple pipelines in parallel across branches (including git worktrees) without collision.

Creating a New Project

Use this repo as a GitHub template to start a new project with Claude Code pre-configured:

1. Click "Use this template" → "Create a new repository" on GitHub
2. Clone your new repo and start working:

   git clone git@github.com:you/your-new-project.git
   cd your-new-project
   claude login   # authenticate with your Max/Pro subscription
   claude          # start coding
   

Everything is ready out of the box — agents, skills, and settings are already in place. Add your project code and go.

Adding Claude to an Existing Project

Option A: One-liner (recommended)

By default the script installs agents and skills globally into ~/.claude/ — available across every project with no per-project setup needed:

bash <(curl -fsSL https://raw.githubusercontent.com/nickmaglowsch/claude-setup/main/setup.sh)

Re-run the same command to update. It auto-detects whether ~/.claude/agents/ already exists and updates in place (no prompts) or installs fresh (with overwrite prompts).

The template repo is auto-cloned to /tmp/claude-setup (or pulled if already there).

Per-project install

Use --local to install into a specific project directory instead:

cd /path/to/your/project
bash <(curl -fsSL https://raw.githubusercontent.com/nickmaglowsch/claude-setup/main/setup.sh) --local

The script auto-detects whether this is a first-time setup or an update:

• New project (no .claude/agents/): runs the interactive setup — copies agents, skills, settings, and optionally adds devcontainer + headless runner
• Existing setup (.claude/agents/ found): updates all agent and skill files to the latest version while preserving your settings.local.json and agent-memory/

Updating an existing local setup

Same one-liner with --local — the script auto-detects the existing setup and runs in update mode:

cd /path/to/your/project
bash <(curl -fsSL https://raw.githubusercontent.com/nickmaglowsch/claude-setup/main/setup.sh) --local

To force update mode explicitly:

bash <(curl -fsSL https://raw.githubusercontent.com/nickmaglowsch/claude-setup/main/setup.sh) --local --update

Update mode pulls the latest template, overwrites all agent and skill files, and leaves your settings.local.json and agent-memory/ untouched.

To add devcontainer support during an update (if you skipped it during initial setup):

bash <(curl -fsSL https://raw.githubusercontent.com/nickmaglowsch/claude-setup/main/setup.sh) --update --add-devcontainer

Other coding agents (OpenCode, Gemini CLI, Codex CLI)

Add --compatible to generate native agent files for other tools alongside the Claude setup:

bash <(curl -fsSL https://raw.githubusercontent.com/nickmaglowsch/claude-setup/main/setup.sh) --compatible opencode,gemini,codex

For OpenCode and Gemini, you'll be prompted to choose models per agent system (heavy-tier and standard-tier). Generated files:

Flag	Generated	Also creates
opencode	.opencode/agents/*.md	AGENTS.md → CLAUDE.md symlink
gemini	.gemini/agents/*.toml	GEMINI.md → CLAUDE.md symlink
codex	~/plugins/claude-setup-codex/	~/.agents/plugins/marketplace.json entry