Skip to content

Codex exec delegation scaffolding#1

Merged
VoidAxiom merged 2 commits into
mainfrom
sk/codex-delegation-scaffold
May 17, 2026
Merged

Codex exec delegation scaffolding#1
VoidAxiom merged 2 commits into
mainfrom
sk/codex-delegation-scaffold

Conversation

@VoidAxiom
Copy link
Copy Markdown
Owner

Makes the Claude→codex exec delegation contract executable in-repo.

What

  • .codex/DELEGATION.md — canonical in-repo contract (source --json typo corrected)
  • .codex/schemas/codex-result.schema.json--output-schema target
  • .codex/task-template.md — task-packet format
  • AGENTS.md — Codex-facing worker rules (Codex reads AGENTS.md; our conventions were CLAUDE.md-only — real gap)
  • scripts/codex-run.sh — dispatch + full run-packet capture; defensive about the unverified -o/model assumptions; CODEX_MODEL env
  • CLAUDE.md — division-of-labor section: Codex is the code workhorse; Claude keeps architecture/taste/integration/final judgment and owns runtime/visual inspection directly (harness + chrome-devtools MCP), not delegated
  • .gitignore .codex-runs/; settings allowlist for the helper + codex exec, deny sandbox/network bypass

Director corrections to the source contract

  1. Fixed --jso--sandbox--json --sandbox.
  2. Added the missing AGENTS.md (Task Packet referenced it but it didn't exist).
  3. Overrode "use Codex for DevTools/runtime" → Claude-owned inspection per direction.
  4. Flagged unverified model id and -o+--json interaction; helper is defensive + a one-time smoke check is required before trusting them.

Notes

  • No Linear issue linked — Linear MCP isn't loaded in the authoring session; link to be added when available (no Fixes <ID> yet).
  • Not auto-merging: foundational infra — wants human eyes and/or @codex review before merge. CI verify will run on this PR.

Makes the Claude->codex-exec contract executable:
- .codex/DELEGATION.md (canonical in-repo contract; --json typo fixed)
- .codex/schemas/codex-result.schema.json (--output-schema target)
- .codex/task-template.md (task packet format)
- AGENTS.md (Codex-facing worker rules; Codex reads AGENTS.md, our
  conventions were CLAUDE.md-only)
- scripts/codex-run.sh (dispatch + run-packet capture, defensive about
  unverified -o/model assumptions; CODEX_MODEL env)
- CLAUDE.md division-of-labor section (Codex is the code workhorse;
  Claude keeps architecture/taste/integration/judgment and owns
  runtime/visual inspection directly via the harness + chrome-devtools
  MCP, not delegated)
- .gitignore .codex-runs/; settings allowlist for the helper + codex
  exec, deny sandbox/network bypass

Director corrections to the source contract: fixed the Explorer
command typo, added the missing AGENTS.md, and overrode runtime/UI
inspection to Claude-owned per direction.
@VoidAxiom
Copy link
Copy Markdown
Owner Author

@codex review

Copy link
Copy Markdown

@chatgpt-codex-connector chatgpt-codex-connector Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

💡 Codex Review

Here are some automated review suggestions for this pull request.

Reviewed commit: c2da1220ce

ℹ️ About Codex in GitHub

Your team has set up Codex to review pull requests in this repo. Reviews are triggered when you

  • Open a pull request for review
  • Mark a draft as ready
  • Comment "@codex review".

If Codex has suggestions, it will comment; otherwise it will react with 👍.

Codex can also answer questions or update the PR. Try commenting "@codex address that feedback".

Comment thread scripts/codex-run.sh Outdated
Addresses Codex review P2: a missing/unreadable task-file or failed
copy previously fell through (no set -e) to a stale task.md from an
earlier run with the same run-id. Now requires the source readable and
the copy to succeed, else exits non-zero.
@VoidAxiom
Copy link
Copy Markdown
Owner Author

P2 addressed in 745e139: codex-run.sh now aborts (exit 2) if the task-file is unreadable or the copy fails, so a stale task.md from a prior same-run-id can no longer be executed silently. Resolving this thread.

@VoidAxiom VoidAxiom merged commit 69289da into main May 17, 2026
1 check passed
@VoidAxiom VoidAxiom deleted the sk/codex-delegation-scaffold branch May 17, 2026 00:53
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant