From 8d99f54a8e33070e6e09cdb8b2a8506b560b47c2 Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Sun, 26 Jul 2026 11:57:28 +0200 Subject: [PATCH 1/2] Add repo AGENTS guidance standard Co-authored-by: Copilot App <223556219+Copilot@users.noreply.github.com> --- AGENTS.md | 35 +++++++++++++++++++++++++++++++++++ 1 file changed, 35 insertions(+) create mode 100644 AGENTS.md diff --git a/AGENTS.md b/AGENTS.md new file mode 100644 index 00000000..408274fa --- /dev/null +++ b/AGENTS.md @@ -0,0 +1,35 @@ +# Agents + +## Purpose + +Use this file to understand how agents should gather context and execute work in +this repository. + +## Core operating standard + +1. Treat repository controls (linters, security checks, policies) as correct by + default. +2. Align implementation with controls before considering exceptions. +3. If an exception is needed, make it explicit, minimal, and documented in code + and PR context. Never bypass controls silently. + +## Canonical context resolution + +Determine repository identity from Git metadata (for example, `origin` remote and +repository settings). Do not hardcode a specific owner or host unless the task +explicitly requires it. + +Process context in this order: + +| Order | Source | What to read first | Why | +| --- | --- | --- | --- | +| 1 | Local repository | `README.md`, `CONTRIBUTING.md`, local docs index/start page | Local behavior and contribution rules are authoritative for this repo. | +| 2 | Project/framework guidance | Framework or shared project docs referenced by this repo | Align with shared implementation patterns used by sibling repos. | +| 3 | Central organization guidance | Organization-level docs and standards | Apply global policy after local/project specifics are known. | + +## Documentation standards for commands and repos + +1. Use canonical repository URLs in docs (full URLs such as + `https://github.com/owner/repo`) instead of ambiguous short names. +2. For install and synchronization instructions, provide equivalent examples for + native shells on Windows, macOS, and Linux. From 559306866a6e9cb9f2d05affed95af5d108ba65e Mon Sep 17 00:00:00 2001 From: Marius Storhaug Date: Sun, 26 Jul 2026 20:02:27 +0200 Subject: [PATCH 2/2] Align AGENTS.md with MSXOrg thin-pointer framework 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> --- AGENTS.md | 51 +++++++++++++++++++++++++++------------------------ 1 file changed, 27 insertions(+), 24 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index 408274fa..44244354 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -1,35 +1,38 @@ # Agents -## Purpose +## Main directive -Use this file to understand how agents should gather context and execute work in -this repository. +Everything is a work in progress and can be improved. +If you find a problem or improvement, fix if small; otherwise open an issue. -## Core operating standard +## Repo guidance -1. Treat repository controls (linters, security checks, policies) as correct by - default. -2. Align implementation with controls before considering exceptions. -3. If an exception is needed, make it explicit, minimal, and documented in code - and PR context. Never bypass controls silently. +- [`README.md`](README.md) — what this repository is and its purpose as the + Process-PSModule framework. -## Canonical context resolution +## PSModule Framework guidance -Determine repository identity from Git metadata (for example, `origin` remote and -repository settings). Do not hardcode a specific owner or host unless the task -explicitly requires it. +Regarding repo structure, module source code, and how the Process-PSModule workflow +works. For PSModule-specific build, layout, and process guidance: -Process context in this order: +- [Process-PSModule docs](https://psmodule.github.io/docs/Modules/Process-PSModule/) — + repository structure, module anatomy, and the build/test/pack/publish pipeline. +- [Repository defaults](https://psmodule.github.io/docs/Modules/Repository-Defaults/) — + the expected repository layout and required files. +- [Standards](https://psmodule.github.io/docs/Modules/Standards/) — PowerShell module + coding standards. +- [PSModule/memory](https://github.com/PSModule/memory) — durable cross-session agent + working memory for the PSModule organization. -| Order | Source | What to read first | Why | -| --- | --- | --- | --- | -| 1 | Local repository | `README.md`, `CONTRIBUTING.md`, local docs index/start page | Local behavior and contribution rules are authoritative for this repo. | -| 2 | Project/framework guidance | Framework or shared project docs referenced by this repo | Align with shared implementation patterns used by sibling repos. | -| 3 | Central organization guidance | Organization-level docs and standards | Apply global policy after local/project specifics are known. | +## Org-wide guidance -## Documentation standards for commands and repos +For cross-cutting ways of working and standards: -1. Use canonical repository URLs in docs (full URLs such as - `https://github.com/owner/repo`) instead of ambiguous short names. -2. For install and synchronization instructions, provide equivalent examples for - native shells on Windows, macOS, and Linux. +- [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. +- [MSXOrg/memory](https://github.com/MSXOrg/memory) — durable agent working memory: + gotchas, knowledge, and agent role notes.