--- name: verify-repo-change description: Govern Codex repository changes with persistent semantic context, adaptive context budgets, bounded processes, artifact-aware stopping, and evidence-based completion. --- # Govern a repository change with Sentinel 1. Confirm the canonical checkout and branch. Do not operate on an accidental duplicate checkout. 2. Translate the request into observable acceptance criteria. Include success, failure, reset and repeat behaviour when relevant. 3. Start with `task_begin`, supplying nonempty acceptance criteria and required checks. Required checks must represent what must actually be established before claiming completion. If the user cancels or replaces an active task, use its exact `replace_active_task_id` and a `replacement_reason` to preserve its unfinished history. Never use task replacement to bypass failed checks or context limits. 4. Use `context_bundle` for first-pass orientation. It may refresh stale semantic memory automatically and should replace broad exploratory reading. 5. Use `semantic_find`, `dependency_context`, or `change_impact` for focused follow-up. Use `repo_search` or `symbol_context` only when semantic evidence is insufficient. 6. Respect the context budget. Do not evade duplicate suppression by cosmetically changing the same query. Extend the budget only when more repository context is necessary for correctness and state why. 7. Implement the smallest complete change. Use `repo_changes` to detect unrelated edits. 8. Prefer `run_bounded_command` over open-ended process waiting. 9. When a build must produce an artifact, use `build_artifact`. It checks newly produced output or recorded reuse for the same command and inputs. `BUILD_COMPLETE` does not establish signing, app version, installation or runtime behavior; verify those separately when requested. 10. For Railway or another asynchronous external service, use `external_status`. Keep the same deployment key and wait at least `retry_after_seconds` (30 seconds) between reads; each command has a 60-second timeout. There are 30 checks per key by default. Continue until deployment succeeds, fails, or requires action, then verify the public runtime. If the budget runs out and the user explicitly authorizes continued verification, pass `continuation_reason` to add 30 checks on the same key, up to 120 total. Do not work around limits by changing keys, reset the task to bypass a failed check, or claim deployment success from build output alone. 11. Verify behaviour at the most direct available level. Unit tests, HTTP responses, artifact existence, browser observation, physical-device observation and production deployment are different evidence levels. 12. Record actual evidence with `record_verification`. For `evidence_kind: command`, use the successful `command_id` returned by `run_bounded_command`. For `evidence_kind: observation`, save screenshots or captured logs inside the checkout and provide `evidence_paths`. Observation files are integrity checked, but their meaning remains an agent-reported observation. Never fabricate a report to satisfy a gate. Text alone cannot pass. Rerun affected verification after edits because completion checks source and evidence freshness. 13. Call `task_finish`. If it refuses, report the missing or unverified behaviour rather than claiming full completion. 14. When `task_finish` succeeds, stop. Use `task_report` for the compact final summary. Start a new task only if the user requests additional work or new evidence invalidates completion. A high-reasoning model is compatible with this workflow. Sentinel exists to reduce avoidable repository context, repeated reads and process waiting without lowering the reasoning ceiling.