Compare commits
1 Commits
template-r
...
bootstrap-
Author | SHA1 | Date | |
---|---|---|---|
d6d60355fd |
@@ -2,26 +2,53 @@
|
|||||||
|
|
||||||
**FOR: Gemini-CLI, Claude, OpenCode, all AI tools working with CTO delegation template**
|
**FOR: Gemini-CLI, Claude, OpenCode, all AI tools working with CTO delegation template**
|
||||||
|
|
||||||
## CRITICAL SETUP (FIRST TIME ONLY)
|
## 🚨 MANDATORY FIRST STEP - BOOTSTRAP PROCESS
|
||||||
**This template requires initial git setup:**
|
**EVERY AI AGENT MUST EXECUTE THIS EXACT SEQUENCE IMMEDIATELY:**
|
||||||
|
|
||||||
|
### Step 1: Git Repository Setup (REQUIRED)
|
||||||
```bash
|
```bash
|
||||||
git init
|
git init
|
||||||
git add .
|
git add .
|
||||||
git commit -m "Initial commit from CTO template"
|
git commit -m "Initial commit from CTO delegation template"
|
||||||
git branch -M main
|
git branch -M main
|
||||||
git remote add origin YOUR_REPO_URL
|
git remote add origin YOUR_REPO_URL
|
||||||
git push -u origin main
|
git push -u origin main
|
||||||
```
|
```
|
||||||
|
|
||||||
**Create required branches:**
|
### Step 2: Create Bootstrap Branch (REQUIRED)
|
||||||
```bash
|
```bash
|
||||||
git checkout -b INTEGRATION-WIP && git push -u origin INTEGRATION-WIP
|
git checkout -b bootstrap
|
||||||
git checkout -b RELEASE && git push -u origin RELEASE
|
git push -u origin bootstrap
|
||||||
git checkout main
|
|
||||||
```
|
```
|
||||||
|
|
||||||
|
### Step 3: Create Workflow Branches (REQUIRED)
|
||||||
|
```bash
|
||||||
|
git checkout -b INTEGRATION-WIP && git push -u origin INTEGRATION-WIP
|
||||||
|
git checkout -b RELEASE && git push -u origin RELEASE
|
||||||
|
git checkout bootstrap
|
||||||
|
```
|
||||||
|
|
||||||
|
### Step 4: Update Template Files (REQUIRED)
|
||||||
|
**You MUST update these template placeholders IMMEDIATELY:**
|
||||||
|
1. Update `docs/WORKLOG-LLM.md` - Fill ALL `[BRACKETED_FIELDS]`
|
||||||
|
2. Update `docs/CURRENTWORK-LLM.md` - Fill project info section
|
||||||
|
3. Commit bootstrap setup:
|
||||||
|
```bash
|
||||||
|
git add .
|
||||||
|
git commit -m "Bootstrap: Initialize project with CTO delegation template"
|
||||||
|
git push origin bootstrap
|
||||||
|
```
|
||||||
|
|
||||||
|
### Step 5: Tag Bootstrap Milestone (REQUIRED)
|
||||||
|
```bash
|
||||||
|
git tag -a bootstrap-complete -m "CTO delegation template bootstrap completed - project ready for AI development"
|
||||||
|
git push origin bootstrap-complete
|
||||||
|
```
|
||||||
|
|
||||||
|
**⚠️ CRITICAL: You are now on `bootstrap` branch and MUST remain here for initial project setup work.**
|
||||||
|
|
||||||
## CRITICAL RULES
|
## CRITICAL RULES
|
||||||
1. NEVER work on `main` branch - Always use feature branches
|
1. **NEVER TOUCH `main` BRANCH** - Main is HUMAN-ONLY, AI agents use `bootstrap` as base
|
||||||
2. NEVER auto-delete feature branches - Preserve all branches permanently
|
2. NEVER auto-delete feature branches - Preserve all branches permanently
|
||||||
3. ALWAYS push before switching branches - Never lose work
|
3. ALWAYS push before switching branches - Never lose work
|
||||||
4. Push every 10 commits max - Keep work backed up
|
4. Push every 10 commits max - Keep work backed up
|
||||||
@@ -32,8 +59,8 @@ git checkout main
|
|||||||
|
|
||||||
**Start new feature (EXACT sequence):**
|
**Start new feature (EXACT sequence):**
|
||||||
```bash
|
```bash
|
||||||
git checkout main
|
git checkout bootstrap
|
||||||
git pull origin main
|
git pull origin bootstrap
|
||||||
git checkout -b feature/TASK-NAME
|
git checkout -b feature/TASK-NAME
|
||||||
```
|
```
|
||||||
|
|
||||||
@@ -44,26 +71,40 @@ git commit -m "SPECIFIC_DESCRIPTION_OF_CHANGES"
|
|||||||
git push origin CURRENT-BRANCH-NAME
|
git push origin CURRENT-BRANCH-NAME
|
||||||
```
|
```
|
||||||
|
|
||||||
**Tag completed milestone:**
|
**Tag completed milestone (ALWAYS PUSH):**
|
||||||
```bash
|
```bash
|
||||||
git tag -a MILESTONE-NAME -m "DETAILED_DESCRIPTION_OF_COMPLETION"
|
git tag -a MILESTONE-NAME -m "DETAILED_DESCRIPTION_OF_COMPLETION"
|
||||||
git push origin MILESTONE-NAME
|
git push origin MILESTONE-NAME
|
||||||
```
|
```
|
||||||
|
|
||||||
## BRANCH STRUCTURE (CREATE THESE)
|
## BRANCH STRUCTURE (CREATED BY BOOTSTRAP)
|
||||||
- **`main`** - Stable, protected, no direct commits
|
- **`main`** - **HUMAN-ONLY** - Never touched by AI agents (template baseline)
|
||||||
|
- **`bootstrap`** - AI agents' base branch for all work (template setup and development)
|
||||||
- **`INTEGRATION-WIP`** - Auto-merge target for testing features
|
- **`INTEGRATION-WIP`** - Auto-merge target for testing features
|
||||||
- **`RELEASE`** - Manual PR target for production releases
|
- **`RELEASE`** - Manual PR target for production releases
|
||||||
- **`feature/TASK-NAME`** - All development work (descriptive names)
|
- **`feature/TASK-NAME`** - All development work branches from bootstrap (descriptive names)
|
||||||
|
|
||||||
## DETERMINISTIC WORKFLOW
|
## DETERMINISTIC WORKFLOW
|
||||||
1. **Always start from main:** `git checkout main && git pull origin main`
|
|
||||||
|
### Phase 1: Bootstrap (FIRST SESSION ONLY)
|
||||||
|
1. **Execute mandatory bootstrap process above** (Steps 1-5)
|
||||||
|
2. **Work on bootstrap branch** for initial template setup
|
||||||
|
3. **Add READYSET and template files** (future enhancement)
|
||||||
|
4. **Tag bootstrap-complete** when setup finished
|
||||||
|
|
||||||
|
### Phase 2: Feature Development (ONGOING)
|
||||||
|
1. **Always start from bootstrap:** `git checkout bootstrap && git pull origin bootstrap`
|
||||||
2. **Create specific branch:** `git checkout -b feature/EXACT-TASK-NAME`
|
2. **Create specific branch:** `git checkout -b feature/EXACT-TASK-NAME`
|
||||||
3. **Work in small chunks:** Commit every logical change
|
3. **Work in small chunks:** Commit every logical change
|
||||||
4. **Push frequently:** Every 5-10 commits or before any branch switch
|
4. **Push frequently:** Every 5-10 commits or before any branch switch
|
||||||
5. **Never delete branches:** Preserve all feature branches permanently
|
5. **Never delete branches:** Preserve all feature branches permanently
|
||||||
6. **Tag milestones:** When features/stages complete
|
6. **Tag milestones:** When features/stages complete
|
||||||
|
|
||||||
|
### Phase 3: Integration & Release
|
||||||
|
1. **Features auto-merge to INTEGRATION-WIP** (testing)
|
||||||
|
2. **Manual PRs to RELEASE** (production)
|
||||||
|
3. **Never delete any branches** (complete history preservation)
|
||||||
|
|
||||||
## MILESTONE TAGGING (DETERMINISTIC)
|
## MILESTONE TAGGING (DETERMINISTIC)
|
||||||
**When to tag:**
|
**When to tag:**
|
||||||
- Feature completely implemented and tested
|
- Feature completely implemented and tested
|
||||||
@@ -75,6 +116,12 @@ git push origin MILESTONE-NAME
|
|||||||
- `milestone-YYYY-MM-DD-DESCRIPTION` (date+description)
|
- `milestone-YYYY-MM-DD-DESCRIPTION` (date+description)
|
||||||
- `stage-NAME-done` (stage complete)
|
- `stage-NAME-done` (stage complete)
|
||||||
|
|
||||||
|
**ALWAYS push tags immediately:**
|
||||||
|
```bash
|
||||||
|
git tag -a TAG-NAME -m "DESCRIPTION"
|
||||||
|
git push origin TAG-NAME
|
||||||
|
```
|
||||||
|
|
||||||
## WORKLOG MAINTENANCE (MANDATORY)
|
## WORKLOG MAINTENANCE (MANDATORY)
|
||||||
**Update these files every session:**
|
**Update these files every session:**
|
||||||
- **docs/WORKLOG-LLM.md** - Current status, progress, next actions
|
- **docs/WORKLOG-LLM.md** - Current status, progress, next actions
|
||||||
|
76
start-ai-delegation.sh
Executable file
76
start-ai-delegation.sh
Executable file
@@ -0,0 +1,76 @@
|
|||||||
|
#!/bin/bash
|
||||||
|
|
||||||
|
# CTO AI Delegation Automation Script
|
||||||
|
# Automatically invokes Claude with the CTO delegation template instructions
|
||||||
|
|
||||||
|
set -e # Exit on any error
|
||||||
|
|
||||||
|
echo "🚀 CTO AI Delegation Template - Starting Claude with Instructions"
|
||||||
|
echo "=================================================="
|
||||||
|
|
||||||
|
# Check if Claude CLI is installed
|
||||||
|
if ! command -v claude &> /dev/null; then
|
||||||
|
echo "❌ Error: Claude CLI not found!"
|
||||||
|
echo "📦 Install with: npm install -g @anthropic-ai/claude-code"
|
||||||
|
echo "📚 See: https://docs.anthropic.com/en/docs/claude-code/setup"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Check if we're in a directory with the template
|
||||||
|
if [ ! -f "docs/AGENT-LLM.MD" ]; then
|
||||||
|
echo "❌ Error: CTO delegation template not found!"
|
||||||
|
echo "📁 Make sure you're in a directory with the extracted template"
|
||||||
|
echo "📋 Expected: docs/AGENT-LLM.MD should exist"
|
||||||
|
exit 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Check if git is initialized
|
||||||
|
if [ ! -d ".git" ]; then
|
||||||
|
echo "⚠️ Git repository not initialized yet"
|
||||||
|
echo "🔧 The AI agent will initialize it as part of the bootstrap process"
|
||||||
|
else
|
||||||
|
echo "✅ Git repository detected"
|
||||||
|
fi
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "🤖 Starting Claude with CTO delegation instructions..."
|
||||||
|
echo "📋 Claude will read docs/AGENT-LLM.MD and execute the bootstrap process"
|
||||||
|
echo "🚨 CRITICAL: Main branch is HUMAN-ONLY - AI will work on bootstrap branch"
|
||||||
|
echo ""
|
||||||
|
|
||||||
|
# Prompt for repository URL if not already configured
|
||||||
|
if [ ! -d ".git" ]; then
|
||||||
|
echo "🔗 You'll need your repository URL for the bootstrap process"
|
||||||
|
read -p "📥 Enter your repository URL (or press Enter to set later): " REPO_URL
|
||||||
|
if [ ! -z "$REPO_URL" ]; then
|
||||||
|
echo "📝 Repository URL: $REPO_URL"
|
||||||
|
echo "💡 Tell Claude to use this URL when prompted"
|
||||||
|
fi
|
||||||
|
echo ""
|
||||||
|
fi
|
||||||
|
|
||||||
|
# Create the prompt for Claude
|
||||||
|
PROMPT="I am a CTO using the AI delegation template. Please read and execute the instructions in docs/AGENT-LLM.MD immediately.
|
||||||
|
|
||||||
|
Key requirements:
|
||||||
|
1. Execute the MANDATORY BOOTSTRAP PROCESS first (Steps 1-5)
|
||||||
|
2. NEVER touch the main branch - it's HUMAN-ONLY
|
||||||
|
3. Work on the bootstrap branch for all AI development
|
||||||
|
4. Follow the exact deterministic command sequences
|
||||||
|
5. Update all template placeholders in the worklog files
|
||||||
|
6. Be extremely strict about the git workflow
|
||||||
|
|
||||||
|
Start by reading docs/AGENT-LLM.MD and executing the bootstrap process now."
|
||||||
|
|
||||||
|
# Start Claude with the instructions
|
||||||
|
echo "🎯 Invoking Claude with CTO delegation instructions..."
|
||||||
|
echo "=================================================="
|
||||||
|
claude -p "$PROMPT"
|
||||||
|
|
||||||
|
echo ""
|
||||||
|
echo "✅ Claude session completed"
|
||||||
|
echo "📋 Check your repository for the bootstrap branch and milestone tag"
|
||||||
|
echo "🏷️ Look for: bootstrap-complete tag"
|
||||||
|
echo "🌳 Verify branches: bootstrap, INTEGRATION-WIP, RELEASE"
|
||||||
|
echo ""
|
||||||
|
echo "🚀 Your CTO AI delegation framework is ready!"
|
Reference in New Issue
Block a user