Skip to content

Design Codex command/runbook adapter for former Claude slash commands #4

Description

@ethanolivertroy

Context

The source repo exposes workflows as Claude Code slash commands such as:

  • /grc-engineer:gap-assessment
  • /grc-engineer:scan-iac
  • /github-inspector:collect
  • /oscal:*
  • /fedramp-ssp:*

Codex app may not support Claude Code plugin command registration or the same slash-command dispatch model. Many command files may still be useful as Markdown runbooks, but they need a Codex-compatible invocation strategy.

Tasks

  • Inventory all plugins/**/commands/*.md files.
  • Classify command types:
    • pure prompt/runbook
    • script-backed command
    • external CLI wrapper
    • cloud/SaaS connector requiring credentials
    • Claude-only command
  • Define a Codex invocation pattern, for example:
    • npm run <script> for script-backed workflows
    • docs/runbooks/*.md for prompt/runbook workflows
    • task prompt templates for Codex app
  • Decide whether to generate a command index such as docs/CODEX-COMMANDS.md.
  • Add examples translating Claude commands to Codex tasks.

Acceptance Criteria

  • There is a documented mapping from major Claude slash commands to Codex-compatible actions.
  • Unsupported commands are explicitly marked unsupported/deferred instead of silently failing.

Metadata

Metadata

Assignees

No one assigned

    Labels

    architectureArchitecture or design decision neededcodex-appSpecific to running in the Codex appcodex-migrationWork required to adapt this fork for Codex app/harness usagecompatibilityHarness, runtime, or workflow compatibility workpriority: 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