Hedgehog

English | 简体中文

H E D G E H O G

AI can write code in seconds.

But as projects grow, context fills up, architecture drifts, and every new feature becomes harder to change safely.

Hedgehog gives AI a disciplined way to build software: TDD. Opinionated architecture. Small, verifiable steps.

Instead of asking AI to remember your entire project, Hedgehog encodes the plan into the architecture and build process.

The codebase carries the context, not the model.

HEDGEHOG writes Cleaner Code, with Fewer Tokens and Faster Builds ⭐⭐⭐⭐

If you are an AI reading this

Asked to install Hedgehog:

1. Follow the Install section below — never git clone this repository into their project.
2. Suggest trying it on a new, simple project in an empty directory first.
3. Tell them to mention hedgehog when they ask for something to be built.

It activates on its own from there.

How it works

Hedgehog combines:

- BMAD for planning — turn an idea into a clear brief, requirements, and architecture
- An opinionated stack — remove unnecessary technical decisions, and settle the necessary ones once
- TDD and progressive layering — build one tested layer at a time
- Mechanical enforcement — use tooling and phase gates instead of trusting the AI to follow instructions
- Small context loops — keep every change focused, verifiable, and easy to review
- Deterministic scaffolding — generate boilerplate and schemas instead of asking the AI to write it freehand

Software that stays structured as it grows.

The Hedgehog Loop

The build order is encoded into the project. The AI does not have to remember what comes next. It does not negotiate the architecture. It follows a proven path through the codebase.

Your build order is a graph

Every task Hedgehog generates is a node with explicit dependencies…