Skip to content

⚙️ [Maintenance]: Repository agents follow canonical MSX guidance - #422

Merged
Marius Storhaug (MariusStorhaug) merged 3 commits into
mainfrom
agents-guidance-standard
Aug 8, 2026
Merged

⚙️ [Maintenance]: Repository agents follow canonical MSX guidance#422
Marius Storhaug (MariusStorhaug) merged 3 commits into
mainfrom
agents-guidance-standard

Conversation

@MariusStorhaug

@MariusStorhaug Marius Storhaug (MariusStorhaug) commented Jul 26, 2026

Copy link
Copy Markdown
Member

Repository agents now follow the canonical MSXOrg and PSModule guidance for discovering repository context, framework documentation, and durable memory without duplicating reusable process knowledge.

Changed: Agent guidance follows the shared pointer model

The repository-level AGENTS.md now points contributors and agents to the repository README, PSModule framework documentation, PSModule memory, and MSXOrg-wide ways of working and coding standards. This keeps shared process knowledge maintained in the canonical documentation while retaining repository-specific context in the repository.


Technical details
  • Replaced the generic context-resolution and documentation-standard content in AGENTS.md with the thin-pointer structure defined by MSXOrg Agentic Development.
  • Matched the established guidance pattern used by PSModule/Template-PSModule, PSModule/docs, and PSModule/memory.
  • This is an agent/configuration-only change; no shipped module behavior is changed.
  • Standards and framework alignment:
Changed surface Standards checked Framework docs checked Result
AGENTS.md Agentic Development pointer discipline; PR format Agentic Development, Agentic Development design, Maintain Workflow Guidance Aligned
  • Issue convergence sweep: limited to this PR's documentation-only scope; no additional open issues were fully satisfied by the diff.
Relevant issues (or links)

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
Replace the generic control/context-resolution guidance with the concrete
thin-pointer pattern documented in MSXOrg/docs (Agentic Development design)
and already adopted by PSModule/Template-PSModule, PSModule/docs, and
PSModule/memory: point to repo docs, PSModule framework docs, PSModule/memory,
and MSXOrg org-wide guidance instead of restating process knowledge locally.

Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
@MariusStorhaug

Copy link
Copy Markdown
Member Author

Reviewed against MSXOrg's Agentic Development framework (design.md / spec.md) and the pattern already used by \PSModule/Template-PSModule, \PSModule/docs, and \PSModule/memory.

The original \AGENTS.md\ restated process knowledge (control-handling rules, a generic context-resolution table, doc-authoring standards) instead of acting as a thin pointer. Per the framework, a repo's \AGENTS.md\ MUST NOT duplicate standards or process — it should point to the canonical docs/memory roots and add only repo-specific nuance.

Replaced it with the established PSModule pattern: repo guidance -> PSModule framework docs (Process-PSModule pipeline docs, repository defaults, standards, PSModule/memory) -> org-wide guidance (Agentic Development, Ways of Working, Coding Standards, MSXOrg/memory), mirroring \Template-PSModule/AGENTS.md.

@MariusStorhaug
Marius Storhaug (MariusStorhaug) marked this pull request as ready for review August 8, 2026 15:30
@MariusStorhaug Marius Storhaug (MariusStorhaug) changed the title Add repository AGENTS guidance ⚙️ [Maintenance]: Repository agents follow canonical MSX guidance Aug 8, 2026
@MariusStorhaug
Marius Storhaug (MariusStorhaug) merged commit 2b7a3c2 into main Aug 8, 2026
18 checks passed
@MariusStorhaug
Marius Storhaug (MariusStorhaug) deleted the agents-guidance-standard branch August 8, 2026 15:40
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