donnyclaude

DonnyClaude

Your Claude Code just got superpowers.

DonnyClaude is an opinionated, all-in-one power-user setup for Claude Code. One command installs 107 skills, 49 specialized agents, coding rules for 13 languages, a full project workflow engine, and 7 pre-configured MCP servers. Then Claude itself walks you through setting up your project.

"I went from a fresh Claude Code install to autonomous multi-phase project execution in under 2 minutes."

Quick Start

# Install directly from GitHub
npx donnyclaude

That's it. DonnyClaude checks your prerequisites, installs the full toolkit to ~/.claude/, then launches Claude Code as an interactive setup wizard to configure your project.

Alternative install methods

# Clone and run locally
git clone https://github.com/d0nmega/donnyclaude.git
cd donnyclaude
node bin/donnyclaude.js

# Or install globally
npm install -g donnyclaude
donnyclaude

What's Inside

	Component	Count	What It Does
Skills	GSD workflow, Superpowers, ECC quality, language patterns	107	Slash commands for every dev workflow
Agents	Executor, verifier, planner, reviewer, debugger...	49	Specialized AI agents for each task type
Rules	TypeScript, Python, Rust, Go, C++, Kotlin, Java, Swift, PHP, Perl, C#, COBOL	70 files	Coding standards enforced automatically
GSD Engine	Get Shit Done workflow	1	Plan -> Execute -> Verify -> Ship
Hooks	Format, guard, context monitor	8	Automatic quality gates on every edit
Commands	Slash commands	60	/gsd:plan-phase, /code-review, /tdd...
MCP Servers	Context7, Playwright, 21st.dev, Exa, Semantic Scholar, Computer Use, Vercel	7	Live docs, browser automation, UI generation

Installation

Prerequisites

• Node.js 20+ -- nodejs.org
• Anthropic API key -- console.anthropic.com

macOS

brew install node    # if needed
npx donnyclaude

Windows

# Install Node.js from https://nodejs.org/ (LTS recommended)
# Then open PowerShell or Command Prompt:
npx donnyclaude

Alternative: WSL2

curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs
npx donnyclaude

Linux

# Ubuntu/Debian
curl -fsSL https://deb.nodesource.com/setup_22.x | sudo -E bash -
sudo apt-get install -y nodejs

# Fedora
sudo dnf install nodejs

# Arch
sudo pacman -S nodejs npm

# Then:
npx donnyclaude

How It Works

Phase 1: Preflight

DonnyClaude checks for Node.js, npm, and Claude Code CLI. Installs Claude Code automatically if missing.

Checking prerequisites...
  ✓ Node.js v24.1.0
  ✓ npm 11.0.0
  ✓ Claude Code 2.1.97

Phase 2: Install Toolkit

Copies all 107 skills, 49 agents, rules, hooks, GSD engine, and commands to ~/.claude/. If you already have Claude Code customizations, they're preserved -- DonnyClaude merges, never clobbers.

Installing DonnyClaude toolkit...
  ✓ 107 skills installed
  ✓ 49 agents installed
  ✓ Rules installed (common + language-specific)
  ✓ GSD workflow engine installed
  ✓ Hooks installed
  ✓ Commands installed
  ✓ Settings merged (existing config preserved)

Phase 3: Interactive Setup (Claude is the wizard)

Claude Code launches and walks you through project configuration:

• Stack detection -- reads package.json / pyproject.toml / Cargo.toml
• CLAUDE.md generation -- project instructions tailored to your stack
• Planning scaffold -- .planning/ directory with PROJECT.md, ROADMAP.md, STATE.md
• MCP server config -- .mcp.json with 7 servers, prompts for API keys (skip any you don't have)

The GSD Workflow

DonnyClaude is built around Get Shit Done (GSD) -- an autonomous project execution engine:

/gsd:new-project       Start a new project with deep context gathering
/gsd:plan-phase N      Plan a phase before any code is written
/gsd:execute-phase N   Execute with parallel subagents
/gsd:verify-work       Verify every phase before moving on
/gsd:progress          See where you are
/gsd:autonomous        Run ALL phases back-to-back, hands-free

The loop: Brainstorm -> Plan -> Test -> Build -> Review -> Verify -> Ship

Every phase gets planned before execution. Tests are written before code. Code is reviewed before merge. Nothing ships without verification.

Supported Stacks

Stack	Template	Extra Tools
Python (FastAPI, Django, Flask)	python-fastapi.md	python-review, python-testing, pytest patterns
TypeScript (Next.js, Node, React)	nextjs-typescript.md	21st.dev Magic, Playwright, shadcn/ui
Rust	rust.md	rust-review, rust-build, cargo-llvm-cov
Go	go.md	go-review, go-build, table-driven tests
Other	generic.md	All base tools, universal rules

MCP Servers

Every project gets its own .mcp.json with 7 servers pre-configured:

Server	API Key?	What It Does
Context7	No	Live library documentation -- never use stale APIs again
Playwright	No	Browser automation, visual QA, E2E testing
21st.dev Magic	Yes	Generate, refine, and browse UI components
Exa	Yes	Web search with code-aware results
Semantic Scholar	No	Academic paper search and citation graphs
Computer Use	No	Control your desktop -- screenshots, clicks, typing
Vercel	OAuth	Deploy, manage env vars, check status

Commands

npx donnyclaude            # Install + setup wizard
npx donnyclaude doctor     # Health check
npx donnyclaude update     # Update to latest
npx donnyclaude version    # Show version
npx donnyclaude help       # Show help

What Gets Created

In your project:

your-project/
  CLAUDE.md              # AI instructions tailored to your stack
  .mcp.json              # 7 MCP servers, ready to go
  .planning/
    PROJECT.md           # Vision and constraints
    REQUIREMENTS.md      # Tracked requirements
    ROADMAP.md           # Phase-based execution plan
    STATE.md             # Current progress tracker
    config.json          # Workflow config (models, toggles)

Globally (~/.claude/):

~/.claude/
  skills/        107 skills (GSD, Superpowers, ECC, language-specific)
  agents/        49 specialized agents
  rules/         Coding standards for 13 languages
  get-shit-done/ GSD workflow engine
  hooks/         Auto-formatting and guard rails
  commands/      60 slash commands
  settings.json  Permissions and hook config

Customizing

Add skills: Drop a SKILL.md into ~/.claude/skills/your-skill/

Add rules: Copy and customize: cp -r ~/.claude/rules/typescript ~/.claude/rules/your-lang

Tune GSD: Edit .planning/config.json to change models, parallelization, and workflow toggles

Power users: Set "defaultMode": "bypassPermissions" in ~/.claude/settings.json for fully autonomous operation (DonnyClaude defaults to acceptEdits for safety)

Existing Claude Code Users

Already have a ~/.claude/ directory? DonnyClaude is safe to run:

• Settings: Merged, never overwritten. Your permissions, existing hooks, and custom config are preserved. A backup is created at settings.json.bak before any merge.
• Skills/agents/rules: Added alongside your existing ones. If you've customized a file with the same name, it will be overwritten -- back up any custom modifications first.
• Doctor: Run donnyclaude doctor to verify everything is healthy after install.

Uninstall

To remove DonnyClaude's tools from your system:

# Remove global tools
rm -rf ~/.claude/skills ~/.claude/agents ~/.claude/rules
rm -rf ~/.claude/get-shit-done ~/.claude/hooks ~/.claude/commands

# Restore settings backup (if you had pre-existing settings)
cp ~/.claude/settings.json.bak ~/.claude/settings.json

# Remove project-local files (per project)
rm CLAUDE.md .mcp.json
rm -rf .planning/

Credits

Built by Donovan Santine (D0NMEGA) -- BME Honors at UT Austin, building MoltGrid.

Powered by:

• Claude Code by Anthropic
• GSD workflow engine
• Everything Claude Code skill ecosystem
• Context7 live documentation

License

MIT -- use it, fork it, ship it.