GitHub Issues and PRs

Workflow

• Use templates in .github/ISSUE_TEMPLATE/task.md and .github/PULL_REQUEST_TEMPLATE.md.
• Use gh with --body-file to avoid shell quoting problems.
• For milestones, use gh milestone --help and follow the standard GitHub milestone workflow.

Content conventions

• Be literal, unambiguous, and clear.
• Include required readings so future agents pick them up.
• Use numbered/lettered lists for stable references.
• Calibrated confidence: distinguish must‑haves vs speculative ideas.
• Add skimmable extra commentary for the owner.

Identity note

• All agents share the project owner’s GitHub identity; clarify authorship/assignee in body text or footers.