github-issue

Overview

Create well-scoped GitHub issues using the repo’s Codex issue template and gh issue create. Keep issues detailed enough for a Codex Argo workflow to execute the full request in one run.

Workflow

1) Gather the required details

• Ensure you have: summary, context, desired outcome, scope (in/out), constraints/risks, rollout notes, validation, and a Codex prompt.
• If the user already provided content, reuse it verbatim and only ask for missing fields.

2) Start from the template

• Use .github/ISSUE_TEMPLATE/codex-task.md as the base.
• Copy it into a temp file and fill in every section. Keep it concise but complete.

3) Write a precise Codex prompt

• The prompt should be an explicit, step-by-step plan with exact file paths, constraints, and expected outputs.
• If multiple fixes are needed, enumerate them and specify validation.
• Avoid ambiguity; Codex should be able to execute without follow-up.

4) Create the issue with gh

cp .github/ISSUE_TEMPLATE/codex-task.md /tmp/issue.md
$EDITOR /tmp/issue.md
gh issue create --title "<clear, scoped title>" --body-file /tmp/issue.md --label codex

5) Report the result

• Return the issue URL and a short confirmation.
• If the repo requires extra labels or assignees, add them explicitly.

Notes

• Prefer one issue per coherent workstream.
• When a request spans multiple components, ensure scope boundaries are clear in the template.