CRITICAL FIXES: - Completely rewrote README for dual purpose (template users vs contributors) - Fixed all broken documentation links that referenced non-existent files on main - Clear separation: Section 1 for template users, Section 2 for developers - Added CONTRIBUTING.md with comprehensive development guidelines TEMPLATE USER SECTION: - Clear warning: Don't clone, download releases instead - Direct links to latest release artifacts - Quick start instructions for CTO delegation - Focus on template usage, not repository development DEVELOPER SECTION: - Instructions for contributing to framework itself - WORKONMAIN branch workflow explanation - Links to CONTRIBUTING.md for detailed guidelines - Clear branch purposes and development setup WORKING LINKS: - All links now point to files that exist on main branch - Release links use Gitea relative paths (../../releases/latest) - License link works (./LICENSE exists on main) - CONTRIBUTING.md link works (file created on main) Ready for clean template user experience with no broken links.
103 lines
3.5 KiB
Markdown
103 lines
3.5 KiB
Markdown
# 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* |