MPT-20397 simplify AGENTS entrypoint guidance

[d3rky]

🤖 AI-generated PR — Please review carefully.

Summary

• replace the unconditional AGENTS.md entrypoint wording with a task-based protocol
• make the repository reading order conditional on relevance to the current task
• remove the redundant "Start with AGENTS.md" step from the local guidance

Testing

• make build
• make check-all
• automatic pre-commit hooks on commit

Closes MPT-20397

• Simplified AGENTS.md entrypoint guidance by removing the unconditional instruction to start by reading AGENTS.md itself
• Made repository reading order conditional on task relevance, replacing "After you start with AGENTS.md..." phrasing with "When applicable" lead-in
• Reordered initial protocol steps to prioritize task type identification and selection of relevant local files before repository documentation review

[coderabbitai]

No actionable comments were generated in the recent review. 🎉

ℹ️ Recent review info

⚙️ Run configuration

Configuration used: Repository YAML (base), Organization UI (inherited)

Review profile: CHILL

Plan: Pro

Run ID: 409de918-4cda-4f21-b676-867fa98db89a

📥 Commits

Reviewing files that changed from the base of the PR and between da1e7f4 and 0527ef4.

📒 Files selected for processing (1)

• AGENTS.md

---

📝 Walkthrough

Walkthrough

Updated AGENTS.md task workflow by removing the self-referential instruction to start with AGENTS.md itself, renumbering initial steps to begin with task identification, and restructuring phrasing with a new "When applicable" lead-in while preserving the subsequent repository-read sequence. Documentation-only change with no code logic modifications.

Changes

Cohort / File(s)	Summary
Documentation task workflow AGENTS.md	Reorganized task workflow instructions by removing explicit self-referential read order, renumbering steps to start with task type identification, and restructuring phrasing while maintaining the preserved reading sequence (README.md, docs/architecture.md, and subsequent docs).

Estimated code review effort

🎯 1 (Trivial) | ⏱️ ~3 minutes

Possibly related PRs

• PR #43: Directly updates the AGENTS.md task workflow ordering and phrasing that is modified in this PR, sharing the same document changes.
• PR #44: Modifies .github/copilot-instructions.md to reference AGENTS.md, which is the document being updated in this PR.
• PR #46: Concurrently modifies AGENTS.md's documentation reading and workflow instructions in the same section as this PR.

🚥 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 required format MPT-20397.
Test Coverage Required	✅ Passed	PR modifies only AGENTS.md documentation file with no changes to Python code files in swo_playground/ or tests/ directories.
Single Commit Required	✅ Passed	The PR contains exactly one commit (0527ef4) with focused documentation-only changes to AGENTS.md file.

_{✏️ 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]

Quality Gate passed

Issues
0 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud