execute-round

execute-round

Orchestrates the 4-commit chain for an arcgentic round per spec § 4.2.3. Reads the planned handoff (from plan-round skill or hand-authored), then executes Phase 1-4 via the arcgentic Python CLI.

When to invoke

• User says "let's execute round R{N}" or "run the 4-commit chain for the handoff at ..."
• User runs /execute-round <round_name> slash command
• A handoff doc exists at docs/superpowers/plans/... and dev work is ready to start

Prerequisites

Requires the arcgentic CLI:

• Stable: pipx install arcgentic
• Dev: cd toolkit && pip install -e ".[dev]"

Requires a planned handoff doc — run /plan-round first if missing.

V1 projects must resolve the session-mode gate before implementation. If project.session_mode.mode is already present in .agentic-rounds/state.yaml, use it and do not ask again:

arcgentic session-mode recommend --round=$ROUND --handoff=$HANDOFF_PATH
arcgentic session-mode prompt --round=$ROUND --handoff=$HANDOFF_PATH --mode=multi-session --role=developer

Inputs

Parse from $ARGUMENTS:

• round_name (e.g. "R10-L3-aletheia")
• handoff_path (defaults to most recent docs/superpowers/plans/{date}-{round}-handoff.md)
• --dry-run flag (optional; skip all commits and pushes)

Workflow

When invoked:

1. Verify the handoff doc exists at handoff_path.
2. Shell out:

   arcgentic execute-round-impl --round=$ROUND --handoff=$HANDOFF_PATH [--dry-run]
   

3. The CLI orchestrates 4 phases:
   • Phase 1 — Entry-admin commit: commit handoff + state-row updates
   • Phase 2 — BA design pass: dispatch ba-designer → write design doc → commit
   • Phase 3 — Dev body: dispatch developer → run pre-audit quality gates (mypy / pytest / ruff) → inline CR step → inline SE step (MANDATE #20: NO BA design in SE brief) → commit
   • Phase 4 — State refresh + self-audit handoff: compose self-audit handoff doc with stable artifact/fixed-anchor facts → run arcgentic audit-check --strict-extended → write → commit