cc-workflow

Cross-platform installer for a Claude Code pro workflow — skills, commands, rules, hooks, and project scaffolding in one command.

What gets installed

Global (~/.claude/)

Path	What it does
rules/code-style.md	Formatting & naming conventions
rules/testing.md	TDD rules — write tests first, no mocks
rules/git.md	Commit hygiene and safe destructive ops
skills/dream/	/dream — reflective memory consolidation
skills/review/	/review — security & quality checklist
commands/doc-and-clear.md	/doc-and-clear — save progress, clear context
commands/fix-issue.md	/fix-issue N — analyze and fix a GitHub issue
settings.json hooks	Guard rails on .env/lock files; auto-prettier on JS/TS

Project (with --project / -Project flag)

Path	What it does
CLAUDE.md	Lean project rules (workflow, context, code quality, testing, security)
scripts/worktree-setup.sh	Create isolated git worktrees for parallel Claude sessions
.claude/handoff/	Directory for /doc-and-clear session handoffs

Install

macOS / Linux

Global only:

bash install.sh

Global + project setup (run from your project root):

bash install.sh --project

Windows

Global only:

powershell -ExecutionPolicy Bypass -File install.ps1

Global + project setup (run from your project root):

powershell -ExecutionPolicy Bypass -File install.ps1 -Project

Requirements

Platform	Requirements
macOS / Linux	python3
Windows	python3, Git Bash (for hooks and worktree script)

Quick reference

/dream              Consolidate memory — merge dupes, fix stale facts
/review             Security + quality checklist before committing
/fix-issue 42       Analyze and fix GitHub issue #42 end-to-end
/doc-and-clear      Save session progress, then /clear to free context

./scripts/worktree-setup.sh feature-x   Parallel Claude session on isolated branch

Workflow

Research → Plan (Shift+Tab x2) → Implement → Validate

• "think" — simple tasks (bug fix, refactor)
• "think hard" — medium tasks (design pattern, migration)
• "ultrathink" — architecture-level only (system design, security audit)
• Never exceed 60% context — run /compact proactively

Changelog

v1.0.0

• Initial release
• Cross-platform installers (bash + PowerShell)
• Global skills: /dream, /review
• Global commands: /doc-and-clear, /fix-issue
• Global rules: code-style, testing, git
• Project scaffolding: CLAUDE.md, worktree script, handoff directory
• Hook guards for .env/lock files; auto-prettier on JS/TS save

License

MIT — see LICENSE