Skip to content

Agents fill in the PR template and the issue forms, which gh and the API skip - #457

Open
v0lumehi wants to merge 1 commit into
seedds:mainfrom
v0lumehi:agent-templates
Open

v0lumehi wants to merge 1 commit into
seedds:mainfrom
v0lumehi:agent-templates

Conversation

@v0lumehi

Copy link
Copy Markdown
Contributor

What and why

The PR template and the issue forms (#306) only appear on GitHub's web pages. gh pr create, gh issue create and the API open a PR or an issue with whatever body they're given. An agent never sees them, and nothing told it to follow them. So PRs and issues opened by agents (mine included) came in with their own structure, without the Checked and Docs sections or the bug form's commit, chain version and device.

  • docs/agents/06-dev-loop.md, new section 8, "Opening an issue or a pull request":
    • a PR body keeps the template's three sections (What and why, Checked, Docs with its checkboxes);
    • an issue keeps the matching form's fields as headings in their order (for a bug: commit and chain version, game with title ID and version, how it was built and run, device and OS, overrides, the whole log, the form's confirmations);
    • nothing from a game goes in either.
  • AGENTS.md's task table points there ("Checking a change, opening a PR or issue"). It stays at exactly 1,500 words.
  • CONTRIBUTING.md says the same for people who open them from the command line.

This PR's own text follows the template, as the new section asks.

Checked

  • Tests: python3 -m unittest dm/tools/tests/test_docs.py (links, the new anchor, the word limits): OK.
  • Games run: none, docs only.
  • Devices and OS: not applicable.

Docs

  • The finding is in its game note or its docs/reference/<subsystem>.md entry, and python3 dm/tools/docs_symptoms.py was run (the symptom index): not applicable, no finding.
  • A chain tool changed: not applicable.
  • No game files, keys or data extracted from a game in the change or the attachments

v0lumehi added a commit to v0lumehi/NX2Apple that referenced this pull request Oct 27, 2026
…late the sync test

The build form's step list follows the build's stages (issue 98 picked the key check for a Pipeline archive failure). The PR template names test_sync_patchers.py.

No AGENTS.md patcher: the open upstream PR seedds/nxnative#457 adds the pointer to upstream's AGENTS.md (a row 'Checking a change, opening a PR or issue' -> docs/agents/06-dev-loop.md, whose new section 8 tells agents to write the fields of the forms in .github/ISSUE_TEMPLATE/ and the PR template's sections). Once it lands and the fork syncs it, it points agents at the fork's own forms and CONTRIBUTING.md without a fork patch. Until then CLAUDE.md and CONTRIBUTING.md cover it.
@v0lumehi
v0lumehi force-pushed the agent-templates branch 2 times, most recently from 4584e8f to 21b2685 Compare October 28, 2026 09:01
v0lumehi added a commit to v0lumehi/NX2Apple that referenced this pull request Oct 28, 2026
…late the sync test

The build form's step list follows the build's stages (issue 98 picked the key check for a Pipeline archive failure). The PR template names test_sync_patchers.py.

No AGENTS.md patcher: the open upstream PR seedds/nxnative#457 adds the pointer to upstream's AGENTS.md (a row 'Checking a change, opening a PR or issue' -> docs/agents/06-dev-loop.md, whose new section 8 tells agents to write the fields of the forms in .github/ISSUE_TEMPLATE/ and the PR template's sections). Once it lands and the fork syncs it, it points agents at the fork's own forms and CONTRIBUTING.md without a fork patch. Until then CLAUDE.md and CONTRIBUTING.md cover it.
@v0lumehi
v0lumehi force-pushed the agent-templates branch 4 times, most recently from 3deaa01 to a312cc1 Compare October 29, 2026 20:53
…API skip

The pull request template and the issue forms from seedds#306 only appear on
GitHub's web pages. gh pr create, gh issue create and the API open a PR or
an issue with whatever body they are given, so an agent never sees them and
nothing told it to follow them: PRs and issues opened by agents came in
with their own structure, without the Checked and Docs sections or the bug
form's commit, chain version and device.

06-dev-loop.md gets a section 8, "Opening an issue or a pull request": a PR
body keeps the template's three sections (What and why, Checked, Docs with
its checkboxes), an issue the matching form's fields as headings in their
order, and nothing from a game in either. AGENTS.md's task table points
there (AGENTS.md stays at its 1,500 words), and CONTRIBUTING.md says the
same for people who open them from the command line.

Checked: test_docs passes (links, anchors, word limits).
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

docs Documentation

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant