# CTO AI Delegation Framework

**Prompts and code for founder CTOs who want to delegate to AI as an entire team.**

---

## 🎯 **For CTO Template Users (Most Users)**

**If you want to use this CTO AI delegation template for your project:**

### ⚠️ **Don't Clone This Repository!**

Instead, download the latest release as a template:

1. **Download Latest Release:** [📦 Latest Release](../../releases/latest)
2. **Extract** the downloaded zip to your project directory
3. **Run Setup:** `./start-ai-delegation.sh` (or follow instructions in extracted files)
4. **Start Delegating:** AI agents will read the included documentation automatically

### 🚀 **Quick Start for Template Users**
```bash
# After extracting the release:
cd your-project-directory
./start-ai-delegation.sh
# Follow the prompts to set up your CTO AI delegation workflow
```

**What You Get:**
- ✅ Complete AI delegation framework
- ✅ Deterministic workflows for AI agents  
- ✅ Professional git workflow with branch protection
- ✅ Real-time progress tracking and dashboards
- ✅ Comprehensive documentation (human + AI optimized)

---

## 🛠️ **For Framework Developers (Repository Contributors)**

**If you want to contribute to the CTO delegation framework itself:**

### Development Setup
```bash
# Clone the repository for development
git clone git@git.knownelement.com:UKRRS/CTO.git
cd CTO

# Switch to development branch (has all the features)
git checkout WORKONMAIN

# See full documentation and development environment
ls docs/
```

### Development Workflow
- **WORKONMAIN** - Long-lived development branch for framework improvements
- **LLMBOOTSTRAP** - Feature development branch  
- **main** - Template baseline (minimal, clean for end users)

### Contributing Guidelines
See [CONTRIBUTING.md](./CONTRIBUTING.md) for detailed development instructions.

---

## 📊 **Repository Information**

### Branch Structure
| Branch | Purpose | Who Uses It |
|--------|---------|-------------|
| **`main`** | Clean template baseline | Template users browsing |
| **`WORKONMAIN`** | Framework development | Contributors |
| **`LLMBOOTSTRAP`** | Feature development | Contributors |

### Latest Releases
| Release | Date | Description |
|---------|------|-------------|
| [phase-2-enhancements-complete](../../releases/tag/phase-2-enhancements-complete) | 2025-09-05 | Full framework with testing, dashboards, git-native integration |
| [bootstrap-framework-complete](../../releases/tag/bootstrap-framework-complete) | 2025-09-05 | Core bootstrap framework |

### Platform Information
- **Git Platform:** Gitea (optimized exclusively)
- **AI Compatibility:** Claude, Gemini-CLI, OpenCode
- **Architecture:** Git-native automation, no external dependencies
- **License:** [View License](./LICENSE)

---

## 🤖 **Framework Features**

- **Deterministic AI Instructions** - Exact command sequences for consistent results
- **Git-Native Automation** - Auto-merge integration via git hooks
- **Progress Dashboards** - Real-time CTO oversight and metrics
- **Bootstrap Testing** - Comprehensive validation framework  
- **Dual Documentation** - Human-readable + AI-optimized versions
- **Branch Protection** - Main branch human-only policy
- **Milestone Tracking** - Complete audit trail and progress markers

---

**Need Help?** 
- **Template Users:** Check the documentation in your downloaded release
- **Developers:** See [CONTRIBUTING.md](./CONTRIBUTING.md) or browse the [WORKONMAIN branch](../../tree/WORKONMAIN)

*Professional AI team delegation framework - Built for founder CTOs*