Skip to content

馃摉 [Docs]: Central defaults and repository guidance are clearly separated - #195

Merged
Marius Storhaug (MariusStorhaug) merged 21 commits into
mainfrom
repository-governance
Aug 30, 2026
Merged

馃摉 [Docs]: Central defaults and repository guidance are clearly separated#195
Marius Storhaug (MariusStorhaug) merged 21 commits into
mainfrom
repository-governance

Conversation

@MariusStorhaug

@MariusStorhaug Marius Storhaug (MariusStorhaug) commented Aug 29, 2026

Copy link
Copy Markdown
Member

Community policies now have a clear organization-level default, while every repository keeps the local context and configuration needed to work safely.

Changed: Repository governance guidance

Each initiative uses a public .github repository for GitHub-inherited community defaults. Code of conduct, security, support, and pull request templates are required centrally; contribution guidance and issue templates remain optional defaults.

The design now separates three surfaces that coexist in the special repository: inherited community files, optional organization-profile content, and the repository's own local context. Repository ownership, dependency updates, release configuration, license terms, and client routes remain repository-specific.

Organization-wide Copilot instructions are configured through organization settings. The .github/copilot-instructions.md file in the defaults repository routes Copilot for that repository only.

The agentic-development model and bootstrap use organization documentation only; memory-repository guidance, templates, synchronization, and tests have been removed.


Technical details
  • Reviewed MSXOrg/.github at fc077b8c2f86a94be7dd00b009993b65e664aa8a and PSModule/.github at ee9fda9bace05d4a4ba8b3574782c1cc7da4ce5a as the structural references.
  • Added the shared defaults-repository structure and distribution behavior to the Repository Governance design.
  • Kept .github/CONTRIBUTING.md, .github/ISSUE_TEMPLATE/, profile/README.md, and media/ optional.
  • Defined the purpose-specific local baseline for the special .github repository: README.md, AGENTS.md, client routes, .gitattributes, and .gitignore.
  • Corrected the distinction between repository-level Copilot route files and organization-level Copilot settings.
  • Updated the Organization and Repository standards to use the same ownership boundaries.
  • Updated agentic-development design, specification, conformance, workflow maintenance guidance, and bootstrap documentation to remove the memory-repository model.
  • Removed the memory repository template and memory-boundary decision record, plus the repository Memory type and navigation entries.
  • Updated bootstrap implementation and tests for documentation-only context synchronization.
  • Standards and framework alignment: documentation structure, Markdown, agentic-development, repository, organization, and repository-governance standards checked; aligned.
  • Issue convergence sweep: no additional open issues were identified as fully satisfied by this change.
Relevant issues (or links)

Related work

  • No related issues.

@MariusStorhaug Marius Storhaug (MariusStorhaug) changed the title 馃摎 [Changed]: Centralize community file defaults 馃摉 [Docs]: Community defaults and repository guidance are clearly separated Aug 29, 2026
@MariusStorhaug
Marius Storhaug (MariusStorhaug) marked this pull request as ready for review August 29, 2026 11:23
@MariusStorhaug Marius Storhaug (MariusStorhaug) changed the title 馃摉 [Docs]: Community defaults and repository guidance are clearly separated 馃摉 [Docs]: Central defaults and repository guidance are clearly separated Aug 30, 2026
@MariusStorhaug
Marius Storhaug (MariusStorhaug) merged commit d527735 into main Aug 30, 2026
21 checks passed
@MariusStorhaug
Marius Storhaug (MariusStorhaug) deleted the repository-governance branch August 30, 2026 10:42
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant