docs: tidy repository onboarding guidance

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

Author: MariusStorhaug

CONTRIBUTING.md

@@ -0,0 +1,21 @@
+# Contributing to PSModule/docs
+
+This repository is the source of truth for PSModule documentation.
+
+## Before you change docs
+
+- Read the relevant page in `src/docs/` first.
+- Keep changes small and scoped to one topic.
+- Prefer links to canonical docs over duplicating guidance.
+
+## Working in this repository
+
+- Use the current branch or worktree for the change.
+- Keep commit messages short and specific.
+- Open draft pull requests early for reviewable doc updates.
+
+## Review expectations
+
+- Make wording changes that improve clarity without widening scope.
+- Preserve the existing PSModule doc conventions and link patterns.
+- If a linked guide is missing, add it here in the repository instead of relying on inheritance.

src/docs/Modules/Repository-Defaults.md

@@ -54,7 +54,7 @@ Local work should use the organization worktree convention:
 - `main/` tracks the default branch.
 - Feature worktrees use `<type>-<slug>` directories and `<type>/<slug>` branches.
 
-For branch and worktree details, see [Git Worktrees](../../Ways-of-Working/Git-Worktrees.md).
+For branch and worktree details, see [Git Worktrees](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Git-Worktrees.md).
 
 ## Default repository layout
 
@@ -136,6 +136,22 @@ Every repository must be usable by an agent that has never seen it before, witho
 - `CLAUDE.md`: a thin file that imports `AGENTS.md` with `@AGENTS.md` so Claude Code reads the same instructions. Claude-specific notes, if any, go below the import.
 - `.github/copilot-instructions.md`: repository instructions for VS Code and GitHub Copilot that point to the same documentation.
 
+Copy-pasteable starters:
+
+```md
+# AGENTS
+
+Follow the canonical agent guidance in [PSModule/docs](https://github.com/PSModule/docs).
+```
+
+```md
+@AGENTS.md
+```
+
+```md
+Follow [AGENTS.md](../AGENTS.md).
+```
+
 These files are the agent equivalent of the README: pointers, not copies. Keep them short so the linked documentation stays the single source of truth. Like the other governance files, they live in the repository itself so it can stand on its own.
 
 ## Managed file distribution