Skip to content

[MPT-20397] simplify AGENTS entrypoint guidance#310

Merged
d3rky merged 1 commit intomainfrom
feature/MPT-20397/force-reading-documentation-rules-to-read-also-shared-repo
Apr 17, 2026
Merged

[MPT-20397] simplify AGENTS entrypoint guidance#310
d3rky merged 1 commit intomainfrom
feature/MPT-20397/force-reading-documentation-rules-to-read-also-shared-repo

Conversation

@d3rky
Copy link
Copy Markdown
Contributor

@d3rky d3rky commented Apr 17, 2026

Summary

  • adapt the AGENTS entrypoint guidance to a task-based working protocol
  • make the repository documentation reading order conditional on task relevance
  • keep the local repository guidance focused on selecting only relevant files before changes

Testing

  • not run (documentation-only change)

Closes MPT-20397

Source inspiration: softwareone-platform/swo-extension-playground#47

Closes MPT-20397

  • Simplify AGENTS entrypoint guidance with a task-based working protocol
  • Add "Working protocol for any task" section with ordered steps for selecting relevant local files, reading shared standards when applicable, and applying precedence rules
  • Make documentation reading order conditional on task relevance
  • Extend documentation sequence with additional guides (local-development.md, testing.md, contributing.md, documentation.md)

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 17, 2026

Caution

Review failed

Pull request was closed or merged during review

📝 Walkthrough

Walkthrough

Updated AGENTS.md with guidance for repository workflow management: introduced a "Working protocol for any task" section with ordered steps for file selection and documentation reading, and extended the "Documentation Reading Order" section with additional referenced documents. No code or API changes.

Changes

Cohort / File(s) Summary
Documentation Guidance
AGENTS.md
Added "Working protocol for any task" section with explicit ordered steps for selecting files and reading standards. Extended "Documentation Reading Order" section with additional documents including docs/local-development.md, docs/testing.md, docs/contributing.md, and docs/documentation.md.

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~2 minutes

Possibly related PRs

  • PR #254: Modifies AGENTS.md with repository documentation reading order and workflow expansion.
  • PR #299: Updates AGENTS.md and repository documentation reading/order guidance with direct edits to the same documentation content.
🚥 Pre-merge checks | ✅ 3
✅ Passed checks (3 passed)
Check name Status Explanation
Jira Issue Key In Title ✅ Passed The PR title contains exactly one Jira issue key in the correct format MPT-20397.
Test Coverage Required ✅ Passed PR modifies only AGENTS.md, a documentation file, not code files. No test coverage requirement applies.
Single Commit Required ✅ Passed The PR contains exactly one commit (0b9d309 doc: MPT-20397 simplify AGENTS entrypoint guidance), verified by counting commits ahead of main branch.

✏️ Tip: You can configure your own custom pre-merge checks in the settings.


Comment @coderabbitai help to get the list of available commands and usage tips.

@sonarqubecloud
Copy link
Copy Markdown

@d3rky d3rky marked this pull request as ready for review April 17, 2026 15:11
@d3rky d3rky requested a review from a team as a code owner April 17, 2026 15:11
@d3rky d3rky requested review from jentyk and ruben-sebrango April 17, 2026 15:11
@d3rky d3rky merged commit cff2bb2 into main Apr 17, 2026
3 of 4 checks passed
@d3rky d3rky deleted the feature/MPT-20397/force-reading-documentation-rules-to-read-also-shared-repo branch April 17, 2026 15:14
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.

1 participant