| name | codex-orchestration |
| description | Orchestrate phased work where cobs is the sole developer and quality-mgr enforces the QA gate for sc-observability. |
Codex Orchestration
This skill defines a lightweight phase workflow for standalone repos like
sc-observability.
Model
team-lead coordinates
cobs is the sole developer
quality-mgr runs QA after each sprint delivery
The repo may use either:
- direct sprint PRs to
main, or
- an explicit
integrate/phase-{P} branch when a phase needs a staging branch
Use the pr_target in the assignment as the source of truth.
Preconditions
Before starting:
docs/requirements.md, docs/architecture.md, and docs/project-plan.md
describe the sprint.
- The target branch for the sprint is chosen (
main or integrate/phase-{P}).
- A worktree exists for the sprint branch.
quality-mgr, rust-qa-agent, req-qa, and arch-qa are available.
Sprint Flow
- Team-lead sends a sprint assignment to
cobs using dev-template.xml.j2.
cobs ACKs, implements, commits, pushes, and reports the branch + SHA.
- Team-lead opens/updates the PR.
- Team-lead assigns QA to
quality-mgr using qa-template.xml.j2.
quality-mgr runs:
rust-qa-agent
req-qa
arch-qa
- If QA passes and CI is green, merge proceeds.
- If QA fails, team-lead routes the fixes back to
cobs.
CI
Use standard GitHub CLI for PR checks:
gh pr checks <PR> --watch
gh pr view <PR> --json mergeStateStatus,reviewDecision
Do not assume ATM-specific PR monitoring commands exist in this repo.
Worktrees
Create sprint worktrees with normal git worktree commands when needed:
git worktree add ../<repo>-worktrees/<branch-name> -b <branch-name> <base-branch>
Required Message Sequence
Every ATM task message must follow:
- ACK
- Work
- Completion summary
- Completion ACK by receiver