Skip to content

Commit 2b7a3c2

Browse files
⚙️ [Maintenance]: Repository agents follow canonical MSX guidance (#422)
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. --- <details> <summary>Technical details</summary> - Replaced the generic context-resolution and documentation-standard content in `AGENTS.md` with the thin-pointer structure defined by [MSXOrg Agentic Development](https://msxorg.github.io/docs/Ways-of-Working/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](https://msxorg.github.io/docs/Ways-of-Working/Agentic-Development/), [Agentic Development design](https://msxorg.github.io/docs/Capabilities/agentic-development/design/), [Maintain Workflow Guidance](https://msxorg.github.io/docs/Ways-of-Working/Workflow-Stages/Maintain-Guidance/) | Aligned | - Issue convergence sweep: limited to this PR's documentation-only scope; no additional open issues were fully satisfied by the diff. </details> <details> <summary>Relevant issues (or links)</summary> - [MSXOrg Agentic Development](https://msxorg.github.io/docs/Ways-of-Working/Agentic-Development/) - [MSXOrg PR Format](https://msxorg.github.io/docs/Ways-of-Working/PR-Format/) </details> --------- Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com>
1 parent 169c576 commit 2b7a3c2

1 file changed

Lines changed: 38 additions & 0 deletions

File tree

AGENTS.md

Lines changed: 38 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,38 @@
1+
# Agents
2+
3+
## Main directive
4+
5+
Everything is a work in progress and can be improved.
6+
If you find a problem or improvement, fix if small; otherwise open an issue.
7+
8+
## Repo guidance
9+
10+
- [`README.md`](README.md) — what this repository is and its purpose as the
11+
Process-PSModule framework.
12+
13+
## PSModule Framework guidance
14+
15+
Regarding repo structure, module source code, and how the Process-PSModule workflow
16+
works. For PSModule-specific build, layout, and process guidance:
17+
18+
- [Process-PSModule docs](https://psmodule.github.io/docs/Modules/Process-PSModule/)
19+
repository structure, module anatomy, and the build/test/pack/publish pipeline.
20+
- [Repository defaults](https://psmodule.github.io/docs/Modules/Repository-Defaults/)
21+
the expected repository layout and required files.
22+
- [Standards](https://psmodule.github.io/docs/Modules/Standards/) — PowerShell module
23+
coding standards.
24+
- [PSModule/memory](https://github.com/PSModule/memory) — durable cross-session agent
25+
working memory for the PSModule organization.
26+
27+
## Org-wide guidance
28+
29+
For cross-cutting ways of working and standards:
30+
31+
- [Agentic Development](https://msxorg.github.io/docs/Ways-of-Working/Agentic-Development/)
32+
how agents and humans collaborate in this ecosystem.
33+
- [Ways of Working](https://msxorg.github.io/docs/Ways-of-Working/) — contribution
34+
workflow, branching, PRs, issues.
35+
- [Coding Standards](https://msxorg.github.io/docs/Coding-Standards/) — language-level
36+
conventions.
37+
- [MSXOrg/memory](https://github.com/MSXOrg/memory) — durable agent working memory:
38+
gotchas, knowledge, and agent role notes.

0 commit comments

Comments
 (0)