ADCE Framework

Appetite-Driven Context Engineering for AI-First Development

Transform vague ideas into production-ready features using AI agents, appetite constraints, and context engineering.

What is ADCE?

ADCE combines the best of three methodologies:

• Shape Up: Appetite setting, circuit breakers, and scope management
• Product Requirement Prompts (PRP): Context engineering for AI success
• Subagents: Specialized AI agents with domain expertise

Result: Turn broad ideas into working software within predictable timeframes.

Quick Start

1. Install the Framework

# Global installation (recommended)
npm install -g adce-framework
adce install

# Or local installation
npm install adce-framework
npx adce-framework install

2. Start Your First Cycle

# Create a pitch from your idea
"Use shaper to create a pitch for: [your broad idea]"

# Review technical feasibility  
"Use architect to review this pitch for feasibility"

# Start building
"Use builder to implement dashboard components"
"Use deployer to set up production deployment"
Why ADCE Works
❌ Traditional Problems:

Vague prompts → unusable AI output
No scope discipline → endless iteration
Context loss → repeated explanations
No systematic approach → inconsistent results

✅ ADCE Solutions:

Systematic refinement: Ideas → working software
Appetite constraints: Prevent scope creep
Context engineering: Enable AI first-pass success
Specialized agents: Domain expertise + consistency

The Four Core Agents
🎯 shaper
Turns broad ideas into appetite-bounded pitches with comprehensive context
🏗️ architect
Manages technical implementation, architecture decisions, and scope within appetite
🎨 builder
Handles UI/UX design and frontend development within constraints
🚀 deployer
Gets features safely to production and maintains system reliability
Real Results
Finance Dashboard: "Users want better financial insights" → Working dashboard with spending breakdown in 1.5 weeks (AI-accelerated)
User Onboarding: "Reduce new user confusion" → Progressive onboarding flow reducing churn 67% in 1 week (AI-accelerated)
Documentation

Getting Started: Your first ADCE cycle
Complete Methodology: Full framework documentation
Real Examples: Complete workflow walkthroughs
Agent Specifications: Detailed agent docs

Requirements

Claude Code (latest version)
Node.js 18+
Git

Community

GitHub Discussions: Framework Q&A
Discord Server: Real-time help and community

Contributing
We welcome contributions! See CONTRIBUTING.md for guidelines.
License
MIT License - see LICENSE for details.
Turn your broad ideas into working software with predictable timeframes.