Agents

Author: MariusStorhaug

AGENTS.md

@@ -1,21 +1,18 @@
 # Agents
 
-This file is the onboarding entry point for agents working in this repository.
-It is a pointer file — guidance lives in the documentation, not here.
-
-## This repository
+## Main directive
 
-`Template-PSModule` is the canonical starting template for new PowerShell modules in the PSModule organization.
-It provides the CI/CD framework wiring, starter layout, and community files that every PSModule module repository begins with.
+Everything is a work in progress and can be improved.
+If you find a problem or improvement, fix if small; otherwise open an issue.
 
-Read in this order:
+## Repo guidance
 
-1. [`README.md`](README.md) — what this repository is and its purpose as a template.
-2. [`CONTRIBUTING.md`](CONTRIBUTING.md) — how to work on the template itself.
-3. [`.github/PSModule.yml`](.github/PSModule.yml) — framework configuration defaults.
+- [`README.md`](README.md) — what this repository is and its purpose as a template.
+- [`CONTRIBUTING.md`](CONTRIBUTING.md) — how to work on the template itself.
 
-## PSModule guidance
+## PSModule Framework guidance
 
+Regarding repo structure, module source code and how the Process-PSModule workflow works.
 For PSModule-specific build, layout, and process guidance:
 
 - [Template quickstart](https://psmodule.github.io/docs/Modules/Process-PSModule/template-quickstart/) — how to create a new module from this template.
@@ -31,8 +28,3 @@ For cross-cutting ways of working and standards:
 - [Agentic Development](https://msxorg.github.io/docs/Ways-of-Working/Agentic-Development/) — how agents and humans collaborate in this ecosystem.
 - [Ways of Working](https://msxorg.github.io/docs/Ways-of-Working/) — contribution workflow, branching, PRs, issues.
 - [Coding Standards](https://msxorg.github.io/docs/Coding-Standards/) — language-level conventions.
-
-## Main directive
-
-Everything is a work in progress and can be improved.
-If you find a problem, fix it if it is small; otherwise open an issue in the relevant repository.