projecta-rrr 1.23.4 → 1.24.0

package/AGENTS.md

@@ -31,6 +31,7 @@ The RRR loop follows five steps:
 | ------- | ----------- |
 | `$rrr-add-phase` | Add phase to end of current milestone in roadmap |
 | `$rrr-add-todo` | Capture idea or task as todo from current conversation context |
+| `$rrr-assign-phases` | Assign roadmap phases to GitHub teams for RRR team mode |
 | `$rrr-audit-milestone` | Audit milestone completion against original intent before archiving |
 | `$rrr-bootstrap-nextjs` | Scaffold a Next.js App Router MVP with TypeScript, Tailwind, shadcn/ui, Vitest, and Playwright |
 | `$rrr-brownfield-audit` | Audit brownfield repos for scattered planning docs before RRR initialization |
@@ -39,11 +40,13 @@ The RRR loop follows five steps:
 | `$rrr-check-upstream` | Run check-upstream workflow |
 | `$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-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 |
 | `$rrr-discuss-milestone` | Gather context for next milestone through adaptive questioning |
 | `$rrr-discuss-phase` | Gather phase context through adaptive questioning before planning |
+| `$rrr-dispatch-team` | Prepare a GitHub team workstream for execution on a branch and Sprite |
 | `$rrr-doctor` | Diagnose and fix duplicate RRR installs - non-destructive with rollback |
 | `$rrr-execute-phase` | Execute all plans in a phase with wave-based parallelization |
 | `$rrr-execute-plan` | Execute a PLAN.md file |
@@ -51,6 +54,7 @@ The RRR loop follows five steps:
 | `$rrr-help` | Show available RRR commands and usage guide |
 | `$rrr-insert-phase` | Insert urgent work as decimal phase (e.g., 72.1) between existing phases |
 | `$rrr-install-skill` | Install a skill from GitHub or marketplace |
+| `$rrr-integration-report` | Read the current RRR team-mode integration report |
 | `$rrr-list-phase-assumptions` | Surface Claude's assumptions about a phase approach before planning |
 | `$rrr-list-skills` | List all available skills (vendored and community) |
 | `$rrr-map-codebase` | Analyze codebase with parallel mapper agents to produce .planning/codebase/ documents |
@@ -72,6 +76,9 @@ The RRR loop follows five steps:
 | `$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-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 |
 | `$rrr-think` | Apply structured thinking models for architecture decisions, risk assessment, scope cuts, and root cause analysis |
 | `$rrr-update` | Update RRR to latest version with idempotent install + duplicate prevention |
 | `$rrr-verify-work` | Validate built features through audit (default) or interactive UAT |
@@ -84,4 +91,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-04-20T21:10:01.139Z | source: commands/rrr/*.md | count: 47 skills -->
+<!-- generated: 2026-05-12T18:36:28.466Z | source: commands/rrr/*.md | count: 54 skills -->

package/CHANGELOG.md

@@ -4,6 +4,31 @@ 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.0] - 2026-05-12
+
+### Added
+- **Team Mode Pilot** — added `$rrr-team-init`, `$rrr-assign-phases`, `$rrr-dispatch-team`, `$rrr-team-status`, `$rrr-submit-phase`, `$rrr-coordinate-merge`, and `$rrr-integration-report` for GitHub-native team workstreams.
+- **Workstream state isolation** — teams now write to `.planning/workstreams/<team>/STATE.md`, `ASSIGNMENT.md`, and `SUBMISSION.json` so multiple developers can work on the same milestone without fighting over root `.planning/STATE.md`.
+- **GitHub + Sprites SOP** — added `docs/team-mode-github-sprites.md` and `rrr/references/team-mode.md` covering phase assignment, branch naming, Sprite sandbox names, CODEOWNERS handoff, and coordinator merge review.
+
+### Changed
+- **Browser UAT default** — RRR now prefers GSD Browser for interactive browser UAT before falling back to Agent Browser, Claude Chrome, or Playwright.
+- **Upstream monitoring** — watcher coverage now includes `gsd-build/get-shit-done`, `gsd-build/gsd-browser`, `obra/superpowers`, and `vercel-labs/agent-browser`.
+
+### Fixed
+- **Package hygiene** — generated `.rrr` semantic-search state under `rrr/lib` is excluded from npm packages.
+
+## [1.23.5] - 2026-04-30
+
+### Fixed
+- **Codex command discovery** — RRR now installs Codex skills in the discoverable `~/.codex/skills/rrr-*/SKILL.md` layout, removes legacy flat skill files, and quotes generated YAML metadata so every `$rrr-*` command loads cleanly.
+- **Codex runtime provisioning** — installer now refreshes `~/.codex/rrr` with the support scripts used by RRR commands and skips copied `node_modules` directories so updates do not break on symlinked dependencies.
+- **Codex agent registration** — RRR agent TOML files are registered in `~/.codex/config.toml` under managed `[agents.rrr-*]` blocks while preserving user-managed config.
+
+### Changed
+- **Seamless repo updates for Codex developers** — running `$rrr-update` or `npx projecta-rrr@latest --global` from an RRR repo now refreshes repo-local `AGENTS.md` automatically when Codex is installed.
+- **Codex command adapter** — transformed skills now document `$rrr-*` invocation, `{{RRR_ARGS}}` handling, default-mode question fallback, slash-command conversion, and RRR subagent mapping for Codex.
+
 ## [1.23.4] - 2026-04-20
 
 ### Fixed

package/README.md

@@ -107,6 +107,27 @@ That's it. Verify with `/rrr:help` inside your Claude Code interface.
 
 **MVP Definition of Done at Projecta:** local demo runs + tests pass.
 
+### Team Mode Pilot
+
+RRR can pilot GitHub-native team execution where the coordinator assigns phases to GitHub teams and each team executes in an isolated branch/Sprite.
+
+```bash
+/rrr:team-init --github-org PA-MATRIX --milestone v1.24 --runner sprites
+/rrr:assign-phases --team team-runtime --phases 92,95
+/rrr:dispatch-team --team team-runtime
+/rrr:team-status
+```
+
+Developers run existing execution commands with `--team <team>` so root `.planning/STATE.md` stays coordinator-owned:
+
+```bash
+/rrr:execute-phase 92 --team team-runtime
+/rrr:verify-work 92 --team team-runtime
+/rrr:submit-phase 92 --team team-runtime --ready
+```
+
+See `docs/team-mode-github-sprites.md` for the full pilot SOP.
+
 ### Pushpa Mode (Overnight Autopilot)
 
 Run phases unattended while you sleep. **Best run in a normal terminal** (outside Claude Code):
@@ -395,22 +416,23 @@ RRR uses a deterministic verification ladder with **mandatory two-step verificat
 
 | frontend_impact | unit_tests | playwright | browser_uat |
 |-----------------|------------|------------|-------------|
-| true | Yes | Yes | Yes (agent-browse or claude --chrome) |
+| true | Yes | Yes | Yes (gsd-browser default; fallbacks available) |
 | false | Yes | No | No |
 
 **Two-Step Visual Verification (frontend_impact: true):**
 1. **Step 1: Playwright** — Automated headless E2E tests
-2. **Step 2: Browser UAT** — Natural language browser automation via agent-browse (preferred) or `claude --chrome` (fallback)
+2. **Step 2: Browser UAT** — Browser automation via GSD Browser by default, with agent-browse or `claude --chrome` as fallbacks
 
 **Browser UAT Tool Selection:**
-- **ANTHROPIC_API_KEY set + agent-browse plugin:** Uses agent-browse (natural language browser automation via Stagehand)
-- **ANTHROPIC_API_KEY not set + interactive:** Falls back to `claude --chrome`
-- **Pushpa/CI without ANTHROPIC_API_KEY:** Skipped (no automated browser available)
+- **gsd-browser installed:** Uses GSD Browser for browser control, screenshots, snapshots, and assertions
+- **gsd-browser missing + ANTHROPIC_API_KEY set + agent-browse plugin:** Falls back to agent-browse
+- **gsd-browser missing + interactive:** Falls back to `claude --chrome`
+- **Pushpa/CI without gsd-browser or ANTHROPIC_API_KEY:** Skipped
 
-**Installing agent-browse plugin (in Claude Code):**
+**GSD Browser setup:**
 ```bash
-/plugin marketplace add browserbase/agent-browse
-/plugin install agent-browse@browserbase
+# Ensure gsd-browser is on PATH, or point RRR at the binary:
+export GSD_BROWSER_BIN="$HOME/.gsd-browser/bin/gsd-browser"
 ```
 
 Both steps run even when Playwright passes — we want visual/UI confirmation.
@@ -495,14 +517,15 @@ FRONTEND_IMPACT=true bash scripts/browser-uat.sh  # Run browser UAT step
 ```
 
 **Browser UAT Tool Selection:**
-- **agent-browse** (preferred): Requires `ANTHROPIC_API_KEY` and [browserbase/agent-browse](https://github.com/browserbase/agent-browse) plugin. Uses Stagehand for natural language browser automation.
-- **claude --chrome** (fallback): Interactive mode only. Falls back when no API key set.
-- **Skipped**: In Pushpa/CI without `ANTHROPIC_API_KEY` (no automated browser available).
+- **gsd-browser** (default): Uses local CDP browser automation with screenshots, snapshots, console logs, and assertions.
+- **agent-browse** (fallback): Requires `ANTHROPIC_API_KEY` and [browserbase/agent-browse](https://github.com/browserbase/agent-browse) plugin.
+- **claude --chrome** (interactive fallback): Used only when gsd-browser and agent-browse are unavailable.
+- **Skipped**: In Pushpa/CI without gsd-browser or `ANTHROPIC_API_KEY`.
 
-**Installing agent-browse (in Claude Code):**
+**GSD Browser setup:**
 ```bash
-/plugin marketplace add browserbase/agent-browse
-/plugin install agent-browse@browserbase
+# Ensure gsd-browser is on PATH, or point RRR at the binary:
+export GSD_BROWSER_BIN="$HOME/.gsd-browser/bin/gsd-browser"
 ```
 
 **Interactive verification (UI_AFFECTING plans only):**
@@ -515,7 +538,7 @@ FRONTEND_IMPACT=true bash scripts/browser-uat.sh  # Browser UAT check
 **Integration:**
 - **Per-plan:** Runs automatically after `/rrr:execute-plan` when `frontend_impact: true` (Playwright + Browser UAT)
 - **Per-phase:** Runs automatically after `/rrr:execute-phase` (aggregates all plans)
-- **Pushpa Mode:** Headless Playwright + agent-browse (if `ANTHROPIC_API_KEY` set); no interactive fallback
+- **Pushpa Mode:** Headless Playwright + gsd-browser; agent-browse fallback if `ANTHROPIC_API_KEY` set; no interactive fallback
 - **Backend-only plans** (`frontend_impact: false`): Unit tests only, visual steps skipped
 - Results logged to `.planning/VISUAL_PROOF.md` (append-only)
 

package/bin/install.js

@@ -900,6 +900,10 @@ function copyWithPathReplacement(srcDir, destDir, pathPrefix) {
   const entries = fs.readdirSync(srcDir, { withFileTypes: true });
 
   for (const entry of entries) {
+    if (entry.name === 'node_modules') {
+      continue;
+    }
+
     const srcPath = path.join(srcDir, entry.name);
     const destPath = path.join(destDir, entry.name);
 
@@ -916,6 +920,181 @@ function copyWithPathReplacement(srcDir, destDir, pathPrefix) {
   }
 }
 
+function getCodexHome() {
+  return expandTilde(process.env.CODEX_HOME) || path.join(os.homedir(), '.codex');
+}
+
+function getCodexPathPrefix(codexHome) {
+  const defaultCodexHome = path.join(os.homedir(), '.codex');
+  const normalizedHome = path.resolve(codexHome);
+  const normalizedDefault = path.resolve(defaultCodexHome);
+  if (normalizedHome === normalizedDefault) {
+    return '~/.codex/';
+  }
+  return `${codexHome.replace(/\\/g, '/')}/`;
+}
+
+function getCodexEnvPathPrefix(codexHome) {
+  const defaultCodexHome = path.join(os.homedir(), '.codex');
+  const normalizedHome = path.resolve(codexHome);
+  const normalizedDefault = path.resolve(defaultCodexHome);
+  if (normalizedHome === normalizedDefault) {
+    return '$HOME/.codex/';
+  }
+  return `${codexHome.replace(/\\/g, '/')}/`;
+}
+
+function copyFileIfExists(srcFile, destFile, installed) {
+  if (!fs.existsSync(srcFile)) return;
+  fs.mkdirSync(path.dirname(destFile), { recursive: true });
+  fs.copyFileSync(srcFile, destFile);
+  installed.push(destFile);
+}
+
+function copyDirIfExists(srcDir, destDir, pathPrefix, installed) {
+  if (!fs.existsSync(srcDir)) return;
+  copyWithPathReplacement(srcDir, destDir, pathPrefix);
+  installed.push(destDir);
+}
+
+function installCodexRuntimeAssets({ src, codexHome, dryRun = false }) {
+  const installed = [];
+  const skipped = [];
+  const codexPathPrefix = getCodexPathPrefix(codexHome);
+
+  if (dryRun) {
+    return { installed, skipped: ['dry-run'] };
+  }
+
+  const rrrSrc = path.join(src, 'rrr');
+  const rrrDest = path.join(codexHome, 'rrr');
+  copyDirIfExists(rrrSrc, rrrDest, codexPathPrefix, installed);
+
+  const scriptsDestDir = path.join(codexHome, 'rrr', 'scripts');
+  copyFileIfExists(
+    path.join(src, 'scripts', 'refresh-scope-cache.js'),
+    path.join(scriptsDestDir, 'refresh-scope-cache.js'),
+    installed
+  );
+  copyFileIfExists(
+    path.join(src, 'scripts', 'doctor-rrr.js'),
+    path.join(scriptsDestDir, 'doctor-rrr.js'),
+    installed
+  );
+  copyFileIfExists(
+    path.join(src, 'scripts', 'cleanup-phases.js'),
+    path.join(scriptsDestDir, 'cleanup-phases.js'),
+    installed
+  );
+  copyFileIfExists(
+    path.join(src, 'scripts', 'test-install-smoke.js'),
+    path.join(scriptsDestDir, 'test-install-smoke.js'),
+    installed
+  );
+  copyFileIfExists(
+    path.join(src, 'scripts', 'handoff-preflight.js'),
+    path.join(scriptsDestDir, 'handoff-preflight.js'),
+    installed
+  );
+  copyDirIfExists(
+    path.join(src, 'scripts', 'rrr-memory'),
+    path.join(scriptsDestDir, 'rrr-memory'),
+    codexPathPrefix,
+    installed
+  );
+  copyFileIfExists(
+    path.join(src, 'scripts', 'build-project-context.js'),
+    path.join(scriptsDestDir, 'build-project-context.js'),
+    installed
+  );
+  copyFileIfExists(
+    path.join(src, 'scripts', 'bootstrap-external-skills.js'),
+    path.join(scriptsDestDir, 'bootstrap-external-skills.js'),
+    installed
+  );
+  copyFileIfExists(
+    path.join(src, 'scripts', 'gen-agents-md.js'),
+    path.join(scriptsDestDir, 'gen-agents-md.js'),
+    installed
+  );
+  copyFileIfExists(
+    path.join(src, 'scripts', 'jarvis.sh'),
+    path.join(scriptsDestDir, 'jarvis.sh'),
+    installed
+  );
+  copyFileIfExists(
+    path.join(src, 'scripts', 'verify-milestone.js'),
+    path.join(scriptsDestDir, 'verify-milestone.js'),
+    installed
+  );
+  copyFileIfExists(
+    path.join(src, 'rrr', 'lib', 'inline-status.js'),
+    path.join(codexHome, 'rrr', 'lib', 'inline-status.js'),
+    installed
+  );
+  copyFileIfExists(
+    path.join(src, 'CHANGELOG.md'),
+    path.join(codexHome, 'rrr', 'CHANGELOG.md'),
+    installed
+  );
+
+  fs.mkdirSync(path.join(codexHome, 'rrr'), { recursive: true });
+  fs.writeFileSync(path.join(codexHome, 'rrr', 'VERSION'), pkg.version);
+  installed.push(path.join(codexHome, 'rrr', 'VERSION'));
+
+  if (fs.existsSync(path.join(rrrDest, 'package.json'))) {
+    try {
+      execSync('npm install --omit=dev --silent 2>/dev/null || npm install --omit=dev', {
+        cwd: rrrDest,
+        stdio: 'pipe',
+        timeout: 120000
+      });
+      installed.push(path.join(rrrDest, 'node_modules'));
+    } catch (e) {
+      skipped.push(`runtime deps failed: ${e.message}`);
+    }
+  }
+
+  const mcpServerDir = path.join(rrrDest, 'mcp-server');
+  if (fs.existsSync(path.join(mcpServerDir, 'package.json'))) {
+    try {
+      execSync('npm install --omit=dev --silent 2>/dev/null || npm install --omit=dev', {
+        cwd: mcpServerDir,
+        stdio: 'pipe',
+        timeout: 60000
+      });
+      installed.push(path.join(mcpServerDir, 'node_modules'));
+    } catch (e) {
+      skipped.push(`MCP deps failed: ${e.message}`);
+    }
+  }
+
+  return { installed, skipped };
+}
+
+function refreshProjectAgentsMdForCodex({ src, projectDir, dryRun = false }) {
+  const planningStatePath = path.join(projectDir, '.planning', 'STATE.md');
+  if (!fs.existsSync(planningStatePath)) {
+    return { refreshed: false, reason: 'no-planning-state' };
+  }
+
+  const generatorPath = path.join(src, 'scripts', 'gen-agents-md.js');
+  const commandsDir = path.join(src, 'commands', 'rrr');
+  const outputPath = path.join(projectDir, 'AGENTS.md');
+
+  if (!fs.existsSync(generatorPath) || !fs.existsSync(commandsDir)) {
+    return { refreshed: false, reason: 'generator-missing' };
+  }
+
+  if (dryRun) {
+    return { refreshed: false, reason: 'dry-run' };
+  }
+
+  const { generateAgentsMd } = require(generatorPath);
+  const result = generateAgentsMd({ commandsDir, outputPath });
+  return { refreshed: true, outputPath, skillCount: result.skillCount };
+}
+
 /**
  * Install scripts to target project (for Pushpa Mode and MCP setup)
  */
@@ -1563,6 +1742,23 @@ function install(isGlobal) {
     console.log(`  ${green}✓${reset} Installed rrr/scripts/build-project-context.js`);
   }
 
+  const additionalRuntimeScripts = [
+    'bootstrap-external-skills.js',
+    'gen-agents-md.js',
+    'jarvis.sh',
+    'rrr-team-mode.js',
+    'verify-milestone.js',
+  ];
+  for (const scriptName of additionalRuntimeScripts) {
+    const scriptSrc = path.join(src, 'scripts', scriptName);
+    if (fs.existsSync(scriptSrc)) {
+      const scriptsDestDir = path.join(claudeDir, 'rrr', 'scripts');
+      fs.mkdirSync(scriptsDestDir, { recursive: true });
+      fs.copyFileSync(scriptSrc, path.join(scriptsDestDir, scriptName));
+      console.log(`  ${green}✓${reset} Installed rrr/scripts/${scriptName}`);
+    }
+  }
+
   // Copy inline-status.js for post-execution status display
   const inlineStatusSrc = path.join(src, 'rrr', 'lib', 'inline-status.js');
   if (fs.existsSync(inlineStatusSrc)) {
@@ -2184,18 +2380,42 @@ function install(isGlobal) {
   // Idempotent: installCodexSkills() overwrites existing files
   const codexStatus = detectCodexCLI();
   if (codexStatus.available) {
+    const codexHome = getCodexHome();
+    const codexHomeLabel = codexHome.replace(os.homedir(), '~');
+
+    try {
+      const runtimeResult = installCodexRuntimeAssets({
+        src,
+        codexHome,
+        dryRun: hasDryRun
+      });
+      const dryRunText = hasDryRun ? ' (dry-run)' : '';
+      console.log(`  ${green}✓${reset} Installed Codex runtime assets to ${codexHomeLabel}/rrr/${dryRunText}`);
+      if (runtimeResult.skipped.length > 0 && !hasDryRun) {
+        console.log(`  ${yellow}⚠${reset} Codex runtime skipped: ${runtimeResult.skipped.join(', ')}`);
+      }
+    } catch (e) {
+      // Silent fail — Codex runtime install is optional, must not break main Claude install
+      console.log(`  ${dim}Codex runtime assets skipped: ${e.message}${reset}`);
+    }
+
     try {
       const { installCodexSkills } = require('../rrr/lib/codex-skill-transform');
-      const codexSkillsDir = path.join(os.homedir(), '.codex', 'skills');
+      const codexSkillsDir = path.join(codexHome, 'skills');
       const rrrCommandsDir = path.join(src, 'commands', 'rrr');
       const result = installCodexSkills({
         sourceDir: rrrCommandsDir,
         targetDir: codexSkillsDir,
         dryRun: hasDryRun,
-        verbose: false
+        verbose: false,
+        codexPathPrefix: getCodexPathPrefix(codexHome),
+        codexEnvPathPrefix: getCodexEnvPathPrefix(codexHome)
       });
       if (result.errors.length === 0) {
-        console.log(`  ${green}✓${reset} Installed ${result.written.length} Codex skills to ~/.codex/skills/`);
+        const removedText = result.removed && result.removed.length > 0
+          ? `, removed ${result.removed.length} legacy flat files`
+          : '';
+        console.log(`  ${green}✓${reset} Installed ${result.written.length} Codex skills to ${codexHomeLabel}/skills/<skill>/SKILL.md${removedText}`);
       } else {
         console.log(`  ${yellow}⚠${reset} Installed ${result.written.length} Codex skills (${result.errors.length} errors)`);
         result.errors.slice(0, 3).forEach(e => {
@@ -2210,18 +2430,21 @@ function install(isGlobal) {
     // Install Codex agent .toml configs (AGENT-01, AGENT-02, AGENT-03)
     try {
       const { installCodexAgents } = require('../rrr/lib/codex-agent-gen');
-      const codexAgentsDir = path.join(os.homedir(), '.codex', 'agents');
+      const codexAgentsDir = path.join(codexHome, 'agents');
+      const codexConfigPath = path.join(codexHome, 'config.toml');
       const rrrAgentsDir = path.join(src, 'agents');
       const agentResult = installCodexAgents({
         sourceDir: rrrAgentsDir,
         targetDir: codexAgentsDir,
+        configPath: codexConfigPath,
         dryRun: hasDryRun,
         verbose: false
       });
       if (agentResult.errors.length === 0) {
         const removedCount = agentResult.removed.length;
         const removedText = removedCount > 0 ? `, pruned ${removedCount} stale configs` : '';
-        console.log(`  ${green}✓${reset} Installed ${agentResult.written.length} Codex agent configs to ~/.codex/agents/${removedText}`);
+        const registeredText = agentResult.registered > 0 ? `, registered ${agentResult.registered} in config.toml` : '';
+        console.log(`  ${green}✓${reset} Installed ${agentResult.written.length} Codex agent configs to ${codexHomeLabel}/agents/${removedText}${registeredText}`);
       } else {
         console.log(`  ${yellow}⚠${reset} Installed ${agentResult.written.length} agent configs (${agentResult.errors.length} errors)`);
         agentResult.errors.slice(0, 3).forEach(e => {
@@ -2232,6 +2455,21 @@ function install(isGlobal) {
       // Silent fail — agent install is optional, must not break main Claude install
       console.log(`  ${dim}Codex agents skipped: ${e.message}${reset}`);
     }
+
+    try {
+      const agentsMdResult = refreshProjectAgentsMdForCodex({
+        src,
+        projectDir: process.cwd(),
+        dryRun: hasDryRun
+      });
+      if (agentsMdResult.refreshed) {
+        const agentsPathLabel = agentsMdResult.outputPath.replace(process.cwd(), '.');
+        console.log(`  ${green}✓${reset} Refreshed ${agentsPathLabel} for Codex (${agentsMdResult.skillCount} skills)`);
+      }
+    } catch (e) {
+      // Silent fail — AGENTS.md is helpful for Codex, but should not block install/update
+      console.log(`  ${dim}Codex AGENTS.md refresh skipped: ${e.message}${reset}`);
+    }
   }
   // (no else — silently skip when codex is not in PATH)
 

package/commands/rrr/assign-phases.md

@@ -0,0 +1,57 @@
+---
+name: rrr:assign-phases
+description: Assign roadmap phases to GitHub teams for RRR team mode
+argument-hint: "--team <team> --phases <n,n> | interactive"
+allowed-tools:
+  - Read
+  - Write
+  - Edit
+  - Bash
+  - AskUserQuestion
+---
+
+<objective>
+Assign phases to GitHub teams as the primary team-mode work split.
+
+This command avoids hardcoded repo path ownership. The coordinator assigns outcome-oriented phases to teams; GitHub PRs, CODEOWNERS, and checks validate the actual files changed later.
+</objective>
+
+<process>
+
+1. **Load context**
+   - Read `.planning/STATE.md`.
+   - Read `.planning/ROADMAP.md`.
+   - Read `.planning/team-mode.json`.
+   - If team mode is missing, run `/rrr:team-init` first.
+
+2. **Assign**
+   If explicit args are provided:
+
+   ```bash
+   node ~/.claude/rrr/scripts/rrr-team-mode.js assign --team <team> --phases <phase-list>
+   ```
+
+   Development source repo fallback:
+
+   ```bash
+   node scripts/rrr-team-mode.js assign --team <team> --phases <phase-list>
+   ```
+
+   If no explicit args:
+   - Present phases from ROADMAP.md.
+   - Ask coordinator to assign each phase to one of the configured GitHub teams.
+   - Run the helper once per team with comma-separated phase numbers.
+
+3. **Output**
+   Show updated:
+   - `.planning/team-mode.json`
+   - `.planning/WORKSTREAMS.md`
+   - `.planning/workstreams/<team>/ASSIGNMENT.md`
+
+</process>
+
+<constraints>
+- Coordinator-only command.
+- Do not split by file paths during assignment.
+- Do not create GitHub PRs or Sprites here; dispatch does that later.
+</constraints>