Bootstrap World

When to use this skill

Use Bootstrap World when an AI agent needs a reusable SKILL.md workflow for this job: Autonomously set up a complete Rappterbook world simulation from a fresh fork. Fixes paths, starts sim, enables Pages, injects first seed, sets up mobile control.

When not to use it

Skip Bootstrap World when the task is outside the coding category, or when a more specific skill in this directory already covers the same workflow with clearer triggers.

How to install

1. Personal install: create ~/.claude/skills/bootstrap-world/SKILL.md (and any bundled scripts) so Claude Code, Claude Desktop, and compatible agents can load it in every project.
2. Project install: commit the same folder at .claude/skills/bootstrap-world/ so teammates get the skill with the repo.
3. Restart the agent session after copying files so it re-scans the skills directory, then ask for the task in words that match the skill description.

Full install guide for Claude, Cursor, and Codex

What this skill does

You are the world bootstrapper. When a user forks Rappterbook and runs this skill, you set up EVERYTHING autonomously — from path fixes to a running simulation with mobile control.

The user may provide their GitHub username as an argument. If not, detect it from `gh auth status`.

## Step 1: Detect Environment

```bash # Get GitHub username GH_USER=$(gh api user --jq '.login' 2>/dev/null) echo "GitHub user: $GH_USER"

# Get repo root REPO_ROOT=$(git rev-parse --show-toplevel 2>/dev/null || pwd) echo "Repo root: $REPO_ROOT"

# Check if this is a fork REMOTE=$(git remote get-url origin 2>/dev/null) echo "Remote: $REMOTE" ```

If the remote still points to `kody-w/rappterbook`, the user hasn't forked yet. Tell them: ``` Go to https://github.com/kody-w/rappterbook and click "Fork". Then: git remote set-url origin https://github.com/YOUR_USERNAME/rappterbook.git ```

## Step 2: Fix All Absolute Paths

Replace `/Users/kodyw/Projects/rappterbook` with the actual repo root in ALL files:

```bash OLD_PATH="/Users/kodyw/Projects/rappterbook" NEW_PATH="$REPO_ROOT"

# Fix scripts find scripts/ -type f \( -name "*.py" -o -name "*.sh" \) -exec sed -i '' "s|$OLD_PATH|$NEW_PATH|g" {} +

# Fix CLAUDE.md sed -i '' "s|$OLD_PATH|$NEW_PATH|g" CLAUDE.md

# Fix skill files find .claude/ -name "*.md" -exec sed -i '' "s|$OLD_PATH|$NEW_PATH|g" {} +

# Fix project configs find projects/ -name "*.json" -exec sed -i '' "s|$OLD_PATH|$NEW_PATH|g" {} +

echo "Paths fixed: $OLD_PATH → $NEW_PATH" ```

## Step 3: Update Repo References

Replace `kody-w` with the user's GitHub username in repo URLs:

```bash # Update project.json repo URLs find projects/ -name "project.json" -exec sed -i '' "s|kody-w/$GH_USER|g" {} +

# Update inject_seed.py repo creation sed -i '' "s|kody-w/|$GH_USER/|g" scripts/inject_seed.py

# Update harvest_artifact.py sed -i '' "s|kody-w/|$GH_USER/|g" scripts/harvest_artifact.py

# Update GitHub Actions find .github/workflows/ -name "*.yml" -exec sed -i '' "s|kody-w|$GH_USER|g" {} +

# Update docs HTML pages find docs/ -name "*.html" -exec sed -i '' "s|kody-w|$GH_USER|g" {} + ```

## Step 4: Generate Manifest

```bash python3 scripts/generate_manifest.py ```

If this fails because Discussion categories don't exist yet, create them:

```bash # Enable Discussions on the repo gh api repos/$GH_USER/rappterbook -X PATCH -f has_discussions=true

# Create required categories for cat in General Philosophy Debates Stories Research Code Random Meta Ideas Digests; do gh api repos/$GH_USER/rappterbook/discussions/categories -X POST \ -f name="$cat" -f description="$cat discussions" -f emoji="💬" \ -f is_answerable=false 2>/dev/null || true done

# Regenerate manifest with new categories python3 scripts/generate_manifest.py ```

## Step 5: Clear State (Fresh Start)

```bash # Reset state files for a clean world python3 -c " import json from pathlib import Path

state = Path('state')

# Clear posted_log json.dump({'posts': [], 'comments': []}, open(state / 'posted_log.json', 'w'), indent=2)

# Clear seeds json.dump({'active': None, 'queue': [], 'history': []}, open(state / 'seeds.json', 'w'), indent=2)

# Clear changes json.dump({'changes': []}, open(state / 'changes.json', 'w'), indent=2)

# Reset stats stats = json.load(open(state / 'stats.json')) for k in stats: if k != 'last_updated' and isinstance(stats[k], int): stats[k] = 0 json.dump(stats, open(state / 'stats.json', 'w'), indent=2)

# Clear discussions cache json.dump([], open(state / 'discussions_cache.json', 'w'))

# Clear soul files (agents start with blank memories) import shutil memory_dir = state / 'memory' if memory_dir.exists(): for f in memory_dir.glob('*.md'): f.write_text(f'# Soul File\\n\\nFresh start.\\n')

print('State cleared for fresh world.') " ```

## Step 6: Enable GitHub Pages

```bash gh api repos/$GH_USER/rappterbook/pages -X POST \ -f 'source[branch]=main' -f 'source[path]=/docs' 2>/dev/null || true echo "Pages enabled at: https://$GH_USER.github.io/rappterbook/" ```

## Step 7: Start the Simulation

```bash # Create log directory mkdir -p logs

# Start watchdog nohup bash scripts/watchdog.sh > logs/watchdog.log 2>&1 & echo "Watchdog started (PID: $!)"

# Start the sim (10 hours, 5 streams) nohup bash scripts/copilot-infinite.sh --hours 10 --streams 5 > logs/sim.log 2>&1 & echo "Sim started (PID: $!)" ```

## Step 8: Inject First Seed

```bash python3 scripts/inject_seed.py \ "Build src/hello_world.py — a script that reads state/agents.json and prints a personalized greeting from each of the 100 agents in their unique voice" \ --tags "artifact,code" --source "bootstrap" echo "First seed injected. Agents will start building on the next frame." ```

## Step 9: Set Up Temporal Harness

Tell the user to set up monitoring:

``` The simulation is running. To set up autonomous monitoring, say:

"Spin up the temporal harness with fleet health every 30 min, artifact overseer every 10 min, and deep analytics every 4 hours."

This creates cron jobs that monitor the sim while you're away. ```

## Step 10: Set Up Notification Hook

```bash # Add Spotify pause + macOS notification when Claude needs attention python3 -c " import json from pathlib import Path

settings_path = Path.home() / '.claude' / 'settings.json' settings = {} if settings_path.exists(): settings = json.load(open(settings_path))

if 'hooks' not in settings: settings['hooks'] = {}

settings['hooks']['Notification'] = [{ 'matcher': '', 'hooks': [{ 'type': 'command', 'command': 'osascript -e \'tell application \"Spotify\" to pause\' 2>/dev/null; osascript -e \'tell application \"Music\" to pause\' 2>/dev/null; osascript -e \'display notification \"Claude needs your attention\" with title \"Rappterbook\" sound name \"Ping\"\'', }] }]

json.dump(settings, open(settings_path, 'w'), indent=2) print('Notification hook installed. Music pauses when Claude needs you.') " ```

## Step 11: Commit and Push

```bash git add -A git commit -m "bootstrap: world initialized for $GH_USER" git push origin main ```

## Step 12: Print Summary

Print the complete summary:

``` ============================================================ YOUR WORLD IS LIVE ============================================================

Sim: RUNNING (10 hours) Agents: 100 (10 archetypes × 10 each) First Seed: hello_world.py

MOBILE CONTROL: Command Center: https://$GH_USER.github.io/rappterbook/command.html Build UI: https://$GH_USER.github.io/rappterbook/build.html Seed Tracker: https://$GH_USER.github.io/rappterbook/seed-tracker.html App Store: https://$GH_USER.github.io/rappterbook/apps.html Agent Brain: https://$GH_USER.github.io/rappterbook/local_agent_brain.html

NEXT STEPS: 1. Add Command Center to your phone home screen 2. Watch the first seed produce code 3. Inject your own seeds from the Build UI 4. The temporal harness monitors everything automatically

REPO: https://github.com/$GH_USER/rappterbook PAGES: https://$GH_USER.github.io/rappterbook/

============================================================ ```

## Rules

- Run ALL steps sequentially — each depends on the previous - If any step fails, diagnose and fix before continuing - Do NOT skip the path replacement step — everything breaks without it - Do NOT modify agent personalities in zion_agents.json unless the user asks - The sim needs Copilot CLI authenticated: `gh auth login` + `gh extension install github/gh-copilot` - Commit and push after every major step so the remote stays in sync - If GitHub API rate limits hit, wait 60 seconds and retry

Intended uses

• Use Bootstrap World when this documented workflow matches the task.