projecta-rrr 1.24.0 → 1.24.2

package/AGENTS.md

@@ -41,6 +41,7 @@ The RRR loop follows five steps:
 | `$rrr-check-version` | Check version consistency across package.json, CHANGELOG, and planning docs |
 | `$rrr-complete-milestone` | Archive completed milestone and prepare for next version |
 | `$rrr-coordinate-merge` | Generate a GitHub-native coordinator merge readiness report |
+| `$rrr-coordinator-status` | Check Cloudflare coordinator readiness for RRR team mode |
 | `$rrr-create-roadmap` | Create roadmap with phases for the project |
 | `$rrr-debug` | Systematic debugging with persistent state across context resets |
 | `$rrr-define-requirements` | Define what "done" looks like with checkable requirements |
@@ -69,13 +70,17 @@ The RRR loop follows five steps:
 | `$rrr-plan-milestone-gaps` | Create phases to close all gaps identified by milestone audit |
 | `$rrr-plan-phase` | Create detailed execution plan for a phase (PLAN.md) with verification loop |
 | `$rrr-progress` | Check project progress, show context, and route to next action (execute or plan) |
+| `$rrr-provision-coordinator` | Create the Cloudflare coordinator contract for RRR team mode integration review |
+| `$rrr-provision-sprites` | Generate or apply Sprite provisioning for assigned RRR team workstreams |
 | `$rrr-remove-phase` | Remove a future phase from roadmap and renumber subsequent phases |
 | `$rrr-research-phase` | Research how to implement a phase (standalone - usually use /rrr:plan-phase instead) |
 | `$rrr-research-project` | Research domain ecosystem before creating roadmap |
 | `$rrr-resume-work` | Resume work from previous session with full context restoration |
+| `$rrr-runtime-init` | Create a repo-specific runtime manifest for team mode setup, checks, and UAT |
 | `$rrr-savings` | Show token-savings report (session + lifetime) with tier distribution and Opus-rate dashboard |
 | `$rrr-search-skills` | Search for skills on skillsmp.com marketplace |
 | `$rrr-ship` | Create PR from verified work with planning context, or generate SHIP-READY.md |
+| `$rrr-sprite-status` | Check planned or live Sprite readiness for RRR team mode workstreams |
 | `$rrr-submit-phase` | Submit a team-owned phase for coordinator integration review |
 | `$rrr-team-init` | Initialize GitHub-native RRR team mode for a repo pilot |
 | `$rrr-team-status` | Show RRR team-mode phase assignments and submission readiness |
@@ -91,4 +96,4 @@ The RRR loop follows five steps:
 - Use `$rrr-help` for full skill catalogue
 - Trigger phrases are case-sensitive: `$rrr-plan-phase` not `$rrr-PlanPhase`
 
-<!-- generated: 2026-05-12T18:36:28.466Z | source: commands/rrr/*.md | count: 54 skills -->
+<!-- generated: 2026-05-12T23:35:46.267Z | source: commands/rrr/*.md | count: 59 skills -->

package/CHANGELOG.md

@@ -4,6 +4,21 @@ All notable changes to RRR will be documented in this file.
 
 Format follows [Keep a Changelog](https://keepachangelog.com/en/1.1.0/).
 
+## [1.24.2] - 2026-05-12
+
+### Fixed
+- **Sprite exec apply path** — provisioning now inserts `--` before remote commands so Sprite does not parse `bash -lc`, `npx --global`, or setup flags as Sprite CLI flags.
+
+## [1.24.1] - 2026-05-12
+
+### Added
+- **Runtime manifest** — added `$rrr-runtime-init` to create `.planning/RUNTIME.json` with repo-local setup, check, browser UAT, and workdir commands for reusable sandboxes.
+- **Sprite provisioning** — added `$rrr-provision-sprites` and `$rrr-sprite-status` to generate/apply per-team Sprite setup plans without repo-specific images.
+- **Coordinator provisioning** — added `$rrr-provision-coordinator` and `$rrr-coordinator-status` for report-first Cloudflare Sandbox coordinator contracts and readiness checks.
+
+### Changed
+- **Team mode SOP** — documented the reusable org-level image model: one developer Sprite runtime plus one Cloudflare coordinator runtime, with repo specifics supplied by `.planning/RUNTIME.json`.
+
 ## [1.24.0] - 2026-05-12
 
 ### Added

package/README.md

@@ -113,7 +113,10 @@ RRR can pilot GitHub-native team execution where the coordinator assigns phases
 
 ```bash
 /rrr:team-init --github-org PA-MATRIX --milestone v1.24 --runner sprites
+/rrr:runtime-init
 /rrr:assign-phases --team team-runtime --phases 92,95
+/rrr:provision-sprites
+/rrr:provision-coordinator
 /rrr:dispatch-team --team team-runtime
 /rrr:team-status
 ```

package/commands/rrr/coordinator-status.md

@@ -0,0 +1,37 @@
+---
+name: rrr:coordinator-status
+description: Check Cloudflare coordinator readiness for RRR team mode
+argument-hint: ""
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+<objective>
+Check whether the current repo has the coordinator contract and local deployment prerequisites needed for Cloudflare Sandbox-based integration review.
+</objective>
+
+<process>
+
+1. Run:
+
+   ```bash
+   node ~/.claude/rrr/scripts/rrr-team-mode.js coordinator-status
+   ```
+
+   Development source repo fallback:
+
+   ```bash
+   node scripts/rrr-team-mode.js coordinator-status
+   ```
+
+2. Write `.planning/coordinator/STATUS.md`.
+3. Report missing runtime manifest, missing coordinator config, missing Wrangler, and missing local secrets.
+
+</process>
+
+<constraints>
+- Do not print secret values.
+- Do not deploy or mutate Cloudflare resources from this status command.
+</constraints>

package/commands/rrr/help.md

@@ -128,7 +128,10 @@ RRR team mode keeps collaboration GitHub-native:
 
 ```
 /rrr:team-init --github-org PA-MATRIX --milestone v1.24 --runner sprites
+/rrr:runtime-init
 /rrr:assign-phases --team team-runtime --phases 92,95
+/rrr:provision-sprites
+/rrr:provision-coordinator
 /rrr:dispatch-team --team team-runtime
 /rrr:team-status
 ```
@@ -145,6 +148,8 @@ RRR team mode keeps collaboration GitHub-native:
 **Coordinator integration:**
 
 ```
+/rrr:sprite-status --live
+/rrr:coordinator-status
 /rrr:coordinate-merge
 /rrr:integration-report
 ```

package/commands/rrr/provision-coordinator.md

@@ -0,0 +1,39 @@
+---
+name: rrr:provision-coordinator
+description: Create the Cloudflare coordinator contract for RRR team mode integration review
+argument-hint: "[--provider cloudflare-sandbox] [--name <coordinator-name>]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+<objective>
+Prepare the repo's coordinator contract so a reusable Cloudflare Claude Code/Sandbox coordinator can clone, merge, test, and report without owning developer work state.
+</objective>
+
+<process>
+
+1. Read `.planning/team-mode.json` and `.planning/RUNTIME.json`.
+2. Run:
+
+   ```bash
+   node ~/.claude/rrr/scripts/rrr-team-mode.js provision-coordinator {{RRR_ARGS}}
+   ```
+
+   Development source repo fallback:
+
+   ```bash
+   node scripts/rrr-team-mode.js provision-coordinator {{RRR_ARGS}}
+   ```
+
+3. Write `.planning/coordinator/COORDINATOR.json` and `.planning/coordinator/README.md`.
+4. Report required secrets, integration branch, runtime manifest, and report-first merge contract.
+
+</process>
+
+<constraints>
+- Coordinator is report-first; never auto-merge to the base branch.
+- Developer work remains in team Sprites and team branches.
+- Do not store secrets in planning files.
+</constraints>

package/commands/rrr/provision-sprites.md

@@ -0,0 +1,41 @@
+---
+name: rrr:provision-sprites
+description: Generate or apply Sprite provisioning for assigned RRR team workstreams
+argument-hint: "[--team <team>|--teams a,b] [--apply]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+  - AskUserQuestion
+---
+
+<objective>
+Prepare one persistent Sprite per assigned team/workstream using reusable org-level tooling plus the repo's `.planning/RUNTIME.json`.
+</objective>
+
+<process>
+
+1. Read `.planning/team-mode.json` and `.planning/RUNTIME.json`.
+2. Generate `.planning/sprites/PROVISIONING.md` and `.planning/sprites/PROVISIONING.json`.
+3. If `--apply` is present, create/update the Sprites and run bootstrap commands:
+
+   ```bash
+   node ~/.claude/rrr/scripts/rrr-team-mode.js provision-sprites {{RRR_ARGS}}
+   ```
+
+   Development source repo fallback:
+
+   ```bash
+   node scripts/rrr-team-mode.js provision-sprites {{RRR_ARGS}}
+   ```
+
+4. Report each team Sprite, branch, setup status, and checkpoint status.
+
+</process>
+
+<constraints>
+- One Sprite per team/workstream.
+- Do not share a single Sprite across teams for implementation work.
+- Do not auto-run assigned phases; provisioning stops at clean-ready setup.
+- Do not push branches or create PRs without explicit coordinator approval.
+</constraints>

package/commands/rrr/runtime-init.md

@@ -0,0 +1,39 @@
+---
+name: rrr:runtime-init
+description: Create a repo-specific runtime manifest for team mode setup, checks, and UAT
+argument-hint: "[--force] [--package-manager npm|pnpm|yarn|bun] [--setup a,b] [--checks a,b]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+<objective>
+Create `.planning/RUNTIME.json`, the repo-specific bootstrap contract used by reusable Sprites and Cloudflare coordinator sandboxes.
+</objective>
+
+<process>
+
+1. Read `.planning/STATE.md` and inspect package manager files.
+2. Infer setup/check commands from lockfiles and `package.json` scripts.
+3. Run:
+
+   ```bash
+   node ~/.claude/rrr/scripts/rrr-team-mode.js runtime-init {{RRR_ARGS}}
+   ```
+
+   Development source repo fallback:
+
+   ```bash
+   node scripts/rrr-team-mode.js runtime-init {{RRR_ARGS}}
+   ```
+
+4. Report the manifest path, setup commands, checks, and browser UAT mode.
+
+</process>
+
+<constraints>
+- Do not hardcode repository names.
+- Do not put secrets in `.planning/RUNTIME.json`.
+- Keep the manifest small and reviewable.
+</constraints>

package/commands/rrr/sprite-status.md

@@ -0,0 +1,38 @@
+---
+name: rrr:sprite-status
+description: Check planned or live Sprite readiness for RRR team mode workstreams
+argument-hint: "[--live] [--team <team>|--teams a,b]"
+allowed-tools:
+  - Read
+  - Write
+  - Bash
+---
+
+<objective>
+Verify that assigned team Sprites exist and, with `--live`, that each Sprite has the expected repo checkout and branch.
+</objective>
+
+<process>
+
+1. Read `.planning/team-mode.json`.
+2. Run:
+
+   ```bash
+   node ~/.claude/rrr/scripts/rrr-team-mode.js sprite-status {{RRR_ARGS}}
+   ```
+
+   Development source repo fallback:
+
+   ```bash
+   node scripts/rrr-team-mode.js sprite-status {{RRR_ARGS}}
+   ```
+
+3. Write `.planning/sprites/STATUS.md`.
+4. Report missing Sprites, wrong branches, missing Claude Code, missing GSD Browser, or missing repo checkout.
+
+</process>
+
+<constraints>
+- `--live` can wake Sprites and run remote commands.
+- Do not destroy or restore Sprites from this command.
+</constraints>

package/docs/team-mode-github-sprites.md

@@ -60,13 +60,19 @@ RRR owns planning, execution guidance, verification artifacts, and coordinator r
    $rrr-team-init --github-org PA-MATRIX --milestone v1.24 --runner sprites --teams team-platform,team-runtime,team-ux
    ```
 
-3. Create or review the roadmap:
+3. Create the repo runtime manifest:
+
+   ```bash
+   $rrr-runtime-init
+   ```
+
+4. Create or review the roadmap:
 
    ```bash
    $rrr-create-roadmap
    ```
 
-4. Assign phases:
+5. Assign phases:
 
    ```bash
    $rrr-assign-phases --team team-platform --phases 91,94
@@ -74,7 +80,14 @@ RRR owns planning, execution guidance, verification artifacts, and coordinator r
    $rrr-assign-phases --team team-ux --phases 93
    ```
 
-5. Dispatch teams:
+6. Prepare reusable runtime endpoints:
+
+   ```bash
+   $rrr-provision-sprites
+   $rrr-provision-coordinator
+   ```
+
+7. Dispatch teams:
 
    ```bash
    $rrr-dispatch-team --team team-platform
@@ -82,13 +95,15 @@ RRR owns planning, execution guidance, verification artifacts, and coordinator r
    $rrr-dispatch-team --team team-ux
    ```
 
-6. Monitor:
+8. Monitor:
 
    ```bash
    $rrr-team-status
+   $rrr-sprite-status --live
+   $rrr-coordinator-status
    ```
 
-7. Coordinate integration:
+9. Coordinate integration:
 
    ```bash
    $rrr-coordinate-merge
@@ -136,6 +151,8 @@ Use a base Sprite image/template with:
 - GSD Browser
 - Browser/system dependencies required by the repo
 
+The base Sprite should be reusable across repos. Repo-specific setup belongs in `.planning/RUNTIME.json`, created by `$rrr-runtime-init`.
+
 Recommended lifecycle:
 
 1. Create one Sprite per team/workstream.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "projecta-rrr",
-  "version": "1.24.0",
+  "version": "1.24.2",
   "description": "A meta-prompting, context engineering and spec-driven development system for Claude Code by Projecta.ai",
   "bin": {
     "projecta-rrr": "bin/install.js",

package/rrr/lib/team-mode/manager.js

@@ -73,10 +73,477 @@ function spriteFor(repoName, milestone, team) {
   return `rrr-${base}`;
 }
 
+function normalizeList(value) {
+  if (!value) return [];
+  if (Array.isArray(value)) return value.map(String).map(s => s.trim()).filter(Boolean);
+  return String(value).split(',').map(s => s.trim()).filter(Boolean);
+}
+
 function teamSlug(raw) {
   return requireTeamName(raw.replace(/^@?[^/]+\//, ''));
 }
 
+function runtimeManifestPath(projectRoot) {
+  return path.join(projectRoot, '.planning', 'RUNTIME.json');
+}
+
+function readPackageJson(projectRoot) {
+  const packagePath = path.join(projectRoot, 'package.json');
+  if (!fs.existsSync(packagePath)) return null;
+  return readJson(packagePath, null);
+}
+
+function detectPackageManager(projectRoot) {
+  if (fs.existsSync(path.join(projectRoot, 'pnpm-lock.yaml'))) return 'pnpm';
+  if (fs.existsSync(path.join(projectRoot, 'yarn.lock'))) return 'yarn';
+  if (fs.existsSync(path.join(projectRoot, 'bun.lockb')) || fs.existsSync(path.join(projectRoot, 'bun.lock'))) return 'bun';
+  if (fs.existsSync(path.join(projectRoot, 'package-lock.json')) || fs.existsSync(path.join(projectRoot, 'npm-shrinkwrap.json'))) return 'npm';
+  if (fs.existsSync(path.join(projectRoot, 'package.json'))) return 'npm';
+  return null;
+}
+
+function packageCommand(packageManager, script) {
+  if (packageManager === 'pnpm') return `pnpm ${script}`;
+  if (packageManager === 'yarn') return `yarn ${script}`;
+  if (packageManager === 'bun') return `bun ${script}`;
+  return `npm ${script}`;
+}
+
+function installCommand(projectRoot, packageManager) {
+  if (!packageManager) return null;
+  if (packageManager === 'pnpm') return 'pnpm install --frozen-lockfile';
+  if (packageManager === 'yarn') return 'yarn install --frozen-lockfile';
+  if (packageManager === 'bun') return 'bun install --frozen-lockfile';
+  if (fs.existsSync(path.join(projectRoot, 'package-lock.json')) || fs.existsSync(path.join(projectRoot, 'npm-shrinkwrap.json'))) {
+    return 'npm ci';
+  }
+  return 'npm install';
+}
+
+function inferRuntimeManifest(projectRoot, options) {
+  const opts = options || {};
+  const packageJson = readPackageJson(projectRoot);
+  const scripts = packageJson && packageJson.scripts ? packageJson.scripts : {};
+  const packageManager = opts.packageManager || detectPackageManager(projectRoot);
+  const setup = normalizeList(opts.setup);
+  const checks = normalizeList(opts.checks);
+  const install = installCommand(projectRoot, packageManager);
+
+  if (setup.length === 0 && install) setup.push(install);
+  if (checks.length === 0) {
+    for (const scriptName of ['lint', 'test', 'build']) {
+      if (scripts[scriptName]) checks.push(packageCommand(packageManager, `run ${scriptName}`));
+    }
+  }
+
+  const browserUatScript = scripts['browser:uat'] ? packageCommand(packageManager, 'run browser:uat') : null;
+
+  return {
+    schema_version: 1,
+    generated_at: new Date().toISOString(),
+    package_manager: packageManager,
+    workdir: opts.workdir || null,
+    setup,
+    checks,
+    uat: {
+      browser: opts.browser || 'gsd',
+      command: opts.uatCommand || browserUatScript
+    },
+    tools: {
+      developer_sprite: ['git', 'gh', 'node', 'npm', 'claude', 'projecta-rrr', 'gsd-browser'],
+      coordinator: ['git', 'gh', 'node', 'npm', 'claude', 'projecta-rrr']
+    },
+    notes: [
+      'This manifest is repo-specific. Keep Sprite and Cloudflare coordinator images reusable.',
+      'Team/developer commands must pass --team <team> in team mode.'
+    ]
+  };
+}
+
+function writeRuntimeManifest(options) {
+  const opts = options || {};
+  const projectRoot = opts.projectRoot || process.cwd();
+  const filePath = runtimeManifestPath(projectRoot);
+  if (fs.existsSync(filePath) && !opts.force) {
+    return { filePath, manifest: readJson(filePath, null), created: false };
+  }
+  const manifest = inferRuntimeManifest(projectRoot, opts);
+  writeJson(filePath, manifest);
+  return { filePath, manifest, created: true };
+}
+
+function readRuntimeManifest(projectRoot) {
+  const filePath = runtimeManifestPath(projectRoot || process.cwd());
+  const manifest = readJson(filePath, null);
+  return manifest || inferRuntimeManifest(projectRoot || process.cwd(), {});
+}
+
+function repoNameFor(config) {
+  if (config.github && config.github.repo) return config.github.repo.split('/').pop();
+  return path.basename(config.project_root);
+}
+
+function repoCloneFor(config) {
+  if (config.github && config.github.repo) return config.github.repo;
+  return detectRepo(config.project_root);
+}
+
+function spriteWorkdir(config, runtime) {
+  return runtime.workdir || `/home/sprite/work/${repoNameFor(config)}`;
+}
+
+function buildSpriteProvisionPlan(projectRoot, options) {
+  const opts = options || {};
+  const config = loadConfig(projectRoot);
+  const runtime = readRuntimeManifest(config.project_root);
+  const repo = repoCloneFor(config);
+  const workdir = spriteWorkdir(config, runtime);
+  const selectedTeams = normalizeList(opts.teams || opts.team);
+  const teams = selectedTeams.length > 0 ? selectedTeams : Object.keys(config.teams || {});
+  const rows = [];
+
+  for (const rawTeam of teams) {
+    const team = requireTeamName(rawTeam);
+    const teamConfig = config.teams[team];
+    if (!teamConfig) throw new Error(`unknown team: ${team}`);
+    if (!teamConfig.sprite) throw new Error(`team ${team} does not have a Sprite name`);
+
+    const setup = runtime.setup || [];
+    const checks = runtime.checks || [];
+    const cloneCommand = repo
+      ? `gh repo clone ${repo} ${workdir}`
+      : `git clone <repo-url> ${workdir}`;
+    const checkoutCommand = `git fetch origin && git checkout -B ${teamConfig.branch} origin/${config.github.base_branch}`;
+
+    rows.push({
+      team,
+      github_team: teamConfig.github_team,
+      phases: teamConfig.phases || [],
+      sprite: teamConfig.sprite,
+      branch: teamConfig.branch,
+      workdir,
+      repo,
+      setup,
+      checks,
+      commands: [
+        `sprite create ${teamConfig.sprite} --skip-console`,
+        `sprite exec -s ${teamConfig.sprite} -- mkdir -p /home/sprite/work`,
+        `sprite exec -s ${teamConfig.sprite} -- bash -lc 'test -d ${workdir}/.git || ${cloneCommand}'`,
+        `sprite exec -s ${teamConfig.sprite} --dir ${workdir} -- bash -lc '${checkoutCommand}'`,
+        `sprite exec -s ${teamConfig.sprite} --dir ${workdir} -- npx projecta-rrr@latest --global --yes`,
+        ...setup.map(cmd => `sprite exec -s ${teamConfig.sprite} --dir ${workdir} -- bash -lc '${cmd}'`),
+        `sprite checkpoint create -s ${teamConfig.sprite} --comment "rrr clean-ready ${config.milestone} ${team}"`
+      ]
+    });
+  }
+
+  return { config, runtime, workdir, rows };
+}
+
+function renderSpriteProvisionPlan(plan) {
+  const lines = [
+    `# ${plan.config.milestone} Sprite Provisioning`,
+    '',
+    `Generated: ${new Date().toISOString()}`,
+    `Repo: ${plan.config.github.repo || '(unset)'}`,
+    `Base branch: ${plan.config.github.base_branch}`,
+    '',
+    '## Runtime',
+    '',
+    `Package manager: ${plan.runtime.package_manager || '(none detected)'}`,
+    `Workdir: ${plan.workdir}`,
+    `Browser UAT: ${plan.runtime.uat && plan.runtime.uat.browser ? plan.runtime.uat.browser : 'gsd'}`,
+    '',
+    '## Workstreams',
+    '',
+    '| Team | Phases | Sprite | Branch |',
+    '| ---- | ------ | ------ | ------ |'
+  ];
+
+  for (const row of plan.rows) {
+    lines.push(`| ${row.team} | ${row.phases.join(', ') || '-'} | ${row.sprite} | ${row.branch} |`);
+  }
+
+  lines.push('', '## Commands', '');
+  for (const row of plan.rows) {
+    lines.push(`### ${row.team}`, '');
+    lines.push('```bash');
+    for (const command of row.commands) lines.push(command);
+    lines.push('```', '');
+  }
+
+  lines.push(
+    '## Notes',
+    '',
+    '- One Sprite per team/workstream.',
+    '- The base Sprite tooling is repo-agnostic; this repo supplies setup/check commands through `.planning/RUNTIME.json`.',
+    '- Developers should run RRR with `--team <team>` inside the Sprite.'
+  );
+  return `${lines.join('\n')}\n`;
+}
+
+function writeSpriteProvisionPlan(projectRoot, options) {
+  const plan = buildSpriteProvisionPlan(projectRoot, options);
+  const dir = path.join(plan.config.project_root, '.planning', 'sprites');
+  ensureDir(dir);
+  const mdPath = path.join(dir, 'PROVISIONING.md');
+  const jsonPath = path.join(dir, 'PROVISIONING.json');
+  atomicWrite(mdPath, renderSpriteProvisionPlan(plan));
+  writeJson(jsonPath, {
+    schema_version: 1,
+    generated_at: new Date().toISOString(),
+    milestone: plan.config.milestone,
+    repo: plan.config.github.repo,
+    workdir: plan.workdir,
+    runtime: plan.runtime,
+    rows: plan.rows
+  });
+  return { plan, mdPath, jsonPath };
+}
+
+function execCapture(command, args, options) {
+  try {
+    const output = execFileSync(command, args, {
+      cwd: options && options.cwd ? options.cwd : process.cwd(),
+      encoding: 'utf8',
+      stdio: ['ignore', 'pipe', 'pipe']
+    });
+    return { ok: true, output: output.trim() };
+  } catch (err) {
+    const stdout = err.stdout ? String(err.stdout) : '';
+    const stderr = err.stderr ? String(err.stderr) : '';
+    return { ok: false, output: `${stdout}${stderr}`.trim(), code: err.status || 1 };
+  }
+}
+
+function applySpriteProvisionPlan(projectRoot, options) {
+  const plan = buildSpriteProvisionPlan(projectRoot, options);
+  const results = [];
+  for (const row of plan.rows) {
+    const teamResults = [];
+    const create = execCapture('sprite', ['create', row.sprite, '--skip-console']);
+    teamResults.push({ step: 'create', ...create });
+    execCapture('sprite', ['exec', '-s', row.sprite, '--', 'mkdir', '-p', '/home/sprite/work']);
+    const clone = execCapture('sprite', [
+      'exec',
+      '-s',
+      row.sprite,
+      '--',
+      'bash',
+      '-lc',
+      `test -d ${row.workdir}/.git || gh repo clone ${row.repo} ${row.workdir}`
+    ]);
+    teamResults.push({ step: 'clone', ...clone });
+    const checkout = execCapture('sprite', [
+      'exec',
+      '-s',
+      row.sprite,
+      '--dir',
+      row.workdir,
+      '--',
+      'bash',
+      '-lc',
+      `git fetch origin && git checkout -B ${row.branch} origin/${plan.config.github.base_branch}`
+    ]);
+    teamResults.push({ step: 'checkout', ...checkout });
+    const rrr = execCapture('sprite', [
+      'exec',
+      '-s',
+      row.sprite,
+      '--dir',
+      row.workdir,
+      '--',
+      'npx',
+      'projecta-rrr@latest',
+      '--global',
+      '--yes'
+    ]);
+    teamResults.push({ step: 'rrr-install', ...rrr });
+    for (const command of row.setup || []) {
+      const setup = execCapture('sprite', ['exec', '-s', row.sprite, '--dir', row.workdir, '--', 'bash', '-lc', command]);
+      teamResults.push({ step: `setup: ${command}`, ...setup });
+    }
+    const checkpoint = execCapture('sprite', [
+      'checkpoint',
+      'create',
+      '-s',
+      row.sprite,
+      '--comment',
+      `rrr clean-ready ${plan.config.milestone} ${row.team}`
+    ]);
+    teamResults.push({ step: 'checkpoint', ...checkpoint });
+    results.push({ team: row.team, sprite: row.sprite, results: teamResults });
+  }
+  return { plan, results };
+}
+
+function readSpriteStatus(projectRoot, options) {
+  const opts = options || {};
+  const plan = buildSpriteProvisionPlan(projectRoot, opts);
+  const rows = [];
+  const cli = execCapture('sprite', ['--help']);
+  for (const row of plan.rows) {
+    const status = {
+      team: row.team,
+      sprite: row.sprite,
+      branch: row.branch,
+      workdir: row.workdir,
+      planned: true,
+      live_checked: !!opts.live,
+      ok: false,
+      details: []
+    };
+    if (!cli.ok) {
+      status.details.push('sprite CLI not available or not authenticated');
+      rows.push(status);
+      continue;
+    }
+    if (opts.live) {
+      const probe = execCapture('sprite', [
+        'exec',
+        '-s',
+        row.sprite,
+        '--dir',
+        row.workdir,
+        '--',
+        'bash',
+        '-lc',
+        'printf "branch="; git branch --show-current; printf "\\nhead="; git rev-parse --short HEAD; printf "\\nclaude="; claude --version 2>/dev/null || true; printf "\\ngsd="; gsd-browser --version 2>/dev/null || true'
+      ]);
+      status.ok = probe.ok;
+      status.details.push(probe.output || (probe.ok ? 'ok' : 'probe failed'));
+    } else {
+      const list = execCapture('sprite', ['list', '--prefix', row.sprite]);
+      status.ok = list.ok && list.output.includes(row.sprite);
+      status.details.push(status.ok ? 'sprite listed' : 'sprite not listed');
+    }
+    rows.push(status);
+  }
+  return { plan, rows };
+}
+
+function writeSpriteStatusReport(projectRoot, options) {
+  const status = readSpriteStatus(projectRoot, options);
+  const dir = path.join(status.plan.config.project_root, '.planning', 'sprites');
+  ensureDir(dir);
+  const lines = [
+    `# ${status.plan.config.milestone} Sprite Status`,
+    '',
+    `Generated: ${new Date().toISOString()}`,
+    '',
+    '| Team | Sprite | Branch | Live Checked | OK |',
+    '| ---- | ------ | ------ | ------------ | -- |'
+  ];
+  for (const row of status.rows) {
+    lines.push(`| ${row.team} | ${row.sprite} | ${row.branch} | ${row.live_checked ? 'yes' : 'no'} | ${row.ok ? 'yes' : 'no'} |`);
+  }
+  lines.push('', '## Details', '');
+  for (const row of status.rows) {
+    lines.push(`### ${row.team}`, '');
+    lines.push('```text');
+    lines.push(...row.details);
+    lines.push('```', '');
+  }
+  const reportPath = path.join(dir, 'STATUS.md');
+  atomicWrite(reportPath, `${lines.join('\n')}\n`);
+  return { status, reportPath };
+}
+
+function coordinatorConfigPath(projectRoot) {
+  return path.join(projectRoot, '.planning', 'coordinator', 'COORDINATOR.json');
+}
+
+function writeCoordinatorProvision(options) {
+  const opts = options || {};
+  const projectRoot = opts.projectRoot || process.cwd();
+  const teamConfig = loadConfig(projectRoot);
+  const runtime = readRuntimeManifest(projectRoot);
+  const dir = path.join(projectRoot, '.planning', 'coordinator');
+  ensureDir(dir);
+  const config = {
+    schema_version: 1,
+    provider: opts.provider || 'cloudflare-sandbox',
+    name: opts.name || `rrr-coordinator-${repoNameFor(teamConfig).toLowerCase()}`,
+    generated_at: new Date().toISOString(),
+    repo: teamConfig.github.repo,
+    milestone: teamConfig.milestone,
+    base_branch: teamConfig.github.base_branch,
+    integration_branch: teamConfig.github.integration_branch,
+    runtime_manifest: path.relative(projectRoot, runtimeManifestPath(projectRoot)),
+    report_first: true,
+    required_secrets: ['ANTHROPIC_API_KEY', 'GITHUB_TOKEN'],
+    responsibilities: [
+      'clone repository into ephemeral sandbox',
+      'merge team branches into integration branch',
+      'run runtime checks from .planning/RUNTIME.json',
+      'run RRR integration report',
+      'return report; never auto-merge to base branch'
+    ]
+  };
+  writeJson(coordinatorConfigPath(projectRoot), config);
+  const readme = [
+    `# ${config.name}`,
+    '',
+    'This is the RRR coordinator contract for Cloudflare Sandbox execution.',
+    '',
+    '## Runtime',
+    '',
+    `Repo: ${config.repo || '(unset)'}`,
+    `Milestone: ${config.milestone}`,
+    `Base branch: ${config.base_branch}`,
+    `Integration branch: ${config.integration_branch}`,
+    `Runtime manifest: ${config.runtime_manifest}`,
+    '',
+    '## Required Secrets',
+    '',
+    '- `ANTHROPIC_API_KEY` for Claude Code.',
+    '- `GITHUB_TOKEN` or GitHub App installation token for read/write repo access.',
+    '',
+    '## Execution Contract',
+    '',
+    '- Coordinator uses a fresh Cloudflare sandbox per integration run unless explicitly kept alive.',
+    '- GitHub remains the source of truth for branches, PRs, reviews, and checks.',
+    '- Coordinator is report-first: it writes reports and recommendations only; humans approve final merges.',
+    '- Developer work stays in Sprites/team branches.'
+  ].join('\n');
+  atomicWrite(path.join(dir, 'README.md'), `${readme}\n`);
+  return { config, runtime, dir };
+}
+
+function readCoordinatorStatus(projectRoot) {
+  const root = projectRoot || process.cwd();
+  const config = readJson(coordinatorConfigPath(root), null);
+  const checks = [];
+  checks.push({ name: 'coordinator config', ok: !!config, detail: config ? path.relative(root, coordinatorConfigPath(root)) : 'missing' });
+  checks.push({ name: 'runtime manifest', ok: fs.existsSync(runtimeManifestPath(root)), detail: path.relative(root, runtimeManifestPath(root)) });
+  const wrangler = execCapture('npx', ['wrangler', '--version'], { cwd: root });
+  checks.push({ name: 'wrangler available', ok: wrangler.ok, detail: wrangler.output || 'not available' });
+  checks.push({ name: 'ANTHROPIC_API_KEY present', ok: !!process.env.ANTHROPIC_API_KEY, detail: process.env.ANTHROPIC_API_KEY ? 'present' : 'missing locally' });
+  checks.push({ name: 'GITHUB_TOKEN present', ok: !!process.env.GITHUB_TOKEN, detail: process.env.GITHUB_TOKEN ? 'present' : 'missing locally' });
+  return { config, checks };
+}
+
+function writeCoordinatorStatusReport(projectRoot) {
+  const root = projectRoot || process.cwd();
+  const status = readCoordinatorStatus(root);
+  const dir = path.join(root, '.planning', 'coordinator');
+  ensureDir(dir);
+  const lines = [
+    '# Coordinator Status',
+    '',
+    `Generated: ${new Date().toISOString()}`,
+    '',
+    '| Check | OK | Detail |',
+    '| ----- | -- | ------ |'
+  ];
+  for (const check of status.checks) {
+    lines.push(`| ${check.name} | ${check.ok ? 'yes' : 'no'} | ${String(check.detail || '').replace(/\|/g, '\\|')} |`);
+  }
+  const reportPath = path.join(dir, 'STATUS.md');
+  atomicWrite(reportPath, `${lines.join('\n')}\n`);
+  return { status, reportPath };
+}
+
 function createTeamState(team, config) {
   const ctx = resolvePlanningContext({ projectRoot: config.project_root, team });
   ensureDir(ctx.workstreamDir);
@@ -415,6 +882,17 @@ module.exports = {
   submitPhase,
   readStatus,
   writeIntegrationReport,
+  writeRuntimeManifest,
+  readRuntimeManifest,
+  inferRuntimeManifest,
+  buildSpriteProvisionPlan,
+  writeSpriteProvisionPlan,
+  applySpriteProvisionPlan,
+  readSpriteStatus,
+  writeSpriteStatusReport,
+  writeCoordinatorProvision,
+  readCoordinatorStatus,
+  writeCoordinatorStatusReport,
   detectRepo,
   branchFor,
   spriteFor

package/scripts/rrr-team-mode.js

@@ -17,6 +17,12 @@ const {
   submitPhase,
   readStatus,
   writeIntegrationReport,
+  writeRuntimeManifest,
+  writeSpriteProvisionPlan,
+  applySpriteProvisionPlan,
+  writeSpriteStatusReport,
+  writeCoordinatorProvision,
+  writeCoordinatorStatusReport,
   loadConfig
 } = loadManager();
 
@@ -64,10 +70,15 @@ Usage:
   node scripts/rrr-team-mode.js status
   node scripts/rrr-team-mode.js submit --team team-runtime --phase 92 --ready
   node scripts/rrr-team-mode.js report
+  node scripts/rrr-team-mode.js runtime-init
+  node scripts/rrr-team-mode.js provision-sprites [--apply] [--teams team-runtime]
+  node scripts/rrr-team-mode.js sprite-status [--live]
+  node scripts/rrr-team-mode.js provision-coordinator
+  node scripts/rrr-team-mode.js coordinator-status
 
 Notes:
   - This helper writes RRR planning artifacts only.
-  - GitHub PR/Sprites dispatch is intentionally report-first in the pilot.
+  - GitHub PR dispatch is intentionally report-first in the pilot.
   - Developer execution commands must use --team so root STATE.md stays coordinator-owned.
 `);
 }
@@ -157,6 +168,78 @@ function main() {
       return;
     }
 
+    if (command === 'runtime-init') {
+      const result = writeRuntimeManifest({
+        projectRoot,
+        force: args.force === true || args.force === 'true',
+        packageManager: args['package-manager'],
+        setup: args.setup,
+        checks: args.checks,
+        browser: args.browser,
+        uatCommand: args['uat-command'],
+        workdir: args.workdir
+      });
+      console.log(`${result.created ? 'Wrote' : 'Already exists'} ${path.relative(projectRoot, result.filePath)}`);
+      console.log(`Package manager: ${result.manifest.package_manager || '(none detected)'}`);
+      console.log(`Setup: ${(result.manifest.setup || []).join(', ') || '-'}`);
+      console.log(`Checks: ${(result.manifest.checks || []).join(', ') || '-'}`);
+      return;
+    }
+
+    if (command === 'provision-sprites') {
+      const options = {
+        teams: args.teams,
+        team: args.team
+      };
+      if (args.apply === true || args.apply === 'true') {
+        const result = applySpriteProvisionPlan(projectRoot, options);
+        for (const teamResult of result.results) {
+          console.log(`${teamResult.team}: ${teamResult.sprite}`);
+          for (const step of teamResult.results) {
+            console.log(`  ${step.ok ? 'ok' : 'failed'} ${step.step}`);
+            if (!step.ok && step.output) console.log(`    ${step.output.split('\n')[0]}`);
+          }
+        }
+      }
+      const written = writeSpriteProvisionPlan(projectRoot, options);
+      console.log(`Wrote ${path.relative(projectRoot, written.mdPath)}`);
+      console.log(`Wrote ${path.relative(projectRoot, written.jsonPath)}`);
+      return;
+    }
+
+    if (command === 'sprite-status') {
+      const result = writeSpriteStatusReport(projectRoot, {
+        live: args.live === true || args.live === 'true',
+        teams: args.teams,
+        team: args.team
+      });
+      console.log(`Wrote ${path.relative(projectRoot, result.reportPath)}`);
+      for (const row of result.status.rows) {
+        console.log(`${row.team}: ${row.ok ? 'ok' : 'not-ready'} ${row.sprite}`);
+      }
+      return;
+    }
+
+    if (command === 'provision-coordinator') {
+      const result = writeCoordinatorProvision({
+        projectRoot,
+        provider: args.provider,
+        name: args.name
+      });
+      console.log(`Wrote ${path.relative(projectRoot, path.join(result.dir, 'COORDINATOR.json'))}`);
+      console.log(`Wrote ${path.relative(projectRoot, path.join(result.dir, 'README.md'))}`);
+      return;
+    }
+
+    if (command === 'coordinator-status') {
+      const result = writeCoordinatorStatusReport(projectRoot);
+      console.log(`Wrote ${path.relative(projectRoot, result.reportPath)}`);
+      for (const check of result.status.checks) {
+        console.log(`${check.ok ? 'ok' : 'missing'} ${check.name}: ${check.detail}`);
+      }
+      return;
+    }
+
     if (command === 'show-config') {
       console.log(JSON.stringify(loadConfig(projectRoot), null, 2));
       return;