skills.rest
davila7
davila7COMMUNITY
Explore all skills by this author →
Website𝕏@dani_avila7GitHub

bleu

Generates a persistent markdown planning wiki that decomposes ideas into architecture and action points.

30.5k|3.5k|Updated Jul 4, 2025
Search Tags:#ADR#blueprint#architecture planning#System Design#action points#Knowledge Base#Claude code
One-click install
npx skills add https://github.com/davila7/claude-code-templates --skill bleu
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: bleu
Source: https://github.com/davila7/claude-code-templates/tree/main/cli-tool/components/skills/development/bleu
Command: npx skills add https://github.com/davila7/claude-code-templates --skill bleu

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

One-shot LLM planning produces walls of text that get lost between sessions and hide architectural flaws until implementation. This Skill turns an idea into a deeply structured, file-based system blueprint that survives context resets and is linted for gaps before any code is written.

Core Features & Use Cases

  • Phased planning workflow: Runs intake, mandatory web research, vision/architecture drafting, component breakdown, data modeling, and decomposition into roughly 38 executable action points with dependency graphs.
  • Persistent planning wiki: Maintains a blueprint/ markdown knowledge base with SESSION.md, NEXT.md, journal, and ADR decision logs so work resumes cleanly after /clear or crashes.
  • Lint and adversarial review: Runs lint passes after every phase to catch gaps, contradictions, and uncited claims, with optional multi-agent setups (Researcher, Curator, Linter, Auditor) for Claude Code users.
  • Use Case: A developer pastes a SaaS product idea and asks for a full implementation plan; the Skill produces an interlinked wiki covering architecture, pipelines, components, data model, and a sequenced action-point list ready to hand off to an execution tool.

Quick Start

Ask the assistant to use the bleu skill to turn your project idea into a complete end-to-end system blueprint with architecture, components, and action points before writing any code.

Frequently Asked Questions about bleu

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a full system architecture plan before writing code?▼

Invoke the skill with your idea and it runs a phased workflow: intake and scoping, mandatory web research, vision and architecture drafting, component breakdown, data modeling, and decomposition into action points. The output is a markdown wiki under blueprint/ rather than a single document.

How do I resume a planning session after clearing the chat context?▼

Say 'where did we leave off' or 'continue this plan' and the skill rehydrates state from disk by reading SESSION.md, NEXT.md, index.md, the ADR index, and recent journal entries. Every session ends with a persistence ritual that rewrites these files so nothing is lost.

Does this planning skill work inside Claude Code?▼

Yes, it detects Claude Code and offers optional integrations: a KB Curator subagent, SessionStart and FileChanged hooks, git auto-commits scoped to blueprint/, and inline MCP servers. All integrations are shown for approval before any files are written.

What is an action point in the blueprint workflow?▼

An action point is one executable unit of implementation work with named files, function-level code flow, interfaces, dependencies on other APs, verification steps, and a complexity estimate. A substantial system is decomposed into roughly 38 APs with a mermaid dependency graph.

When should I not use a heavy planning workflow like this?▼

Skip it for small tasks; the Phase 0 intake explicitly sizes the workflow, choosing coarse decomposition of 3-5 action points for small jobs. The skill itself warns against applying a 38-AP blueprint to minor changes.

Related Skills

Explore More Software Engineering Skills→
cjenningscjennings

arch-design

Capture stakeholders, drivers, constraints, and requirements to produce a .architecture/brief.md.

Community
Advanced
sunholo-datasunholo-data
33

AILANG Sprint Executor

Execute approved sprint plans with test-driven development and lint checks.

Official
Intermediate
jfmyers9jfmyers9
8

acceptance

Validate blueprint implementations against acceptance criteria and record verdicts.

Community
Advanced
lootloglootlog
7

simple

Guide brainstorming through Discover, Propose, Converge, and Capture steps.

Official
Intermediate