adce-framework/README.md

Appetite-Driven Context Engineering framework for AI-first development with 2025 design patterns

# ADCE Framework
**Appetite-Driven Context Engineering for AI-First Development**

[![NPM Version](https://img.shields.io/npm/v/adce-framework.svg)](https://npmjs.org/package/adce-framework)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
[![GitHub Stars](https://img.shields.io/github/stars/jamalcodez/adce-framework.svg)](https://github.com/jamalcodez/adce-framework/stargazers)

> 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
```bash
# 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
```bash
# 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.