chore(workflow): replace Codex agent layout with Claude Code - #74
Merged
Merged
Conversation
The repository targeted Codex sessions. Move the agent contract, skills, and session configuration to their Claude Code equivalents so a clean session at the repository root loads the correct instructions. - AGENTS.md becomes CLAUDE.md. - .agents/skills/ becomes .claude/skills/, dropping the Codex-only agents/openai.yaml interface metadata that Claude Code does not read. - .codex/config.toml becomes .claude/settings.json, pinning the same model and reasoning effort in Claude Code's native format. Tooling follows the layout rather than only its names: verify_metadata.py drops interface_metadata() and TOML parsing and now validates the settings JSON, and verification_scope.py drops the openai.yaml lightweight-path rule. .claude/settings.json classifies as a control file, so editing it still fails closed to the full hosted matrix, while SKILL.md edits stay lightweight. Verification: tools/verify_metadata.py passes (5 skills, 19 links); tests/tools/verify_metadata_test.py and tests/tools/verification_scope_test.py pass (3 tests each).
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Outcome and scope
The repository targeted Codex sessions. This moves the agent contract, skills, and session configuration to their Claude Code equivalents so a clean session opened at the repository root loads the correct instructions. No issue: this is a single coherent tooling slice with no acceptance criteria to negotiate.
AGENTS.mdCLAUDE.md.agents/skills/*/SKILL.md.claude/skills/*/SKILL.md.agents/skills/*/agents/openai.yaml.codex/config.toml.claude/settings.jsonTooling follows the layout rather than only its names:
tools/verify_metadata.pydropsinterface_metadata()andtomllib, validates.claude/settings.jsonas JSON, and no longer requiresagents/openai.yamlper skill.tools/verification_scope.pydrops the.agents/skills/**/agents/openai.yamllightweight-path rule..github/CODEOWNERS,README.md, and five documents underdocs/follow the rename..gitignorenow excludes/.claude/settings.local.json.Protocol, compatibility, economic, and security effects
None. No consensus-visible type, encoding, state transition, economic rule, or cryptographic behavior is touched. The change is confined to agent-session tooling, repository documentation, and their validators.
Verification
Scope classification behavior confirmed unchanged in intent:
.claude/settings.jsonremains a control file that fails closed to the full hosted matrix, exactly as.codex/config.tomldid;SKILL.mdedits remain on the focused metadata path.Known limitations and follow-up
verify_metadata_test.pynow asserts>= 2errors instead of>= 3in the rejection case, because removing theopenai.yamldefault_promptcheck removes one expected error. The remaining two (name mismatch, TODO marker) are the assertions that carry review value.