📖 [Docs]: Community defaults aligned with MSX baseline

[Marius Storhaug (MariusStorhaug)]

PSModule repositories receive consistent organization-wide community guidance while repository-local files remain the authoritative enforcement surface and the public PSModule profile stays intact.

Changed: Organization-wide community guidance

The code of conduct uses the complete Contributor Covenant 3.0 text and routes private conduct reports to support@psmodule.io. Private support matters use the same support mailbox. Contribution guidance links to the shared MSX agent plugin marketplace and the PSModule process plugin.

Changed: Security concerns use a private route

Vulnerabilities, accidentally exposed sensitive information, exposed credentials, exposed secrets, and weak or unsafe security controls are reported through the affected repository's private vulnerability reporting or, when unavailable, security@psmodule.io.

Changed: Agent context is repository-addressable

The agent router leads with precedence and freshness, identifies PSModule/Process-PSModule, private PSModule/memory, and inherited MSXOrg/docs, links documentation entry points, and names organization-specific local clone roots without prescribing an access tool.

Changed: Repository governance

The special public .github repository aligns its ownership, dependency, pull-request, text-normalization, ignore, and agent-routing baseline with MSXOrg/.github#2. Public prose is evergreen, declarative, and written in simple en-US.

---

Technical details

• Implementation plan progress: all implementation and validation steps in Align community defaults with the MSX baseline #74 are complete.
• Validation: Markdown reports zero issues; YAML parses and lints; required shared files are present; placeholders and obsolete contacts are absent; external links resolve; GitHub confirms public visibility, recognized community files, and zero CODEOWNERS errors.
• The code of conduct preserves the upstream Contributor Covenant 3.0 content after replacing its reporting placeholder with support@psmodule.io, removing its authoring note, and normalizing section spacing to one empty line.
• The root LICENSE is intentionally absent by maintainer direction. This is an explicit exception to the generic Repository Standard baseline; the Contributor Covenant retains its file-specific CC BY-SA 4.0 attribution.
• Shared baseline files match 📖 [Docs]: Organization-wide community defaults established MSXOrg/.github#2. Organization-specific differences are limited to the PSModule name, support/security domains, agent routes, public profile, and existing optional issue, funding, release, and media surfaces.
• @MariusStorhaug replaces the previous CODEOWNERS team because GitHub reports @PSModule/module-maintainers as invalid: the team has pull permission rather than the required write access.
• Align agent context paths with organization repositories MSXOrg/docs#191 tracks the canonical Agentic Development and bootstrap migration to repository-addressable organization roots.
• Standards alignment:

Changed surface	Standards checked	Framework docs checked	Result
Repository baseline	Repository Standard, Organization Standard, Natural Language, Markdown, YAML	Agentic Development client behavior	Exception — root license omitted by maintainer direction; clone-path migration tracked in MSXOrg/docs#191
Community health defaults	Contribution Workflow, Issues, PR Format, Review Etiquette	GitHub default community health file behavior, Contributor Covenant 3.0, MSX and PSModule plugin marketplaces	Aligned

• Issue convergence sweep: the branch is scoped only to Align community defaults with the MSX baseline #74; no additional issue is fully delivered.

Relevant issues (or links)

• Resolves Align community defaults with the MSX baseline #74

Related work

• References 📖 [Docs]: Organization-wide community defaults established MSXOrg/.github#2
• References Align agent context paths with organization repositories MSXOrg/docs#191

[Copilot]

Pull request overview

Aligns the PSModule public .github repository’s governance and community-health defaults with the current MSX baseline, while preserving repository-local enforcement as the authoritative surface for downstream repos.

Changes:

• Added/updated repository governance baseline files (license, agents routing, text normalization, ignore rules, Dependabot baseline).
• Updated community guidance documents (contributing, security, support, code of conduct) and streamlined the PR template.
• Clarified README positioning of defaults vs. repository-local enforcement and documented licensing split.

Reviewed changes

Copilot reviewed 13 out of 14 changed files in this pull request and generated 3 comments.

Show a summary per file

File	Description
README.md	Clarifies fallback behavior and adds explicit licensing notes.
LICENSE	Introduces MIT licensing for the repository.
AGENTS.md	Adds agent routing/read-order instructions for contributors/agents.
.gitignore	Updates ignore defaults for OS/editor artifacts and outputs/build folders.
.github/SUPPORT.md	Aligns support guidance and sensitive-report routing.
.github/SECURITY.md	Aligns security reporting guidance and contact channel.
.github/pull_request_template.md	Reworks PR template into a minimal, MSX-aligned structure.
.github/dependabot.yml	Normalizes Dependabot config formatting and labels.
.github/copilot-instructions.md	Points Copilot to the agent instruction entrypoint.
.github/CONTRIBUTING.md	Replaces prior guide with MSX-aligned contribution workflow guidance.
.github/CODEOWNERS	Updates ownership routing for PR reviews.
.github/CODE_OF_CONDUCT.md	Reformats/aligns Code of Conduct and reporting contact.
.gitattributes	Standardizes text normalization and binary handling for common assets.
.claude/CLAUDE.md	Routes Claude configuration to the shared agent instructions.

Suppressed comments (1)

.github/CODE_OF_CONDUCT.md:41

• Punctuation is inconsistent with the surrounding list items (period is outside the bold span here, but inside it elsewhere). Consider keeping the period inside the bold text for consistent formatting.

3. **Promotional materials**. Sharing marketing or other commercial content in a way that is outside the norms of the community.

---

💡 Add a code-review agent skill or configure MCP servers for context-aware, tailored reviews. Learn more in the docs.

[Copilot]

Pull request overview

Copilot reviewed 13 out of 14 changed files in this pull request and generated no new comments.

[Copilot]

Pull request overview

Copilot reviewed 13 out of 14 changed files in this pull request and generated no new comments.

[Copilot]

Pull request overview

Copilot reviewed 12 out of 13 changed files in this pull request and generated no new comments.

[Copilot]

Pull request overview

Copilot reviewed 12 out of 13 changed files in this pull request and generated no new comments.

Suppressed comments (2)

Previously missed (1) — in code that hasn't changed since the last review.

.github/CODE_OF_CONDUCT.md:29

• This line uses a curly apostrophe (’), while nearby text in the same document uses straight ASCII apostrophes (e.g., "someone's" on line 31). Mixing quote styles can cause noisy diffs and copy/paste/search inconsistencies; prefer a straight apostrophe for consistency.

This issue also appears on line 83 of the same file.

3. **Stereotyping or discrimination.** Characterizing anyone’s personality or behavior on the basis of immutable identities or traits.

.github/CODE_OF_CONDUCT.md:83

• This sentence uses a curly apostrophe (’), but the rest of the file primarily uses straight ASCII apostrophes. Standardizing to a straight apostrophe avoids inconsistent typography and makes the text easier to search and copy.

For answers to common questions about Contributor Covenant, see the FAQ at [https://www.contributor-covenant.org/faq](https://www.contributor-covenant.org/faq). Translations are provided at [https://www.contributor-covenant.org/translations](https://www.contributor-covenant.org/translations). Additional enforcement and community guideline resources can be found at [https://www.contributor-covenant.org/resources](https://www.contributor-covenant.org/resources). The enforcement ladder was inspired by the work of [Mozilla’s code of conduct team](https://github.com/mozilla/inclusion).