TL;DR
Install .agent/ Scrum kit + .codex/agents/ native agents → use ceremony playbooks (sprint plan, daily scrum, retro, release) → enforce role boundaries between PO, SM, and delivery specialists.
Codex Scrum Subagents
Activation
- Activate when the user requests Scrum ceremonies or role-based workflows.
- Activate on explicit
$codex-scrum-subagents or $scrum-install.
Overview
Materialize a project-local Scrum kit that adds two layers on top of the existing CodexAI skills:
.agent/ for ceremony playbooks, role briefs, and workflow manifests
.codex/agents/ for native Codex custom-agent TOMLs that follow the official subagent discovery path
Use this skill when the team needs explicit role boundaries and delivery handoffs instead of a single monolithic assistant flow.
Quick Start
- Run
python scripts/install_scrum_subagents.py --help.
- Install the bundled kit into the target project:
python scripts/install_scrum_subagents.py --target-root <project-root>
python scripts/install_scrum_subagents.py --target-root <project-root> --native-scope both
- Inspect differences before updating:
python scripts/install_scrum_subagents.py --target-root <project-root> --diff --format json
- Refresh only missing or changed files, with automatic backups for overwritten files:
python scripts/install_scrum_subagents.py --target-root <project-root> --update
- Validate either the bundled kit or an installed
.agent tree:
python scripts/validate_scrum_agent_kit.py --help
python scripts/validate_scrum_agent_kit.py
python scripts/validate_scrum_agent_kit.py --install-root <project-root>/.agent
python scripts/validate_scrum_agent_kit.py --target-root <project-root> --install-dir .meta/.agent --native-scope both
Command Aliases
Use references/command-aliases.md when the user wants a shorthand trigger instead of the raw Python entry point.
Common shortcuts:
$scrum-install: install the local .agent kit plus native .codex/agents Codex custom agents
$scrum-diff: compare installed .agent and .codex/agents files against the source bundle
$scrum-update: update only missing or changed files across both layers
$scrum-validate: validate the bundle or installed .agent plus .codex/agents tree
$story-ready-check, $sprint-plan, $daily-scrum, $story-delivery, $sprint-review, $retro, $release-readiness: jump straight to the ceremony or delivery workflow
scripts/run_scrum_alias.py: execute an alias and optionally generate the mapped artifact
scripts/generate_scrum_artifact.py: render reusable Scrum markdown artifacts from bundled templates
- Workflow artifacts now require complete fields by default; use
--allow-placeholders only when you explicitly want a scaffold artifact with _TODO_ markers.
What Gets Installed
agents/: Scrum core roles plus delivery specialists tuned for this pack.
workflows/: ceremony-driven playbooks for refinement, planning, execution, review, retro, and release.
services/: lightweight JSON manifests for docs tooling or UI surfaces.
ARCHITECTURE.md and README.md: onboarding docs for the installed .agent kit.
assets/artifact-templates/: user story, sprint goal, daily scrum, retrospective, story delivery, and release readiness templates.
.codex/agents/*.toml: native Codex custom agents rendered from the Scrum role briefs so subagent activity can surface in the Codex app and CLI.
Role Routing
- Start with references/scrum-role-routing.md to choose the right subagent set for the request.
- Load references/scrum-ceremonies.md when the task is driven by a Scrum ceremony rather than a code change.
- Load references/command-aliases.md when the request uses shorthand commands like
$scrum-install, $story-ready-check, or $release-readiness.
- Load references/artifact-templates.md when the workflow needs a repeatable markdown output instead of free-form notes.
- Load references/delivery-contracts.md when multiple roles need explicit artifact handoffs.
- Load references/subagent-boundaries.md before large orchestrations so responsibilities do not bleed across roles.
Installation Notes
- Default install targets are
<project-root>/.agent and <project-root>/.codex/agents.
--native-scope project|personal|both controls whether native Codex custom agents land in the project, the personal ~/.codex/agents folder, or both.
- Existing pack-managed files in either location block installation unless
--force is supplied.
--diff reports missing, changed, same, and extra files for both the .agent bundle and the native .codex/agents layer.
--update copies only missing or changed files across both layers and writes a fresh provenance stamp.
- Validator supports both
--install-root and the symmetric --target-root + --install-dir form so custom install directories stay aligned with native-agent validation.
--backup-dir lets the caller choose where overwritten files are archived during update.
- The installer writes
.codexai-scrum-kit.json into the installed folder so the project can track provenance and bundle counts.
- The installed subagents are designed to call back into existing skills like
codex-plan-writer, codex-domain-specialist, codex-security-specialist, codex-execution-quality-gate, and codex-project-memory instead of duplicating that knowledge.
- Restart Codex after installation if you want newly installed native custom agents to be picked up immediately by the app or CLI.
Guardrails
- Keep Product Owner focused on value, backlog, acceptance criteria, and sequencing.
- Keep Scrum Master facilitative; it owns flow and impediments, not solution details or scope decisions.
- Use delivery specialists only after backlog intent and sprint goal are explicit.
- Keep QA, security, and release checks attached to each story before marking it done.
1---2name: codex-scrum-subagents3description: Use when work needs Scrum roles, ceremonies, backlog refinement, sprint planning, story delivery, release readiness, or role handoffs.4load_priority: on-demand5metadata:6 source: https://skillmd.com/skills/bang-isme/codex-scrum-subagents7---89## TL;DR10Install `.agent/` Scrum kit + `.codex/agents/` native agents → use ceremony playbooks (sprint plan, daily scrum, retro, release) → enforce role boundaries between PO, SM, and delivery specialists.1112# Codex Scrum Subagents1314## Activation15161. Activate when the user requests Scrum ceremonies or role-based workflows.172. Activate on explicit `$codex-scrum-subagents` or `$scrum-install`.1819## Overview2021Materialize a project-local Scrum kit that adds two layers on top of the existing CodexAI skills:2223- `.agent/` for ceremony playbooks, role briefs, and workflow manifests24- `.codex/agents/` for native Codex custom-agent TOMLs that follow the official subagent discovery path2526Use this skill when the team needs explicit role boundaries and delivery handoffs instead of a single monolithic assistant flow.272829## Quick Start30311. Run `python scripts/install_scrum_subagents.py --help`.322. Install the bundled kit into the target project:3334```bash35python scripts/install_scrum_subagents.py --target-root <project-root>36python scripts/install_scrum_subagents.py --target-root <project-root> --native-scope both37```38393. Inspect differences before updating:4041```bash42python scripts/install_scrum_subagents.py --target-root <project-root> --diff --format json43```44454. Refresh only missing or changed files, with automatic backups for overwritten files:4647```bash48python scripts/install_scrum_subagents.py --target-root <project-root> --update49```50515. Validate either the bundled kit or an installed `.agent` tree:5253```bash54python scripts/validate_scrum_agent_kit.py --help55python scripts/validate_scrum_agent_kit.py56python scripts/validate_scrum_agent_kit.py --install-root <project-root>/.agent57python scripts/validate_scrum_agent_kit.py --target-root <project-root> --install-dir .meta/.agent --native-scope both58```5960## Command Aliases6162Use [references/command-aliases.md](references/command-aliases.md) when the user wants a shorthand trigger instead of the raw Python entry point.6364Common shortcuts:6566- `$scrum-install`: install the local `.agent` kit plus native `.codex/agents` Codex custom agents67- `$scrum-diff`: compare installed `.agent` and `.codex/agents` files against the source bundle68- `$scrum-update`: update only missing or changed files across both layers69- `$scrum-validate`: validate the bundle or installed `.agent` plus `.codex/agents` tree70- `$story-ready-check`, `$sprint-plan`, `$daily-scrum`, `$story-delivery`, `$sprint-review`, `$retro`, `$release-readiness`: jump straight to the ceremony or delivery workflow71- `scripts/run_scrum_alias.py`: execute an alias and optionally generate the mapped artifact72- `scripts/generate_scrum_artifact.py`: render reusable Scrum markdown artifacts from bundled templates73- Workflow artifacts now require complete fields by default; use `--allow-placeholders` only when you explicitly want a scaffold artifact with `_TODO_` markers.7475## What Gets Installed7677- `agents/`: Scrum core roles plus delivery specialists tuned for this pack.78- `workflows/`: ceremony-driven playbooks for refinement, planning, execution, review, retro, and release.79- `services/`: lightweight JSON manifests for docs tooling or UI surfaces.80- `ARCHITECTURE.md` and `README.md`: onboarding docs for the installed `.agent` kit.81- `assets/artifact-templates/`: user story, sprint goal, daily scrum, retrospective, story delivery, and release readiness templates.82- `.codex/agents/*.toml`: native Codex custom agents rendered from the Scrum role briefs so subagent activity can surface in the Codex app and CLI.8384## Role Routing8586- Start with [references/scrum-role-routing.md](references/scrum-role-routing.md) to choose the right subagent set for the request.87- Load [references/scrum-ceremonies.md](references/scrum-ceremonies.md) when the task is driven by a Scrum ceremony rather than a code change.88- Load [references/command-aliases.md](references/command-aliases.md) when the request uses shorthand commands like `$scrum-install`, `$story-ready-check`, or `$release-readiness`.89- Load [references/artifact-templates.md](references/artifact-templates.md) when the workflow needs a repeatable markdown output instead of free-form notes.90- Load [references/delivery-contracts.md](references/delivery-contracts.md) when multiple roles need explicit artifact handoffs.91- Load [references/subagent-boundaries.md](references/subagent-boundaries.md) before large orchestrations so responsibilities do not bleed across roles.9293## Installation Notes9495- Default install targets are `<project-root>/.agent` and `<project-root>/.codex/agents`.96- `--native-scope project|personal|both` controls whether native Codex custom agents land in the project, the personal `~/.codex/agents` folder, or both.97- Existing pack-managed files in either location block installation unless `--force` is supplied.98- `--diff` reports missing, changed, same, and extra files for both the `.agent` bundle and the native `.codex/agents` layer.99- `--update` copies only missing or changed files across both layers and writes a fresh provenance stamp.100- Validator supports both `--install-root` and the symmetric `--target-root` + `--install-dir` form so custom install directories stay aligned with native-agent validation.101- `--backup-dir` lets the caller choose where overwritten files are archived during update.102- The installer writes `.codexai-scrum-kit.json` into the installed folder so the project can track provenance and bundle counts.103- The installed subagents are designed to call back into existing skills like `codex-plan-writer`, `codex-domain-specialist`, `codex-security-specialist`, `codex-execution-quality-gate`, and `codex-project-memory` instead of duplicating that knowledge.104- Restart Codex after installation if you want newly installed native custom agents to be picked up immediately by the app or CLI.105106## Guardrails107108- Keep Product Owner focused on value, backlog, acceptance criteria, and sequencing.109- Keep Scrum Master facilitative; it owns flow and impediments, not solution details or scope decisions.110- Use delivery specialists only after backlog intent and sprint goal are explicit.111- Keep QA, security, and release checks attached to each story before marking it done.