arm-onboardinglisted
Install: claude install-skill CarlosCaPe/octorato
# Arm Onboarding — Creating a New Client Repo
A "new arm" = a new isolated client repository under `~/Documents/github/<CLIENT>/`. Arms inherit all brain rules automatically through `sync-ai-docs`. This skill is the canonical sequence.
## Required Files (per arm)
Every arm MUST have:
| Path | Purpose | Notes |
|---|---|---|
| `.claude/CLAUDE.md` | Single source of truth for the arm — project stack, connections, conventions | Edit this one only; sync propagates the rest |
| `.github/copilot-instructions.md` | Auto-synced copy of `.claude/CLAUDE.md` | NEVER edit directly. `sync-ai-docs` overwrites it |
| `.cursorrules` | Auto-synced copy for Cursor editor | NEVER edit directly. `sync-ai-docs` overwrites it |
| `README.md` | Human-readable repo intro | Project overview + quick-start |
| `.gitignore` | Must include `.env`, `.env.*`, `.dev.vars` | Belt-and-suspenders against secret leaks |
| `.env` | Local secrets, never committed | Gitignored — only on operator's machine |
| `.claude/memory/` | Arm-brain: arm-specific memories, MEMORY.md index, one-fact-per-file | Committed to the arm's own private repo; loaded by the harness via a symlink from `~/.claude/projects/<arm-slug>/memory` |
## Sequence
```bash
# 1. Create the arm directory + initialize git
mkdir <CLIENT> && cd <CLIENT> && git init
# 2. Create the brain-aware structure
mkdir -p .claude .github
touch README.md .gitignore .env
# 3. Write .claude/CLAUDE.md (project stack, conventions, connections)
# See "Arm CLA