Skip to content

docs: codify the agent-ready issue standard#4860

Merged
Hmbown merged 1 commit into
mainfrom
codex/harvest-4536-agent-ready
Jul 26, 2026
Merged

docs: codify the agent-ready issue standard#4860
Hmbown merged 1 commit into
mainfrom
codex/harvest-4536-agent-ready

Conversation

@Hmbown

@Hmbown Hmbown commented Jul 26, 2026

Copy link
Copy Markdown
Owner

No-Issue: contributor-stewardship documentation standard.

Summary

  • defines the executable issue structure for fresh agents
  • documents verified-anchor discipline and the maintainer/community triage boundary
  • links the standard from AGENTS.md and ISSUE_TRIAGE.md

Harvested from PR #4536 by @Hmbown. The unrelated keybindings follow-up from that draft is deliberately excluded.

Verification

  • git diff --check origin/main...HEAD
  • python3 scripts/check-coauthor-trailers.py --range origin/main..HEAD --check-authors
  • link targets inspected with rg -n AGENT_READY_ISSUES AGENTS.md docs/ISSUE_TRIAGE.md

Capture the executable issue-spec convention and community triage boundary from PR #4536 on current main.

Harvested from PR #4536 by @Hmbown

Co-authored-by: Hmbown <101357273+Hmbown@users.noreply.github.com>
Copilot AI review requested due to automatic review settings July 26, 2026 06:32
@cursor

cursor Bot commented Jul 26, 2026

Copy link
Copy Markdown

Bugbot is not enabled for your account, so this pull request was not reviewed.

Enable Bugbot in the Cursor dashboard to get automatic reviews on future PRs.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Copilot was unable to review this pull request because the user who requested the review has reached their quota limit.

@claude

claude Bot commented Jul 26, 2026

Copy link
Copy Markdown
Contributor

Claude finished @Hmbown's task in 48s —— View job


Review: docs: codify the agent-ready issue standard

  • Gather context (diff, changed files)
  • Review AGENTS.md changes
  • Review docs/AGENT_READY_ISSUES.md (new file)
  • Review docs/ISSUE_TRIAGE.md changes
  • Post final review

Summary: Docs-only change (no code, no Cargo.toml/CI touched). It defines the agent-ready issue standard, cross-links it from AGENTS.md and docs/ISSUE_TRIAGE.md, and — appropriately for a doc about anchor discipline — practices what it preaches.

Verified:

  • .github/ISSUE_TEMPLATE/agent-task.yml (linked from the new doc) exists.
  • Both relative links (AGENT_READY_ISSUES.mdISSUE_TRIAGE.md) resolve.
  • The example anchor in "Required structure" (crates/tui/src/model_routing.rs::provider_router_candidates) is real — crates/tui/src/model_routing.rs:52.
  • The example crate names (codewhale-tui, codewhale-config, codewhale-protocol) match the actual package names in their Cargo.tomls.
  • git diff --check origin/main...HEAD is clean (no whitespace errors).

Notes (no changes requested):

  • Since this is documentation with no code/provider-routing/test surface, items 1–5 of the standard review checklist (correctness, provider/model safety, reuse, tests, security) don't apply here.
  • Nice touch that the doc's own worked examples are verified anchors rather than illustrative placeholders — consistent with the discipline it's documenting.

No issues found. This PR is ready to merge on its own merits.

@Hmbown
Hmbown merged commit a59d91b into main Jul 26, 2026
23 checks passed
@Hmbown
Hmbown deleted the codex/harvest-4536-agent-ready branch July 26, 2026 06:52
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants