Skip to content

Add repository AGENTS guidance#422

Draft
Marius Storhaug (MariusStorhaug) wants to merge 2 commits into
mainfrom
agents-guidance-standard
Draft

Add repository AGENTS guidance#422
Marius Storhaug (MariusStorhaug) wants to merge 2 commits into
mainfrom
agents-guidance-standard

Conversation

@MariusStorhaug

Copy link
Copy Markdown
Member

Summary

Adds a repository-level AGENTS.md that defines generic agent behavior and context discovery order.

Includes

  • Control-first handling of lint/security gates.
  • Generic context processing order (local repo -> project/framework -> central guidance).
  • Derive repo identity from Git metadata (no hardcoded host/owner assumptions).
  • Documentation standards for canonical repository URLs and cross-shell install/sync examples.

Scope

This PR intentionally contains only agent-guidance documentation.

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.

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