⚡ G E N E S I S

The Claude that builds Claudes

Bootstrap fully-equipped Claude Code projects in under two minutes.

██████╗ ███████╗███╗ ██╗███████╗███████╗██╗███████╗ ██╔════╝ ██╔════╝████╗ ██║██╔════╝██╔════╝██║██╔════╝ ██║ ███╗█████╗ ██╔██╗ ██║█████╗ ███████╗██║███████╗ ██║ ██║██╔══╝ ██║╚██╗██║██╔══╝ ╚════██║██║╚════██║ ╚██████╔╝███████╗██║ ╚████║███████╗███████║██║███████║ ╚═════╝ ╚══════╝╚═╝ ╚═══╝╚══════╝╚══════╝╚═╝╚══════╝

---

You describe it. Genesis builds it. Claude runs it.

The Problem

Claude Code is powerful, but getting the most out of it requires significant upfront work. A well-equipped project needs a CLAUDE.md with coding standards, domain-specific agents with role instructions, skills for common workflows, hooks for auto-formatting, scoped permissions, MCP server configs, and memory files seeding project context.

Most developers skip this setup or cobble together a minimal CLAUDE.md. The result: Claude works, but not nearly as well as it could. You miss the specialised agents, automated workflows, and contextual memory that make Claude Code truly productive.

The Solution

Genesis is a Claude Code project that creates other Claude Code projects. You describe what you want to build, and Genesis scaffolds a fully-equipped development environment -- agents, skills, hooks, memory, MCP server configs, and application boilerplate -- all tailored to your chosen stack.

Every generated project is ready for productive work from the very first Claude session. No manual configuration. No copy-pasting boilerplate. No guesswork.

Genesis itself is a Claude Code project. It uses the same agents, skills, and memory system it generates for others, making it both a tool and a reference implementation.

Read the full documentation

Quick Start

Linux / macOS / WSL:

git clone https://github.com/xeeva/Genesis.git ~/claude/genesis
cd ~/claude/genesis
claude

Windows (PowerShell):

git clone https://github.com/xeeva/Genesis.git $HOME\claude\genesis
cd $HOME\claude\genesis
claude

Then describe what you want to build:

"Create a Python FastAPI service called widget-api with PostgreSQL and Redis"

Genesis asks 1-2 follow-up questions, presents a plan, then generates everything.

How It Works

Genesis follows a strict four-phase workflow:

🔍 Interview Extract project details from your description. Ask only what is missing. 1-4 questions max

📐 Plan Present agents, skills, MCP servers, and folder layout for approval. Review before generating

🏗️ Generate Create the entire project directory with all infrastructure and boilerplate. Single-pass generation

🚀 Finalise Initialise git, update registry, provide next steps. Ready to code

See the detailed walkthrough for examples.

What Gets Generated

Component	Description
CLAUDE.md	Project brain with stack-specific rules, coding standards, and testing mandates
.claude/agents/	Domain and workflow agents (test-runner, code-reviewer, doc-writer, plus 2-4 domain-specific)
.claude/skills/	Base skills (/test, /lint, /review, /commit) plus domain-specific skills
.claude/settings.json	Permissions, formatter hooks, and stop hooks
.mcp.json	MCP server configs for your integrations (database, GitHub, Playwright, AWS)
Memory files	User profile and project context seeded into Claude's memory
Application code	Entry points, package config, test setup, documentation
.gitignore + Git repo	Stack-appropriate ignores with initial commit

Supported Stacks

Node.js / TS ESLint, Prettier vitest/jest, ESM

Python ruff, pytest mypy/pyright

Go gofmt, golangci-lint table-driven tests

Rust rustfmt, clippy cargo test

Ruby RuboCop RSpec/Minitest

Java / Kotlin Gradle/Maven Spotless, JUnit 5

Each profile includes idiomatic folder structures, linter/formatter hooks, test configuration, error patterns, and permission sets.

Available Skills

Skill	Description
/genesis	Bootstrap a new project (main entry point)
/registry	View all projects created by Genesis
/validate	Check a generated project is complete and well-formed
/update	Pull the latest Genesis updates from the remote repository

Prerequisites

Tool	Version	Purpose
Claude Code CLI	v1.x+	AI coding assistant (the runtime)
git	v2.x+	Version control
Node.js	v18+	Required by Claude Code and MCP servers

You also need a supported shell: bash, zsh, or PowerShell.

Platform-specific installation

Platform	Install tools via
Linux (Debian/Ubuntu)	apt install git nodejs npm
Linux (Fedora)	dnf install git nodejs npm
macOS	brew install git node
WSL	Use your Linux distro's package manager
Windows	Scoop or the official installers

Claude Code CLI: npm install -g @anthropic-ai/claude-code

First-Time Setup

On first launch, Genesis checks for two configuration files: personalisation.md and environment.md. If either is missing, it guides you through setup:

1. Environment detection: platform, shell, package manager
2. Personalisation: locale preferences, output style, role, experience level
3. Prerequisite check: verifies that required tools are installed

These files are gitignored and preserved across Genesis updates. Re-run setup at any time by deleting either file.

Updating Genesis

/update

Or manually: cd ~/claude/genesis && git pull origin main

Your personalisation.md and environment.md are always preserved. Only the core scaffold is updated.

Project Structure

genesis/
├── CLAUDE.md                          # Master bootstrapper instructions
├── personalisation.md.example         # Template for user preferences
├── environment.md.example             # Template for platform config
├── .claude/
│   ├── settings.json                  # Permissions and hooks
│   ├── agents/                        # 5 specialised agents
│   │   ├── interviewer.md
│   │   ├── planner.md
│   │   ├── scaffold-writer.md
│   │   ├── claude-infra-writer.md
│   │   └── finaliser.md
│   └── skills/
│       ├── genesis/                   # Main bootstrap skill
│       │   ├── SKILL.md
│       │   ├── templates/             # File templates for generation
│       │   └── references/            # Stack profiles and agent catalogue
│       ├── registry/                  # Project registry viewer
│       ├── validate/                  # Project validator
│       └── update/                    # Self-update skill
├── docs/                              # Documentation and GitHub Pages
├── CONTRIBUTING.md                    # Contribution guidelines
├── CODE_OF_CONDUCT.md                 # Contributor Covenant
└── LICENSE                            # MIT licence

Contributing

See CONTRIBUTING.md for guidelines on adding stacks, agents, templates, and more.

---

Disclaimer

Genesis is an AI-powered code generation tool provided "as is" without warranty of any kind. You use this tool entirely at your own risk. The author accepts no responsibility for the correctness, security, or suitability of any generated output. Review all generated code before use. See DISCLAIMER.md for the full terms.

---

Copyright (c) 2026 David Summers. All rights reserved.

MIT Licence | Disclaimer | Contributing

_{Genesis is a Claude Code project that bootstraps Claude Code projects. It's Claudes all the way down.}