Skip to content

docs: surface ADR rules in AGENTS.md and clarify PR status#1661

Open
ifireball wants to merge 1 commit into
fullsend-ai:mainfrom
ifireball:cursor/daac3fe8
Open

docs: surface ADR rules in AGENTS.md and clarify PR status#1661
ifireball wants to merge 1 commit into
fullsend-ai:mainfrom
ifireball:cursor/daac3fe8

Conversation

@ifireball
Copy link
Copy Markdown
Contributor

Summary

  • Add an Architecture Decision Records (ADRs) section to AGENTS.md so all agents see immutability, PR review, and review expectations without invoking the writing-adrs skill.
  • Update skills/writing-adrs/SKILL.md to treat merge as approval: new ADRs ready for review should default to Accepted, not Proposed, when the decision is made.

Closes #1648.

Test plan

  • Confirm AGENTS.md renders the new section and link to writing-adrs
  • Spot-check that a code/review agent run loads ADR immutability rules from AGENTS.md
  • make lint (ADR frontmatter unchanged; docs-only)

Made with Cursor

@ifireball ifireball self-assigned this May 28, 2026
@ifireball ifireball requested a review from ralphbean May 28, 2026 12:58
Agents load AGENTS.md by default but ADR immutability lived only in the
writing-adrs skill. Document core ADR conventions for all agents and align
the skill with merge-as-approval (default new ADRs to Accepted when ready).

Fixes fullsend-ai#1648

Co-authored-by: Cursor <cursoragent@cursor.com>
Signed-off-by: Barak Korren <bkorren@redhat.com>
Co-authored-by: Cursor <cursoragent@cursor.com>
@ifireball ifireball marked this pull request as ready for review May 28, 2026 12:59
@github-actions
Copy link
Copy Markdown

github-actions Bot commented May 28, 2026

Site preview

Preview: https://f5aeaa6c-site.fullsend-ai.workers.dev

Commit: 8de0cf2d5f4260aeb1e09d3938bc315862019bc5

@fullsend-ai-review
Copy link
Copy Markdown

Review

Findings

No findings.

@fullsend-ai-review fullsend-ai-review Bot added the ready-for-merge All reviewers approved — ready to merge label May 28, 2026
@ifireball ifireball added the requires-manual-review Review requires human judgment label May 28, 2026
@ifireball
Copy link
Copy Markdown
Contributor Author

/fs-retro review agent should not set ready-for-merge when changing repo rules like this

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

Labels

ready-for-merge All reviewers approved — ready to merge requires-manual-review Review requires human judgment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Review agent should flag in-place modifications to accepted/merged ADRs

2 participants