← graph

create-agents-md

Create AGENTS.md (copy of CLAUDE.md) for codex CLI compatibility

Metadata

Statusdone
Assignedagent-941
Agent identityf51439356729d112a6c404803d88015d5b44832c6c584c62b96732b63c2b0c7e
Modelcodex:gpt-5.5
Created2026-04-28T20:02:59.525457825+00:00
Started2026-04-28T21:34:05.892214628+00:00
Completed2026-04-28T21:38:02.966951017+00:00
Tagseval-scheduled, converged
Eval score0.04
└ blocking impact0.10
└ completeness0.00
└ constraint fidelity0.10
└ coordination overhead0.20
└ correctness0.00
└ downstream usability0.00
└ efficiency0.10
└ intent fidelity0.03
└ style adherence0.00

Description

Description

Create /home/erik/workgraph/AGENTS.md as a copy of /home/erik/workgraph/CLAUDE.md. The codex CLI reads AGENTS.md from the working directory the same way claude reads CLAUDE.md — without it, codex agents start cold and don't know wg conventions (use wg for tasks, don't spawn subagents, smoke gate on wg done, etc).

This is a smoke task to verify the codex handler works end-to-end in this repo. It should be trivial — copy a file, commit, done.

Steps

  1. Copy CLAUDE.md verbatim to AGENTS.md (plain file copy, NOT a symlink — symlinks are fragile across platforms and git).
  2. Don't edit the content. Even Claude-specific bits (Task tool warnings) are mostly applicable since codex has analogous concepts. Future tasks can refine.
  3. CRITICAL: commit AGENTS.md to your worktree branch yourself before wg done. wg done does not commit staged changes for you — it only squash-merges existing commits on your branch into main. If you only run git add and then wg done, your work is silently dropped (see docs/codex-handler-merge-bug.md). The exact sequence to run from the worktree directory: 
    git add AGENTS.md
git commit -m "feat: add AGENTS.md (copy of CLAUDE.md) for codex CLI compatibility"
wg done create-agents-md
    wg done will then squash-merge the commit to main and emit a [merge] Squash-merged ... line — if you don't see that line, the merge did NOT happen.

Out of scope

  • Don't add any wg-codex-specific docs yet
  • Don't refactor CLAUDE.md
  • Don't try to dedupe between the two files

Validation

  • AGENTS.md exists at /home/erik/workgraph/AGENTS.md ON MAIN (git ls-tree main -- AGENTS.md shows it)
  • AGENTS.md byte-identical to CLAUDE.md at the time of copy (cmp CLAUDE.md AGENTS.md returns 0)
  • Not a symlink (test -L AGENTS.md is false; test -f AGENTS.md is true)
  • A feat: create-agents-md commit exists on main (git log main --oneline | grep create-agents-md)
  • cargo build still passes (no Rust changes expected, just sanity)

Depends on

Required by

Log