Skip to content

Create AGENTS.md for Codex repo instructions #3

Description

@ethanolivertroy

Context

The repository currently has CLAUDE.md, which provides Claude Code-specific guidance. Codex conventionally uses repository instructions such as AGENTS.md for agent behavior, commands, testing, and project-specific constraints.

Tasks

  • Create root AGENTS.md for Codex.
  • Port relevant content from CLAUDE.md while removing Claude Code-specific assumptions.
  • Document supported shell commands and test commands from package.json.
  • Explain the plugin directory structure in Codex-neutral terms.
  • Add guardrails for GRC/security/compliance output:
    • do not reproduce copyrighted framework text beyond allowed excerpts
    • cite SCF as crosswalk/reference where applicable
    • preserve evidence provenance and chain-of-custody
  • Include migration warning: .claude-plugin content is source material until Codex compatibility is implemented.

Acceptance Criteria

  • Codex can use AGENTS.md as its primary repo instruction file.
  • CLAUDE.md may remain for source compatibility, but Codex users are directed to AGENTS.md.

Metadata

Metadata

Assignees

No one assigned

    Labels

    codex-appSpecific to running in the Codex appcodex-migrationWork required to adapt this fork for Codex app/harness usagedocsDocumentation/onboarding changesgood first migration issueScoped migration task suitable for contributorspriority: highHigh priority migration blocker

    Type

    No type
    No fields configured for issues without a type.

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions