orchestrate-replicate

name	orchestrate:replicate
description	Bootstrap orchestrate skills into a target repo - making it self-sufficient for orchestrating its own related repos

flowchart TD
    START(["/orchestrate:replicate"]) --> COPY["Copy orchestrate skills"]:::orch
    COPY --> ADAPT["Adapt references"]:::orch
    ADAPT --> UPDATE["Update target CLAUDE.md"]:::orch
    UPDATE --> VALIDATE["Validate skills"]:::orch
    VALIDATE --> BRANCH["Create branch"]:::orch
    BRANCH --> PR["Commit + open PR"]:::orch
    PR --> DONE([Target self-sufficient])

    classDef orch fill:#FF9800,stroke:#333,color:white

Follow this diagram as the workflow.

Orchestrate: Replicate

The final orchestration phase. Copies orchestrate skills into the target repo, making it fully self-sufficient. This is Phase 6.

When to Use

• Final phase of orchestration
• After at least precommit + CI phases are complete
• When you want the target repo to orchestrate its own related repos

Prerequisites

• orchestrate:precommit and orchestrate:ci complete (at minimum)
• Target repo has .claude/ directory

What Gets Copied

Skill	Purpose
orchestrate/	Router — entry point
orchestrate:scan/	Assess repos
orchestrate:plan/	Create phased plans
orchestrate:precommit/	Add pre-commit hooks
orchestrate:ci/	Add CI workflows
orchestrate:tests/	Add test infrastructure
orchestrate:security/	Add security hardening
orchestrate:replicate/	This skill (self!)
skills:scan/	Discover skills in a repo
skills:write/	Author new skills
skills:validate/	Validate skill structure

Adaptation Steps

After copying, adapt the skills:

1. Remove source-specific references — strip source-repo-specific paths or assumptions that don't apply
2. Verify frontmatter — every name: field must match its directory name
3. Update Related Skills — only reference skills that exist in the copied set
4. Preserve generality — skills should work in any repo context

Update Target CLAUDE.md

Add an orchestration section:

## Orchestration

This repo includes orchestrate skills for enhancing related repos:

| Skill | Description |
|-------|-------------|
| `orchestrate` | Run `/orchestrate <repo-path>` to start |
| `orchestrate:scan` | Assess repo structure and gaps |
| `orchestrate:plan` | Create phased enhancement plan |
| `orchestrate:replicate` | Bootstrap skills into target |

The Fractal Concept

This phase makes the system self-replicating:

1. Repo A orchestrates Repo B through all phases
2. Phase 6 copies orchestrate skills into Repo B
3. Repo B can now orchestrate Repo C
4. Repo C can orchestrate Repo D, and so on

Each copy is independent. No runtime dependency on the original hub. The skills adapt to whatever tech stack the scan discovers.

Validation

After copying, verify:

1. Frontmatter match — name: matches directory for each skill
2. No broken references — Related Skills point to existing skills
3. No source-specific content — grep for original repo name
4. Structure — every directory has exactly one SKILL.md

Branch and PR Workflow

git -C .repos/<target> checkout -b orchestrate/replicate

git -C .repos/<target> add .claude/skills/orchestrate* .claude/skills/skills*

git -C .repos/<target> commit -s -m "feat: bootstrap orchestrate skills for self-sufficient orchestration"

git -C .repos/<target> push -u origin orchestrate/replicate

Related Skills

• orchestrate — Parent router
• orchestrate:security — Previous phase
• skills:scan — Discover skills (gets copied)
• skills:write — Author skills (gets copied)
• skills:validate — Validate skills (gets copied)