Genesis

⚡ G E N E S I S

The Claude that builds Claudes

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

[](https://github.com/xeeva/Genesis) [](LICENSE) [](https://xeeva.github.io/Genesis) [](https://docs.anthropic.com/en/docs/claude-code) [](https://github.com/sponsors/xeeva)

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

---

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](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](DISCLAIMER.md) for the full terms.

---

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

[MIT Licence](LICENSE) | [Disclaimer](DISCLAIMER.md) | [Contributing](CONTRIBUTING.md)

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

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: xeeva
• Source: xeeva/Genesis
• License: MIT
• Homepage: https://xeeva.github.io/Genesis

Install and usage instructions live in the source repository linked above.