Skip to content

Commit 3706133

Browse files
committed
Local snapshot: add phase 5e review workflow contract
1 parent 0f2a76a commit 3706133

5 files changed

Lines changed: 506 additions & 1 deletion

File tree

.agents/skills/ctxt-antigravity-runtime/SKILL.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -31,6 +31,7 @@ Use these commands first to inspect the shared contract and runtime surface:
3131
cargo run --bin ctxt -- --json self report
3232
cargo run --bin ctxt -- --json startup readiness
3333
cargo run --bin ctxt -- --json startup flow
34+
cargo run --bin ctxt -- --json review workflow
3435
cargo run --bin ctxt -- --json schema
3536
cargo run --bin ctxt -- --json capabilities
3637
cargo run --bin ctxt -- --json subagents list
@@ -107,6 +108,14 @@ Readiness is a contract-only report. It does not run commands automatically. `re
107108

108109
Use official docs only for architecture and best-practice claims.
109110

111+
# Review Workflow Contract
112+
113+
Agents should call `ctxt --json review workflow` to discover the deterministic review workflow.
114+
115+
Review workflow is a contract-only checklist. It does not run commands automatically, read artifacts automatically, apply proposals or reviews, or imply external execution is allowed.
116+
117+
Use official docs only for architecture and best-practice claims.
118+
110119
# Plan Artifacts Only
111120

112121
For Antigravity plan artifacts only, use:

.agents/skills/ctxt-runtime/SKILL.md

Lines changed: 9 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -66,6 +66,7 @@ Use these commands for safe, JSON-oriented runtime inspection:
6666
cargo run --bin ctxt -- --json self report
6767
cargo run --bin ctxt -- --json startup readiness
6868
cargo run --bin ctxt -- --json startup flow
69+
cargo run --bin ctxt -- --json review workflow
6970
cargo run --bin ctxt -- --json agent list
7071
cargo run --bin ctxt -- --json agent discover
7172
cargo run --bin ctxt -- --json agent discover --kind codex
@@ -183,6 +184,14 @@ Agents should call `ctxt --json startup readiness` before starting review workfl
183184

184185
`ready_for_review_workflow: true` does not imply external execution is allowed. `ready_for_external_execution: false` remains the hard boundary. Use official docs only for architecture and best-practice claims.
185186

187+
# Phase 5e Note
188+
189+
Phase 5e adds a deterministic review workflow contract through `ctxt --json review workflow`.
190+
191+
Agents should call `ctxt --json review workflow` to discover the deterministic review workflow. Review workflow is a contract-only checklist. It does not run commands automatically, read artifacts automatically, apply proposals or reviews, or imply external execution is allowed.
192+
193+
Use official docs only for architecture and best-practice claims.
194+
186195
# Cross-Agent Compatibility
187196

188197
Codex and Antigravity should both route through `ctxt`.

docs/AGENT_RUNTIME_CLI.md

Lines changed: 10 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -234,6 +234,16 @@ The readiness report is not an execution gate. It does not execute commands, inv
234234

235235
External tools may use `ctxt --json startup readiness` to decide whether the deterministic review workflow is available. `ready_for_review_workflow: true` does not imply external execution is allowed; `ready_for_external_execution: false` remains the hard boundary.
236236

237+
## Phase 5e Behavior
238+
239+
Phase 5e adds a deterministic review workflow contract.
240+
241+
`ctxt --json review workflow` returns a static checklist that connects startup readiness, startup flow, subagent role contracts, proposal artifacts, review artifacts, and `ctxt --json validate --run`.
242+
243+
The review workflow contract does not execute commands, read artifacts, apply proposals, apply review recommendations, invoke Codex CLI, invoke Antigravity CLI, invoke external agents, use network, execute subagents, or perform git writes.
244+
245+
External tools may use `ctxt --json review workflow` as a deterministic checklist for review work. The singular `review workflow` namespace is static workflow introspection; the plural `reviews` namespace remains the local review artifact interface.
246+
237247
## Future Phases
238248

239249
Later phases may add real Codex CLI or Antigravity CLI invocation behind explicit gates. Those phases should preserve the run artifact, keep JSON output machine-readable, and record provenance before and after external execution.

0 commit comments

Comments
 (0)