Skip to content

docs(#5307): add interface documentation sync rule to AGENTS.md#5308

Open
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/5307-interface-doc-sync-guidance
Open

docs(#5307): add interface documentation sync rule to AGENTS.md#5308
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/5307-interface-doc-sync-guidance

Conversation

@fullsend-ai-coder

Copy link
Copy Markdown
Contributor

Summary

  • Adds an Interface documentation sync rule to AGENTS.md under the Go code section
  • Instructs code agents to check docs/guides/dev/ for documentation that enumerates an interface's methods when extending a Go interface, and update the listing to include all current methods
  • Follows the existing pattern of explicit sync rules (mint files, dispatch workflows) rather than relying on agents to infer documentation dependencies

Related Issue

Closes #5307

Changes

  • AGENTS.md: Added a new Interface documentation paragraph after the existing Dispatch workflows sync rule, before the "When making changes to Go code" checklist

Testing

  • Change is documentation-only (no Go code, no tests to run)
  • Secret scan passed (scan-secrets --staged)
  • Manual verification: no trailing whitespace, file ends with newline, no merge conflict markers
  • Validation: on the next PR that extends a Go interface where documentation enumerates the interface's methods, the code agent includes the doc update in its initial commit

Checklist

  • Commit message follows COMMITS.md conventions (docs type, issue scope)
  • No breaking changes
  • No secrets or sensitive data

🤖 Generated with Claude Code


Closes #5307

Post-script verification

  • Branch is not main/master (agent/5307-interface-doc-sync-guidance)
  • Secret scan passed (gitleaks — 24d41836a2de6b7abaa6b20be2bdac9a61f7e0d3..HEAD)
  • PR body secret scan passed (gitleaks — no-git)
  • Pre-commit hooks passed (authoritative run on runner)
  • Tests ran inside sandbox

When code agents extend Go interfaces they do not check whether
docs/guides/dev/ enumerates the interface's methods, causing
avoidable stale-doc review findings and fix round-trips. Add an
explicit sync rule — following the existing pattern for mint files
and dispatch workflows — so agents know to update method listings
when adding interface methods.

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
@fullsend-ai-coder
fullsend-ai-coder Bot requested a review from a team as a code owner July 19, 2026 09:37
@fullsend-ai-coder fullsend-ai-coder Bot added the ready-for-review Agent PR ready for human review label Jul 19, 2026
@github-actions

Copy link
Copy Markdown

Site preview

Preview: https://6414d2ce-site.fullsend-ai.workers.dev

Commit: 56925870589134cce129b2de1ad81631bbb3236a

@codecov

codecov Bot commented Jul 19, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

ready-for-review Agent PR ready for human review

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Add AGENTS.md guidance: update interface documentation when extending Go interfaces

0 participants