bleu

Bleu

Turn an idea into a deeply structured, file-backed system plan before writing any code.

A Claude Code skill that grows your idea into a navigable markdown wiki: vision, architecture, components, action points, research, citations, ADRs, and a session-persistence layer that survives /clear.

flowchart LR
    A[Your idea] --> B[Bleu]
    B --> C[blueprint/<br/>workspace on disk]
    C --> D[Handoff to executor<br/>GSD / Superpowers / Claude Code]
    D --> E[Code, written from a real plan]

    style B fill:#cfe8ff,stroke:#0066cc,color:#000
    style C fill:#fff4cf,stroke:#cc9900,color:#000
    style E fill:#d4f5d4,stroke:#2d8f2d,color:#000

Install

/plugin marketplace add Nirvaan05/Bleu-plugin
/plugin install bleu@bleu

Restart your Claude Code session.

Trigger phrases

Intent	Say something like
Start a new blueprint	help me blueprint this system, plan before coding, design the architecture for X, break this idea into components, expand into action points, full implementation plan
Resume an existing blueprint	where did we leave off, continue this plan, resume my blueprint

At a glance

Property	Value
Output	A blueprint/ directory of markdown files in your working dir
Storage	Plain markdown. No vector DB, no embeddings, no chunking
Survives	/clear, terminal crashes, context-window resets
Hands off to	GSD, Superpowers, raw Claude Code, or a flat AP list
Granularity	3 to 5 APs (tiny task) up to ~38 APs (greenfield system)
Research	Continuous, web-based, primary sources, every claim cited
Lint	Runs after every phase, not only at the end

The phased workflow

Eight phases. Sequential by default, lint after each one, free to loop back.

flowchart TD
    P0[Phase 0<br/>Intake & framing] --> P1[Phase 1<br/>Research pass<br/>web + code]
    P1 --> P2[Phase 2<br/>Vision · Architecture · Pipelines]
    P2 --> P3[Phase 3<br/>Component breakdown]
    P3 --> P4[Phase 4<br/>Data · Integrations · Non-functional]
    P4 --> P5[Phase 5<br/>Action point expansion]
    P5 --> P6[Phase 6<br/>Lint · Challenge · Iterate]
    P6 -->|gaps found| P2
    P6 --> P7[Phase 7<br/>Sign-off & handoff]

    PR[Phase R<br/>Resume / Persist]
    PR -.->|runs at session start| P0
    PR -.->|runs at session end| P7

    style P0 fill:#e8f4ff,color:#000
    style P1 fill:#e8f4ff,color:#000
    style P2 fill:#fff4cf,color:#000
    style P3 fill:#fff4cf,color:#000
    style P4 fill:#fff4cf,color:#000
    style P5 fill:#ffe0cc,color:#000
    style P6 fill:#ffd4d4,color:#000
    style P7 fill:#d4f5d4,color:#000
    style PR fill:#e8d4ff,color:#000

#	Phase	Goal	Output
0	Intake & framing	Restate the idea, surface unknowns, confirm scope	raw/intake.md
1	Research pass	Ground in primary sources before drafting anything	research/<topic>.md, raw/codebase-notes.md
2	Vision · Architecture · Pipelines	Three opinionated documents with cited decisions	plan/00-vision.md, 01-architecture.md, 02-pipelines.md
3	Component breakdown	One page per component, clear ownership	plan/03-components/<name>.md
4	Data · Integrations · Non-functional	Schemas, APIs, performance, security, scaling	plan/04, 05, 06.md
5	Action point expansion	Decompose to executable units with deps	action-points/AP-NN-<slug>.md + dep graph
6	Lint · Challenge · Iterate	Find gaps, contradictions, edge cases, flaws	plan/07-risks-open-questions.md
7	Sign-off & handoff	Lock in, generate handoff artifact for executor	handoff/<target>.md
R	Resume / Persist	Survive context resets	SESSION.md, NEXT.md, journal entry, ADRs

The workspace anatomy

blueprint/
├── README.md                    entry point + navigation
├── SESSION.md                   current snapshot, read FIRST on resume
├── NEXT.md                      imperative next actions, read SECOND
├── journal.md                   append-only session history
├── index.md                     compact summary of every file
├── decisions/                   MADR-style ADR log
│   ├── README.md                ADR index with status table
│   └── ADR-NNN-<slug>.md
├── raw/                         raw inputs: transcripts, dumps, code excerpts
├── plan/
│   ├── 00-vision.md             problem, goals, non-goals, success criteria
│   ├── 01-architecture.md       diagram, layers, data flow, key decisions
│   ├── 02-pipelines.md          every flow end to end
│   ├── 03-components/           one file per component
│   ├── 04-data-model.md
│   ├── 05-integrations.md
│   ├── 06-non-functional.md
│   └── 07-risks-open-questions.md
├── action-points/               one file per AP + dep graph in README
├── research/                    web research notes with citations
└── outputs/                     answers to your queries, persisted