Skip to content

docs(#6781): promote forge-abstraction to explicit AGENTS.md bullet - #6783

Open
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/6781-promote-forge-abstraction-bullet
Open

docs(#6781): promote forge-abstraction to explicit AGENTS.md bullet#6783
fullsend-ai-coder[bot] wants to merge 1 commit into
mainfrom
agent/6781-promote-forge-abstraction-bullet

Conversation

@fullsend-ai-coder

Copy link
Copy Markdown
Contributor

Summary

Adds a top-level bullet point for the forge-abstraction rule in the "How to work in this repo" section of AGENTS.md. The rule was previously listed only in the topic-guidance table, which required agents to infer that operations like setting repository variables are forge operations. This promotion mirrors the pattern used for other critical rules (DCO, coverage gate, CLI docs) and makes the architectural invariant — all forge operations must go through forge.Client — harder to miss.

Changes

  • Added a Forge abstraction bullet after the Go coverage gate bullet and before the secrets bullet
  • The new bullet explains the rule, names examples (GitHub API calls, setting repository variables, PR comments), and links to docs/contributing/forge-abstraction.md for full details

Testing

  • lychee link checker passes on AGENTS.md
  • Structural grep confirms forge.Client and forge-abstraction.md are present in AGENTS.md
  • No trailing whitespace or end-of-file issues
  • gitlint passes on commit message

Checklist


Closes #6781

Post-script verification

  • Branch is not main/master (agent/6781-promote-forge-abstraction-bullet)
  • Secret scan passed (gitleaks — e90aca92240c9d478677c6c5cc70e0a9b0edb95a..HEAD)
  • PR body secret scan passed (gitleaks — no-git)

Add a top-level bullet point in the "How to work in this repo" section
for the forge-abstraction rule, placed after the Go coverage gate and
before the secrets bullet. The rule was previously discoverable only
via the topic-guidance table, which required agents to recognize that
setting repository variables is a forge operation — a connection the
code agent on PR #6779 failed to make. Promoting it to an inline
bullet mirrors the pattern used for other critical rules (DCO,
coverage gate, CLI docs) and makes the architectural invariant harder
to miss for both code and review agents.

Closes #6781
@fullsend-ai-coder
fullsend-ai-coder Bot requested a review from a team as a code owner August 30, 2026 18:28
@fullsend-ai-coder fullsend-ai-coder Bot added the ready-for-review Agent PR ready for human review label Aug 30, 2026
@fullsend-ai-review

fullsend-ai-review Bot commented Aug 30, 2026

Copy link
Copy Markdown

🤖 Finished Review · ✅ Success · Started 6:30 PM UTC · Completed 6:41 PM UTC

Commit: 2e6c223 · View workflow run →

Runtime: claude · Model: opus → claude-opus-4-6 · Effort: high · Cost: $2.85

@codecov

codecov Bot commented Aug 30, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@fullsend-ai-review fullsend-ai-review Bot added the risk/low PR risk: low label Aug 30, 2026
@fullsend-ai-review

Copy link
Copy Markdown

Risk Assessment: low (1/5)

Details

Docs-only 1-line addition to AGENTS.md by a bot author with no security-sensitive files, no CI changes, and no dependency changes. The change is trivially small and easily revertible.

@fullsend-ai-review

Copy link
Copy Markdown

Review

Findings

Medium

  • [protected-path] AGENTS.md — This PR modifies AGENTS.md, which is a protected governance file. The change is well-justified (linked to Promote forge-abstraction to explicit AGENTS.md bullet point #6781, which explains the rationale for promoting the forge-abstraction rule to a top-level bullet, mirroring the existing pattern for DCO, coverage gate, and CLI docs rules). Human approval is always required for protected-path changes, regardless of context.

@fullsend-ai-review fullsend-ai-review Bot added the requires-manual-review Review requires human judgment label Aug 30, 2026
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 requires-manual-review Review requires human judgment risk/low PR risk: low

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Promote forge-abstraction to explicit AGENTS.md bullet point

0 participants