Battle-tested frameworks for thinking with AI -- not just talking to it.
Distilled from 70+ real-world projects. 11 reasoning frameworks, 8 philosophical archetypes, 48 task prompts, and drop-in Claude Code skills.
If this helps you think better with AI, give it a star -- it helps others find it too.
Option A: Claude Code skill -- copy one file, get a new capability:
# Copy a skill into your project
mkdir -p .claude/skills/adhd-optimize
cp ai-playbook/claude-code/skills/adhd-optimize.md .claude/skills/adhd-optimize/SKILL.md
# Use it
# /adhd-optimize "Your verbose, rambling prompt that could be better"Option B: CLAUDE.md config -- upgrade your entire project:
cp ai-playbook/claude-code/examples/claude-md-adhd.md CLAUDE.mdOption C: Pick a framework and paste it into any AI conversation:
🎯 TASK: Implement user auth
📋 CONTEXT: Cloudflare Workers, JWT, D1 database
✅ OUTPUT: Working auth middleware with tests
⚠️ CONSTRAINTS: No session storage, stateless only
That's the ADHD Prompting Framework -- it works everywhere.
The flagship differentiator. Eight archetypal personas, each a fusion of 3+ wisdom traditions. Not prompt templates -- philosophical lenses that change how the AI thinks.
| Archetype | Essence | Fused From | |
|---|---|---|---|
| 🏰 | Clarity Architect | Structural simplicity | Stoic Guardian + Occam's Minimalist + Cognitive Load Theory |
| 🪞 | Direct Mirror | Immediate insight | Zen Mirror + Phenomenological Observer + Mindful Observer |
| 🎵 | Flow Director | Dynamic harmony | Jazz Director + Flow Guide + Wabi-Sabi Craftsperson |
| 🧱 | Truth Builder | Foundational rigor | First Principles Architect + Empiricist + Falsification Challenger |
| 🔮 | Pattern Synthesizer | Holistic integration | Systems Synthesizer + Pattern Analyst + Gestalt Weaver |
| 🦉 | Wisdom Guide | Ethical integration | Confucian Guide + Circle Keeper + Prudent Synthesizer |
| 📐 | Creative Organizer | Aesthetic function | Bauhaus Architect + Swiss Information + Ma Gardener |
| 🧭 | Purpose Seeker | Authentic discovery | Sufi Seeker + Existential Clarifier + Socratic Investigator |
How to pick: Choose what resonates, not what sounds most useful. Combine two for complex problems.
| Situation | Try |
|---|---|
| Technical complexity | Truth Builder + Pattern Synthesizer |
| Creative exploration | Flow Director + Purpose Seeker |
| Overwhelming information | Clarity Architect + Creative Organizer |
| Unclear objectives | Direct Mirror + Wisdom Guide |
| Ethical considerations | Wisdom Guide + Purpose Seeker |
Full archetype documentation -- each includes philosophical foundations, system prompts, and fusion combination guides.
flowchart TD
START{What are you trying to do?} --> OPTIMIZE[Optimize a prompt]
START --> ANALYZE[Analyze something deeply]
START --> BUILD[Build or design something]
START --> REASON[Reason through a problem]
START --> PERSONA[Change how the AI thinks]
OPTIMIZE --> ADHD[**ADHD Prompting**<br/>40-60% token reduction<br/>works everywhere]
OPTIMIZE --> CE[**Context Engineering**<br/>long conversations<br/>context window design]
ANALYZE --> METRICS[**METRICS+**<br/>5-layer analysis<br/>cross-domain insights]
ANALYZE --> EGAF[**EGAF**<br/>global analysis<br/>cultural adaptability]
BUILD --> FRACTAL[**Fractal**<br/>macro/meso/micro<br/>architecture decisions]
BUILD --> MCPA[**MCPA**<br/>agent coordination<br/>multi-agent systems]
REASON --> ECARLM[**ECARLM**<br/>state evolution<br/>complex reasoning chains]
REASON --> ELSF[**ELSF**<br/>logic-based<br/>formal derivation]
REASON --> RV2[**Reasoning v2**<br/>structured verification<br/>general reasoning]
BUILD --> PROD[**Production AI Patterns**<br/>grounding + hallucination prevention<br/>agentic systems]
BUILD --> GOV[**Agent Governance**<br/>authority tiers + constraints<br/>autonomous agents]
PERSONA --> VIBE[**Vibecoding**<br/>8 archetypes<br/>philosophical lenses]
style ADHD fill:#4CAF50,color:#fff
style VIBE fill:#9C27B0,color:#fff
style FRACTAL fill:#2196F3,color:#fff
style METRICS fill:#FF9800,color:#fff
style CE fill:#4CAF50,color:#fff
style MCPA fill:#2196F3,color:#fff
style ECARLM fill:#F44336,color:#fff
style EGAF fill:#FF9800,color:#fff
style ELSF fill:#F44336,color:#fff
style RV2 fill:#F44336,color:#fff
style PROD fill:#607D8B,color:#fff
style GOV fill:#607D8B,color:#fff
Start here: ADHD Prompting is the universal upgrade -- it makes every other framework work better.
Drop-in skills and CLAUDE.md configurations. The fastest way to use these frameworks.
| Skill | Framework | What it does |
|---|---|---|
clarity-architect |
Vibecoding | Structural simplicity lens |
direct-mirror |
Vibecoding | Immediate insight — cut through confusion |
flow-director |
Vibecoding | Dynamic harmony — structured improvisation |
truth-builder |
Vibecoding | First-principles challenge |
pattern-synthesizer |
Vibecoding | Holistic systems thinking |
wisdom-guide |
Vibecoding | Ethical integration — stakeholder harmony |
creative-organizer |
Vibecoding | Aesthetic function — beautiful structure |
purpose-seeker |
Vibecoding | Authentic discovery — find the real "why" |
adhd-optimize |
ADHD Prompting | Rewrite any prompt for 40-60% token reduction |
context-audit |
Context Engineering | Audit conversation context efficiency |
fractal-decompose |
Fractal | Macro/meso/micro problem decomposition |
ship-feature |
Composite | 5-stage feature development pipeline |
ship |
Production | Self-healing release pipeline: pre-flight → typecheck → version → deploy → verify |
governed-deploy |
Production | Pre-deploy audit gate: blocks on type errors, failing tests, missing version, or secrets in diff |
adversarial-review |
Production | Adversarial code review — hunt bugs and security issues, CRITICAL/HIGH/MID severity |
structured-review |
Production | Balanced PR review rubric: security, correctness, error handling, test coverage |
| Config | Best for |
|---|---|
claude-md-adhd |
Any project (universal upgrade) |
claude-md-fullstack |
Full-stack web development |
claude-md-research |
Research and analysis |
# Quick setup — install all skills
for f in ai-playbook/claude-code/skills/*.md; do
name=$(basename "$f" .md)
mkdir -p ".claude/skills/$name"
cp "$f" ".claude/skills/$name/SKILL.md"
done| Framework | Key Strength | Best For | Complexity |
|---|---|---|---|
| ADHD Prompting | Clarity through constraint | Every interaction (universal upgrade) | Low |
| Context Engineering | Token efficiency & emergence | Long conversations, multi-turn tasks | Low-Medium |
| METRICS+ | Pattern recognition | Deep analysis, decision-making | Medium |
| Fractal | Structured decomposition | Architecture decisions, system design | Medium-High |
| MCPA | Multi-agent coordination patterns | Systems with 2+ collaborating agents | Medium-High |
| ECARLM | Multi-scale state evolution | Complex reasoning chains | High |
| EGAF | Cultural adaptability | Global, multi-domain problems | Medium-High |
| ELSF | Logic & pattern integration | Formal analysis, logical derivation | Medium |
| Reasoning v2 | Comprehensive reasoning | General problem-solving | Medium |
| Production AI Patterns | Grounding + hallucination prevention | Agentic systems that hold up in production | Medium |
| Agent Governance | Authority tiers + constraint surfaces | Running autonomous agents without losing control | Medium |
ai-playbook/
claude-code/ # Drop-in Claude Code skills and CLAUDE.md configs
skills/ # Slash command skills
examples/ # Example CLAUDE.md configurations
frameworks/ # 9 reasoning and interaction frameworks
adhd-prompting/ # Cognitive-constraint-optimized prompting
context-engineering/ # Context window as designable system
ECARLM/ # Cellular automata reasoning for LLMs
EGAF/ # Enhanced Global Analysis Framework
elsf/ # Logic-based synergistic reasoning
fractal/ # Multi-scale reasoning (macro/meso/micro)
mcpa/ # Modular Context Protocol Architecture
metricsplus/ # Layered analytical framework
reasoning/ # Structured reasoning methodology
production-ai-patterns/ # Selection, grounding, hallucination prevention
agent-governance/ # Authority tiers, constraint surfaces, standing orders
tasks/ # 48 domain-specific prompts
vibecoding/ # The Eight Essential Archetypes
coding/ # Code generation, review, optimization
writing/ # Content creation and editing
analysis/ # Data and content analysis
audio/ # Audio/music analysis and generation
design/ # Design and visual creation
chains/ # Multi-step composite workflows
templates/ # Reusable prompt templates
tools/ # Search, indexing, and optimization utilities
Working utilities that ship with the playbook:
# Optimize any prompt (40-60% token reduction)
python tools/adhd-optimizer/optimize.py "Your long prompt here"
# Search all prompts by keyword, tag, or archetype
python tools/search-prompts.py "code review"
python tools/search-prompts.py -a "Truth Builder"
# Analyze context efficiency
python tools/context-analyzer.py your-prompt.md
# Rebuild the search index
python tools/index-prompts.pyThis isn't a prompt template collection. Three things set it apart:
-
Philosophical depth -- Vibecoding archetypes are fused from 29 wisdom traditions. They change how the AI thinks, not just what it says.
-
Composable frameworks -- Frameworks aren't isolated. The Ship a Feature chain composes Fractal + Truth Builder + ADHD Prompting + Context Engineering into a single pipeline.
-
Production-tested -- Every framework was forged in production across 70+ projects spanning serverless infrastructure, game design, content systems, and more. Not theoretical.
-
Agentic systems coverage -- Production AI Patterns and Agent Governance address what most AI frameworks skip: what goes wrong when LLMs run autonomously, and how to structure systems so they don't.
Contributions welcome. See CONTRIBUTING.md.
Priority areas: new chains composing existing frameworks, Claude Code skills for remaining archetypes, domain-specific CLAUDE.md configs.
Part of the Stackbilt open-source ecosystem:
| Project | What it does |
|---|---|
| AI Playbook | Frameworks for thinking with AI |
| Charter | AI governance CLI for project context management |
| Contracts | Type-safe contract ontology for AI agents |
| CodeBeast | Adversarial code review agent |
| CC-Taskrunner | Autonomous task queue for Claude Code |
| LLM Providers | Multi-LLM failover with circuit breakers |
| Worker Observability | Edge observability stack |
Extracted from 70+ projects built over two years of intensive AI-native development. The frameworks aren't theoretical -- they were forged in production, refined through thousands of hours of human-AI collaboration, and battle-tested across domains from serverless infrastructure to game design.
Built by Kurt Overmier / Stackbilt
MIT -- use it, fork it, make it yours.