diff --git a/.github/CONTRIBUTING.md b/.github/CONTRIBUTING.md index 0646afb..de22957 100644 --- a/.github/CONTRIBUTING.md +++ b/.github/CONTRIBUTING.md @@ -1,38 +1,8 @@ # Contributing -The affected repository's README and repository-local contribution guidance -define its build, test, and validation steps. Follow those local instructions -before this organization-wide fallback. +Follow the central [MSX contribution workflow](https://msx.no/docs/Ways-of-Working/Contribution-Workflow/) +and [MSX Ways of Working](https://msx.no/docs/Ways-of-Working/) for shared +contribution guidance. -## Before making a change - -- Review the repository's open issues and use the MSX - [issue process](https://msx.no/docs/Ways-of-Working/Issues/) to propose or - claim substantial work. -- Read the repository's code of conduct and applicable PSModule and MSX - standards. -- Keep each change focused on one deliverable. - -## Agent plugins - -The [MSX agent plugin marketplace](https://github.com/MSXOrg/docs/tree/main/.github/plugin) -provides shared standards and workflow skills. The -[PSModule process plugin](https://github.com/PSModule/Process-PSModule/tree/main/.github/plugin) -provides initiative-specific guidance for Process-PSModule repositories. - -## Submit the change - -1. Create a short-lived branch from the repository's default branch. -2. Make the smallest complete change and run the repository's relevant checks. -3. Open a draft pull request and follow the MSX - [PR Format](https://msx.no/docs/Ways-of-Working/PR-Format/). -4. Self-review the diff, request Copilot review explicitly, and address - in-scope feedback. -5. Mark the pull request ready only after it satisfies the repository's review - gate. - -The canonical -[Contribution Workflow](https://msx.no/docs/Ways-of-Working/Contribution-Workflow/) -defines the complete delivery loop. Use the MSX -[Review Etiquette](https://msx.no/docs/Ways-of-Working/Review-Etiquette/) when -giving or responding to feedback. +For framework-specific guidance, review the +[Process-PSModule documentation](https://psmodule.io/Process-PSModule/). diff --git a/AGENTS.md b/AGENTS.md index 3e926ad..2ad53dc 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -4,8 +4,3 @@ Read in this order: 1. `README.md` — what this repository provides and how its defaults are enforced. 2. `.github/CONTRIBUTING.md` — how a change is made and reviewed. -3. [PSModule/Process-PSModule](https://github.com/PSModule/Process-PSModule/) — PSModule process and standards. -4. [MSXOrg/docs](https://github.com/MSXOrg/docs/) — the organization standards. - -Clone each linked repository locally, keep its configuration local to that -clone, and update it before reading it. diff --git a/README.md b/README.md index f8904c8..0e884f9 100644 --- a/README.md +++ b/README.md @@ -1,6 +1,5 @@ # PSModule community defaults -`PSModule/.github` is GitHub's special public repository for organization-wide -community defaults. GitHub uses these files when a PSModule repository does not -define its own corresponding file. This repository must remain public for the -fallback behavior to work. +`PSModule/.github` is GitHub's special public organization-defaults repository. +GitHub uses its community files when a PSModule repository does not define its +own corresponding file.