clarc

clarc

The workflow OS for Claude Code. 63 agents · 249 skills · 178 commands · 20 language rule sets · continuous learning flywheel.

clarc turns Claude Code from a coding assistant into a structured engineering system. It brings together agents that delegate work, skills that encode domain knowledge, commands that run repeatable workflows, hooks that automate the background, and a learning loop that improves itself over time.

The clarc Way

clarc ships a complete, opinionated development methodology — from raw idea to shipped code.

Phase 0: Discovery        /idea → /evaluate → /explore → /prd
Phase 1: Planning         /plan
Phase 2: Implementation   /tdd  (RED → GREEN → IMPROVE)
Phase 3: Quality          /code-review  +  /security
Phase 4: Ship             /commit-push-pr

Skip what you don't need:

Run /clarc-way to get a tailored recommendation for your current task. Run /quickstart if you're new to clarc.

Getting Started in 5 Minutes

# 1. Install (pick your language)
npx github:marvinrichter/clarc typescript
npx github:marvinrichter/clarc python
npx github:marvinrichter/clarc go

# 2. Verify the installation
npx github:marvinrichter/clarc doctor

# 3. Open Claude Code and run your first command
# /quickstart    → guided tour of the most important workflows
# /clarc-way     → what to do for your current task

Install

# Recommended — interactive wizard (auto-detects your languages)
npx github:marvinrichter/clarc

# Or with explicit language(s) — skips the wizard
npx github:marvinrichter/clarc typescript
npx github:marvinrichter/clarc typescript python go

# Other editors
npx github:marvinrichter/clarc --target cursor typescript
npx github:marvinrichter/clarc --target opencode typescript
npx github:marvinrichter/clarc --target codex

# Check if your installed rules are up to date
npx github:marvinrichter/clarc --check

The wizard clones clarc to ~/.clarc/ on first run, then symlinks agents, commands, and rules into ~/.claude/. A single git pull in ~/.clarc/ keeps everything current — no re-install needed.

~/.claude/agents/tdd-guide.md  →  ~/.clarc/agents/tdd-guide.md   (symlink)
~/.claude/commands/plan.md     →  ~/.clarc/commands/plan.md       (symlink)
~/.claude/rules/common/*.md    →  ~/.clarc/rules/common/*.md      (symlinks)

Your own agents or rules placed in ~/.claude/agents/ or ~/.claude/rules/ are never touched — symlinks only fill in files that don't already exist there.

# Update clarc
cd ~/.clarc && git pull

# Force copy instead of symlinks (CI, containers, cross-filesystem)
npx github:marvinrichter/clarc --copy typescript

git clone git@github.com:marvinrichter/clarc.git ~/.clarc
~/.clarc/install.sh typescript
~/.clarc/install.sh --enable-learning typescript
~/.clarc/install.sh --check

What's inside

Agents

Agents are delegated automatically based on what you're doing. You can also invoke them explicitly.