diff --git a/.github/plugin/README.md b/.github/plugin/README.md new file mode 100644 index 0000000..bb7499d --- /dev/null +++ b/.github/plugin/README.md @@ -0,0 +1,49 @@ +# Agent plugin marketplaces + +This repository publishes the shared `msxorg` marketplace for plugins that +route Copilot to MSXOrg-wide standards. Initiative repositories publish their +own marketplaces for plugins that describe initiative-specific processes, +workflows, or tools. Keep an initiative plugin in its owning repository rather +than copying it into this marketplace. + +## Layout + +The marketplace manifest is `.github/plugin/marketplace.json`. Each entry +points to a plugin directory alongside the manifest: + +```text +.github/plugin/marketplace.json +.github/plugin//plugin.json +.github/plugin//skills/ + /SKILL.md +``` + +The `source` value is repository-root-relative: use +`.github/plugin/` in the marketplace entry. It must resolve to the +corresponding directory. Every plugin directory must contain `plugin.json`; its +`skills` directory contains the skills advertised by the manifest. + +## Skill granularity + +Each skill is a single pointer to one canonical document. The shared `msx` +plugin uses `msx-coding-*` skills for each coding language or tool, +`msx-documentation-*` skills for each documentation artifact type, and +`msx-ways-of-working-*` skills for each child listed by the Ways of Working +index. Skill bodies do not copy the documentation; they identify the one page +to read. + +## Versions + +Keep the plugin version in `plugin.json` synchronized with the version of its +entry in `marketplace.json`. Increment both together when the plugin changes. +The marketplace metadata version describes the marketplace itself and is +managed independently. + +## Ownership + +Use this shared marketplace for guidance that applies across MSX +organizations, repositories, and initiatives, such as `msx`. Use an +initiative-owned marketplace for guidance that depends on one initiative's +process or implementation. Consumers should install both marketplaces when +they need shared standards and initiative-specific guidance; neither replaces +the other. diff --git a/.github/plugin/marketplace.json b/.github/plugin/marketplace.json index 56edf56..a3bd69c 100644 --- a/.github/plugin/marketplace.json +++ b/.github/plugin/marketplace.json @@ -9,10 +9,10 @@ }, "plugins": [ { - "name": "msx-standards", + "name": "msx", "description": "Routes coding, documentation, and work lifecycle tasks to current MSX standards.", "version": "0.1.0", - "source": "plugins/msx-standards" + "source": ".github/plugin/msx" } ] } diff --git a/plugins/msx-standards/plugin.json b/.github/plugin/msx/plugin.json similarity index 94% rename from plugins/msx-standards/plugin.json rename to .github/plugin/msx/plugin.json index 2575385..f6f3fa7 100644 --- a/plugins/msx-standards/plugin.json +++ b/.github/plugin/msx/plugin.json @@ -1,6 +1,6 @@ { "$schema": "https://agent-plugins.org/schemas/1.0.0/plugin.schema.json", - "name": "msx-standards", + "name": "msx", "version": "0.1.0", "description": "Routes coding, documentation, and work lifecycle tasks to current MSX standards.", "author": { diff --git a/.github/plugin/msx/skills/msx-coding-github-actions/SKILL.md b/.github/plugin/msx/skills/msx-coding-github-actions/SKILL.md new file mode 100644 index 0000000..9a81464 --- /dev/null +++ b/.github/plugin/msx/skills/msx-coding-github-actions/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-coding-github-actions +description: Apply the MSX GitHub Actions coding standard when writing or reviewing workflows. +--- + +# Apply the MSX GitHub Actions coding standard + +Read and follow the [GitHub Actions coding standard](https://github.com/MSXOrg/docs/blob/main/src/docs/Coding-Standards/GitHub-Actions.md). diff --git a/.github/plugin/msx/skills/msx-coding-powershell/SKILL.md b/.github/plugin/msx/skills/msx-coding-powershell/SKILL.md new file mode 100644 index 0000000..5e93988 --- /dev/null +++ b/.github/plugin/msx/skills/msx-coding-powershell/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-coding-powershell +description: Apply the MSX PowerShell coding standard when writing or reviewing PowerShell. +--- + +# Apply the MSX PowerShell coding standard + +Read and follow the [PowerShell coding standard](https://github.com/MSXOrg/docs/blob/main/src/docs/Coding-Standards/PowerShell/index.md). diff --git a/.github/plugin/msx/skills/msx-coding-terraform/SKILL.md b/.github/plugin/msx/skills/msx-coding-terraform/SKILL.md new file mode 100644 index 0000000..38da6eb --- /dev/null +++ b/.github/plugin/msx/skills/msx-coding-terraform/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-coding-terraform +description: Apply the MSX Terraform coding standard when writing or reviewing Terraform. +--- + +# Apply the MSX Terraform coding standard + +Read and follow the [Terraform coding standard](https://github.com/MSXOrg/docs/blob/main/src/docs/Coding-Standards/Terraform.md). diff --git a/.github/plugin/msx/skills/msx-coding-typescript/SKILL.md b/.github/plugin/msx/skills/msx-coding-typescript/SKILL.md new file mode 100644 index 0000000..a51817d --- /dev/null +++ b/.github/plugin/msx/skills/msx-coding-typescript/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-coding-typescript +description: Apply the MSX TypeScript coding standard when writing or reviewing TypeScript. +--- + +# Apply the MSX TypeScript coding standard + +Read and follow the [TypeScript coding standard](https://github.com/MSXOrg/docs/blob/main/src/docs/Coding-Standards/TypeScript.md). diff --git a/.github/plugin/msx/skills/msx-coding-yaml/SKILL.md b/.github/plugin/msx/skills/msx-coding-yaml/SKILL.md new file mode 100644 index 0000000..8ef5757 --- /dev/null +++ b/.github/plugin/msx/skills/msx-coding-yaml/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-coding-yaml +description: Apply the MSX YAML coding standard when writing or reviewing YAML. +--- + +# Apply the MSX YAML coding standard + +Read and follow the [YAML coding standard](https://github.com/MSXOrg/docs/blob/main/src/docs/Coding-Standards/YAML.md). diff --git a/.github/plugin/msx/skills/msx-documentation-decision-record/SKILL.md b/.github/plugin/msx/skills/msx-documentation-decision-record/SKILL.md new file mode 100644 index 0000000..e4bb122 --- /dev/null +++ b/.github/plugin/msx/skills/msx-documentation-decision-record/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-documentation-decision-record +description: Record an MSX one-way-door decision using the canonical documentation template. +--- + +# Record an MSX decision + +Read and follow the [decision record template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#decision-record). diff --git a/.github/plugin/msx/skills/msx-documentation-decisions-register/SKILL.md b/.github/plugin/msx/skills/msx-documentation-decisions-register/SKILL.md new file mode 100644 index 0000000..fc854ec --- /dev/null +++ b/.github/plugin/msx/skills/msx-documentation-decisions-register/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-documentation-decisions-register +description: Maintain an MSX decisions register using the canonical documentation template. +--- + +# Maintain an MSX decisions register + +Read and follow the [decisions register template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#decisions-register). diff --git a/.github/plugin/msx/skills/msx-documentation-design/SKILL.md b/.github/plugin/msx/skills/msx-documentation-design/SKILL.md new file mode 100644 index 0000000..be694b4 --- /dev/null +++ b/.github/plugin/msx/skills/msx-documentation-design/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-documentation-design +description: Write an MSX capability design using the canonical documentation template. +--- + +# Write an MSX design + +Read and follow the [design template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#design). diff --git a/.github/plugin/msx/skills/msx-documentation-feature-addendum/SKILL.md b/.github/plugin/msx/skills/msx-documentation-feature-addendum/SKILL.md new file mode 100644 index 0000000..85c7ae4 --- /dev/null +++ b/.github/plugin/msx/skills/msx-documentation-feature-addendum/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-documentation-feature-addendum +description: Write an MSX feature addendum using the canonical documentation template. +--- + +# Write an MSX feature addendum + +Read and follow the [feature addendum template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#feature-addendum). diff --git a/.github/plugin/msx/skills/msx-documentation-guide/SKILL.md b/.github/plugin/msx/skills/msx-documentation-guide/SKILL.md new file mode 100644 index 0000000..bb07d0d --- /dev/null +++ b/.github/plugin/msx/skills/msx-documentation-guide/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-documentation-guide +description: Write an MSX task guide using the canonical documentation template. +--- + +# Write an MSX guide + +Read and follow the [guide template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#guide). diff --git a/.github/plugin/msx/skills/msx-documentation-implementation/SKILL.md b/.github/plugin/msx/skills/msx-documentation-implementation/SKILL.md new file mode 100644 index 0000000..184b2e0 --- /dev/null +++ b/.github/plugin/msx/skills/msx-documentation-implementation/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-documentation-implementation +description: Write an MSX implementation document using the canonical documentation template. +--- + +# Write an MSX implementation document + +Read and follow the [implementation document template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#implementation-doc). diff --git a/.github/plugin/msx/skills/msx-documentation-orchestration-playbook/SKILL.md b/.github/plugin/msx/skills/msx-documentation-orchestration-playbook/SKILL.md new file mode 100644 index 0000000..a17c627 --- /dev/null +++ b/.github/plugin/msx/skills/msx-documentation-orchestration-playbook/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-documentation-orchestration-playbook +description: Write an MSX orchestration playbook using the canonical documentation template. +--- + +# Write an MSX orchestration playbook + +Read and follow the [orchestration playbook template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#orchestration-playbook). diff --git a/.github/plugin/msx/skills/msx-documentation-reference/SKILL.md b/.github/plugin/msx/skills/msx-documentation-reference/SKILL.md new file mode 100644 index 0000000..75a67cf --- /dev/null +++ b/.github/plugin/msx/skills/msx-documentation-reference/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-documentation-reference +description: Write an MSX reference document using the canonical documentation template. +--- + +# Write an MSX reference + +Read and follow the [reference template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#reference). diff --git a/.github/plugin/msx/skills/msx-documentation-research/SKILL.md b/.github/plugin/msx/skills/msx-documentation-research/SKILL.md new file mode 100644 index 0000000..05d27c5 --- /dev/null +++ b/.github/plugin/msx/skills/msx-documentation-research/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-documentation-research +description: Write MSX research findings using the canonical documentation template. +--- + +# Write MSX research + +Read and follow the [research template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#research). diff --git a/.github/plugin/msx/skills/msx-documentation-specification/SKILL.md b/.github/plugin/msx/skills/msx-documentation-specification/SKILL.md new file mode 100644 index 0000000..3cc6d52 --- /dev/null +++ b/.github/plugin/msx/skills/msx-documentation-specification/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-documentation-specification +description: Write an MSX capability specification using the canonical documentation template. +--- + +# Write an MSX specification + +Read and follow the [specification template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#specification). diff --git a/.github/plugin/msx/skills/msx-documentation-standard/SKILL.md b/.github/plugin/msx/skills/msx-documentation-standard/SKILL.md new file mode 100644 index 0000000..5b900c0 --- /dev/null +++ b/.github/plugin/msx/skills/msx-documentation-standard/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-documentation-standard +description: Write an MSX standard using the canonical documentation template. +--- + +# Write an MSX standard + +Read and follow the [standard template](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md#standard). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-agentic-development/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-agentic-development/SKILL.md new file mode 100644 index 0000000..2682252 --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-agentic-development/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-agentic-development +description: Apply the MSX agentic development way of working. +--- + +# Follow MSX agentic development + +Read and follow [MSX Agentic Development](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Agentic-Development.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-automation-labels/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-automation-labels/SKILL.md new file mode 100644 index 0000000..dc79cdf --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-automation-labels/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-automation-labels +description: Apply MSX ownership and namespacing rules for automation labels. +--- + +# Follow MSX automation label rules + +Read and follow [MSX Automation Labels](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Automation-Labels.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-branching-and-merging/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-branching-and-merging/SKILL.md new file mode 100644 index 0000000..48a3178 --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-branching-and-merging/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-branching-and-merging +description: Create branches and integrate MSX changes through pull requests. +--- + +# Follow MSX branching and merging + +Read and follow [MSX Branching and Merging](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Branching-and-Merging.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-code-ownership/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-code-ownership/SKILL.md new file mode 100644 index 0000000..bf9d326 --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-code-ownership/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-code-ownership +description: Apply the MSX permission, ownership, and enforcement model. +--- + +# Follow MSX code ownership + +Read and follow [MSX Code Ownership](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Code-Ownership.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-commit-conventions/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-commit-conventions/SKILL.md new file mode 100644 index 0000000..d8eeca0 --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-commit-conventions/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-commit-conventions +description: Write MSX commit messages using the canonical conventions. +--- + +# Follow MSX commit conventions + +Read and follow [MSX Commit Conventions](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Commit-Conventions.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-comparative-review-orchestration/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-comparative-review-orchestration/SKILL.md new file mode 100644 index 0000000..70aa59e --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-comparative-review-orchestration/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-comparative-review-orchestration +description: Review an MSX target against reference sources using the comparative review playbook. +--- + +# Follow MSX comparative review orchestration + +Read and follow [MSX Comparative Review Orchestration](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Comparative-Review-Orchestration.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-continuous-delivery-and-release/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-continuous-delivery-and-release/SKILL.md new file mode 100644 index 0000000..0ed4f3e --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-continuous-delivery-and-release/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-continuous-delivery-and-release +description: Distinguish MSX integration, delivery, deployment, and release practices. +--- + +# Follow MSX continuous delivery and release + +Read and follow [MSX Continuous Delivery and Release](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Continuous-Delivery-And-Release.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-continuous-practices/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-continuous-practices/SKILL.md new file mode 100644 index 0000000..a2bc487 --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-continuous-practices/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-continuous-practices +description: Apply the MSX Continuous X, Continuous AI, and DevOps Dojo practices. +--- + +# Follow MSX continuous practices + +Read and follow [MSX Continuous Practices](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Continuous-Practices.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-contribution-workflow/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-contribution-workflow/SKILL.md new file mode 100644 index 0000000..d8c283b --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-contribution-workflow/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-contribution-workflow +description: Move an MSX change from branch to review-ready pull request. +--- + +# Follow the MSX contribution workflow + +Read and follow the [MSX Contribution Workflow](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Contribution-Workflow.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-definition-of-ready-and-done/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-definition-of-ready-and-done/SKILL.md new file mode 100644 index 0000000..63adebf --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-definition-of-ready-and-done/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-definition-of-ready-and-done +description: Apply the MSX readiness and completion gates. +--- + +# Follow the MSX Definition of Ready and Done + +Read and follow [MSX Definition of Ready and Done](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Definition-of-Ready-and-Done.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-devops-reference/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-devops-reference/SKILL.md new file mode 100644 index 0000000..88e2797 --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-devops-reference/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-devops-reference +description: Consult the MSX DevOps and SRE reference for ways of working. +--- + +# Consult the MSX DevOps reference + +Read and follow [MSX DevOps Reference](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/DevOps-Reference.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-documentation-model/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-documentation-model/SKILL.md new file mode 100644 index 0000000..7454949 --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-documentation-model/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-documentation-model +description: Organize MSX documentation with the canonical documentation model. +--- + +# Follow the MSX documentation model + +Read and follow the [MSX Documentation Model](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Documentation-Model.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-engineering-taste/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-engineering-taste/SKILL.md new file mode 100644 index 0000000..2596195 --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-engineering-taste/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-engineering-taste +description: Apply MSX engineering judgment when standards do not settle a choice. +--- + +# Apply MSX engineering taste + +Read and follow [MSX Engineering Taste](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Engineering-Taste.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-evolutionary-development/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-evolutionary-development/SKILL.md new file mode 100644 index 0000000..6c73f12 --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-evolutionary-development/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-evolutionary-development +description: Grow MSX software through small bets, feedback, and selection. +--- + +# Follow MSX evolutionary development + +Read and follow [MSX Evolutionary Development](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Evolutionary-Development.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-fleet-orchestration/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-fleet-orchestration/SKILL.md new file mode 100644 index 0000000..9c6a1cf --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-fleet-orchestration/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-fleet-orchestration +description: Roll one MSX change out across many repositories. +--- + +# Follow MSX fleet orchestration + +Read and follow [MSX Fleet Orchestration](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Fleet-Orchestration.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-git-worktrees/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-git-worktrees/SKILL.md new file mode 100644 index 0000000..e44a7ab --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-git-worktrees/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-git-worktrees +description: Create and use MSX Git worktrees for isolated changes. +--- + +# Follow MSX Git worktrees + +Read and follow [MSX Git Worktrees](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Git-Worktrees.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-goal-setting/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-goal-setting/SKILL.md new file mode 100644 index 0000000..6bec87b --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-goal-setting/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-goal-setting +description: Set MSX missions, objectives, and initiatives above repository epics. +--- + +# Follow the MSX goal-setting framework + +Read and follow [MSX Goal-Setting Framework](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Goal-Setting.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-issues/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-issues/SKILL.md new file mode 100644 index 0000000..3de964c --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-issues/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-issues +description: Format and organize issues across the MSX ecosystem. +--- + +# Follow MSX issue practices + +Read and follow [MSX Issues](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Issues/index.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-observability/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-observability/SKILL.md new file mode 100644 index 0000000..5117d5c --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-observability/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-observability +description: Apply MSX observability and failure registration practices. +--- + +# Follow MSX observability + +Read and follow [MSX Observability](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Observability.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-organization-standard/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-organization-standard/SKILL.md new file mode 100644 index 0000000..8981825 --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-organization-standard/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-organization-standard +description: Apply the MSX organization standard. +--- + +# Follow the MSX organization standard + +Read and follow [MSX Organization Standard](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Organization-Standard.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-pr-format/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-pr-format/SKILL.md new file mode 100644 index 0000000..e55809b --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-pr-format/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-pr-format +description: Format MSX pull request titles, descriptions, change types, and labels. +--- + +# Follow the MSX pull request format + +Read and follow [MSX PR Format](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/PR-Format.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-principles/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-principles/SKILL.md new file mode 100644 index 0000000..4bd55e3 --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-principles/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-principles +description: Apply the MSX principles behind decisions and product mindset. +--- + +# Follow MSX principles + +Read and follow [MSX Principles](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Principles/index.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-readme-driven-context/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-readme-driven-context/SKILL.md new file mode 100644 index 0000000..f1ff727 --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-readme-driven-context/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-readme-driven-context +description: Use the README as the MSX repository context front door and source of truth. +--- + +# Follow MSX README-driven context + +Read and follow [MSX README-Driven Context](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Readme-Driven-Context.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-repository-segmentation/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-repository-segmentation/SKILL.md new file mode 100644 index 0000000..3d0bf96 --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-repository-segmentation/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-repository-segmentation +description: Decide what belongs in an MSX repository and when to split or combine. +--- + +# Follow MSX repository segmentation + +Read and follow [MSX Repository Segmentation](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Repository-Segmentation.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-repository-standard/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-repository-standard/SKILL.md new file mode 100644 index 0000000..a410559 --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-repository-standard/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-repository-standard +description: Apply the MSX repository standard. +--- + +# Follow the MSX repository standard + +Read and follow [MSX Repository Standard](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Repository-Standard.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-repository-type-property/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-repository-type-property/SKILL.md new file mode 100644 index 0000000..c2ad979 --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-repository-type-property/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-repository-type-property +description: Classify an MSX repository with its Type property. +--- + +# Apply the MSX repository type property + +Read and follow [MSX Repository Type Property](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Repository-Type-Property.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-review-etiquette/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-review-etiquette/SKILL.md new file mode 100644 index 0000000..f898dbf --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-review-etiquette/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-review-etiquette +description: Review MSX changes with the expected tone, scope, severity, and disagreement rules. +--- + +# Follow MSX review etiquette + +Read and follow [MSX Review Etiquette](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Review-Etiquette.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-session-interactions/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-session-interactions/SKILL.md new file mode 100644 index 0000000..0b9d80b --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-session-interactions/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-session-interactions +description: Interpret MSX phrases that steer a working session. +--- + +# Follow MSX session interactions + +Read and follow [MSX Session Interactions](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Session-Interactions.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-spec-driven-development-templates/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-spec-driven-development-templates/SKILL.md new file mode 100644 index 0000000..6af3375 --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-spec-driven-development-templates/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-spec-driven-development-templates +description: Select the canonical MSX template for a spec-driven artifact. +--- + +# Use MSX spec-driven development templates + +Read and follow [MSX Spec-Driven Development Templates](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development-Templates.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-spec-driven-development/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-spec-driven-development/SKILL.md new file mode 100644 index 0000000..5d7bf10 --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-spec-driven-development/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-spec-driven-development +description: Develop MSX capabilities from specification through design and delivery. +--- + +# Follow MSX spec-driven development + +Read and follow [MSX Spec-Driven Development](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Spec-Driven-Development.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-workflow-stages/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-workflow-stages/SKILL.md new file mode 100644 index 0000000..8143341 --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-workflow-stages/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-workflow-stages +description: Select and follow an MSX workflow stage procedure. +--- + +# Follow an MSX workflow stage + +Read and follow the [MSX Workflow Stages](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Workflow-Stages/index.md). diff --git a/.github/plugin/msx/skills/msx-ways-of-working-workflow/SKILL.md b/.github/plugin/msx/skills/msx-ways-of-working-workflow/SKILL.md new file mode 100644 index 0000000..0b6b70e --- /dev/null +++ b/.github/plugin/msx/skills/msx-ways-of-working-workflow/SKILL.md @@ -0,0 +1,8 @@ +--- +name: msx-ways-of-working-workflow +description: Follow the canonical MSX workflow from idea to delivery. +--- + +# Follow the MSX workflow + +Read and follow the [MSX Workflow](https://github.com/MSXOrg/docs/blob/main/src/docs/Ways-of-Working/Workflow.md). diff --git a/README.md b/README.md index 70749a7..6dbebb8 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,7 @@ That structure is what lets a reader and an agent find the same page by the same workflows/Docs.yml # lint, validate links, build, and publish to GitHub Pages scripts/ # documentation tooling (index generation, link validation) linters/ # shared linter configuration -plugins/ # portable Agent Plugins that point into the documentation +.github/plugin/ # portable Agent Plugins that point into the documentation src/ zensical.toml # site configuration docs/ # the documentation content diff --git a/plugins/msx-standards/skills/msx-coding/SKILL.md b/plugins/msx-standards/skills/msx-coding/SKILL.md deleted file mode 100644 index b06cfc9..0000000 --- a/plugins/msx-standards/skills/msx-coding/SKILL.md +++ /dev/null @@ -1,11 +0,0 @@ ---- -name: msx-coding -description: Routes coding work in any language to the current MSX coding standards. Use when creating, modifying, reviewing, or testing code in an MSX-managed project. ---- - -# Apply MSX coding standards - -Read and follow the [MSX Coding Standards](https://msxorg.github.io/docs/Coding-Standards/). -Start at that index and follow its descriptions inward to every baseline, language, tool, -and construct page applicable to the task. The linked documentation is the source of truth; -do not restate or infer its rules here. diff --git a/plugins/msx-standards/skills/msx-documentation/SKILL.md b/plugins/msx-standards/skills/msx-documentation/SKILL.md deleted file mode 100644 index ca62601..0000000 --- a/plugins/msx-standards/skills/msx-documentation/SKILL.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -name: msx-documentation -description: Routes documentation work to the current MSX documentation standards. Use when creating, organizing, restructuring, reviewing, or updating documentation in an MSX-managed project. ---- - -# Apply MSX documentation standards - -Read and follow the [MSX Documentation Model](https://msxorg.github.io/docs/Ways-of-Working/Documentation-Model/). -Follow its links to the applicable artifact template and the -[Natural Language](https://msxorg.github.io/docs/Coding-Standards/Natural-Language/) and -[Markdown](https://msxorg.github.io/docs/Coding-Standards/Markdown/) standards. The linked -documentation is the source of truth; do not restate or infer its rules here. diff --git a/plugins/msx-standards/skills/msx-ways-of-working/SKILL.md b/plugins/msx-standards/skills/msx-ways-of-working/SKILL.md deleted file mode 100644 index 7cd5046..0000000 --- a/plugins/msx-standards/skills/msx-ways-of-working/SKILL.md +++ /dev/null @@ -1,12 +0,0 @@ ---- -name: msx-ways-of-working -description: Routes work through current MSX process and collaboration standards. Use when capturing or structuring work, planning and decomposing issues, selecting a ready item, implementing, branching, creating a pull request, reviewing, or merging one delivery item. ---- - -# Follow MSX ways of working - -Read and follow the [MSX Ways of Working](https://msxorg.github.io/docs/Ways-of-Working/). -Use that index to select every applicable standard. For work moving from an idea to delivery, -start with the [MSX Workflow](https://msxorg.github.io/docs/Ways-of-Working/Workflow/), -determine the current stage, and follow its stage procedure. The linked documentation is the -source of truth; do not restate or infer its rules here. diff --git a/src/docs/Capabilities/agentic-development/design-plugin-marketplaces.md b/src/docs/Capabilities/agentic-development/design-plugin-marketplaces.md new file mode 100644 index 0000000..67e856b --- /dev/null +++ b/src/docs/Capabilities/agentic-development/design-plugin-marketplaces.md @@ -0,0 +1,97 @@ +--- +title: Plugin Marketplaces +description: How shared and initiative-owned Agent Plugin marketplaces are named, laid out, versioned, and updated. +--- + +# Agent Plugin Marketplaces — Design + +Agent Plugins provide a portable entry point to canonical MSX documentation +and initiative guidance. A marketplace is the catalog for one ownership +boundary. The marketplace owner controls its plugin identities, source paths, +versions, and release changes. + +## Ownership boundaries + +MSXOrg publishes the shared `msxorg` marketplace in `MSXOrg/docs`. It contains +the `msx` plugin for guidance that applies across MSX organizations, +repositories, and initiatives, including the `msx-coding`, +`msx-documentation`, and `msx-ways-of-working` skill families. + +An initiative publishes its own marketplace in its owning repository. For +example, PSModule publishes a `psmodule` plugin for PowerShell-module +processes and skills. Initiative guidance belongs there rather than being +copied into the shared MSXOrg marketplace. Consumers install both marketplaces +when they need shared standards and initiative-specific guidance. + +This boundary keeps shared standards stable and prevents an initiative release +from changing the organization-wide plugin catalog. + +## Canonical identity and layout + +Plugin IDs are lowercase and short. `msx` is the shared MSXOrg plugin ID; +`psmodule` is the canonical PSModule initiative plugin ID. Skill names remain +owned by their plugin and use a matching prefix: `msx-*` for shared MSX +skills and `psmodule-*` for PSModule skills. + +Each marketplace uses the flatter plugin layout below: + +```text +/ + .github/ + plugin/ + marketplace.json + / + plugin.json + skills/ + / + SKILL.md +``` + +The `source` in `marketplace.json` is repository-root-relative. For the shared +plugin it is `.github/plugin/msx`; an initiative plugin uses the corresponding +path, such as `.github/plugin/psmodule`. A source must resolve to the plugin +directory named by the marketplace entry, and the plugin manifest's `name` +must match that entry. + +## Skill granularity + +Every skill is one pointer to one canonical document. The shared `msx` plugin +uses `msx-coding-*` for each coding language or tool, +`msx-documentation-*` for each documentation artifact type, and +`msx-ways-of-working-*` for each child listed by the Ways of Working index. +The skill body contains the route, not a duplicate of the documentation. + +## Versioning and update flow + +Each marketplace entry and its plugin manifest carry the same plugin version. +A plugin change increments both values together. The marketplace metadata +version describes the catalog and is managed independently from the versions +of the plugins it lists. + +The update flow is: + +1. The marketplace owner changes the plugin manifest, skills, or catalog entry + in the owning repository. +2. The owner synchronizes the plugin entry and manifest version when the + plugin changes. +3. Validation confirms that JSON parses, every source resolves, names and + versions agree, and every skill follows the Agent Skills format. +4. The owner publishes the marketplace change through its normal pull request + and release process. + +An initiative plugin is updated in its initiative repository. The shared `msx` +plugin is updated in `MSXOrg/docs`. Neither repository republishes the other +repository's plugin. + +## Shared and initiative guidance + +Use the shared `msx` plugin for organization-wide standards and ways of +working. Use an initiative plugin for process, workflow, or tool guidance that +only applies within that initiative. A skill may route to canonical +documentation and add runtime mechanics, but it must not create a second +definition of a shared workflow. + +When guidance moves from initiative-specific to organization-wide, update the +canonical documentation and ownership decision first. Then publish it through +the appropriate marketplace rather than keeping duplicate skills under both +plugin IDs. diff --git a/src/docs/Capabilities/agentic-development/index.md b/src/docs/Capabilities/agentic-development/index.md index a314d49..e2c1bb9 100644 --- a/src/docs/Capabilities/agentic-development/index.md +++ b/src/docs/Capabilities/agentic-development/index.md @@ -19,6 +19,7 @@ A repository adopts the framework by carrying a short router and the client rout | [MCP Servers](mcp-servers.md) | How one logical set of tool servers is defined once and declared by every runtime in its own format, so a documented procedure does not depend on which client runs it. | | [Runtime Integration](runtime-integration.md) | How a runtime is wired into the framework — the entry file it reads, the lifecycle point its refresh attaches to, the permissions it needs, and what a new runtime must supply to be supported. | | [Plugin Distribution](plugin-distribution.md) | How recurring workflows are packaged as named intents that point to canonical documentation, and why a packaged shortcut never carries a copy of the procedure. | +| [Plugin Marketplaces](design-plugin-marketplaces.md) | How shared and initiative-owned Agent Plugin marketplaces are named, laid out, versioned, and updated. | | [Agent Interaction](agent-interaction.md) | How humans and agents coordinate through issues, labels, and pull requests, and why intent and implementation are kept in separate artifacts. | | [Advisory Agents](advisory-agents.md) | The pattern for automation that analyses work and publishes its conclusion as advice, without deciding, relabelling, or committing. | | [Conformance](conformance.md) | What a repository must provide to be conformant with the agentic development framework, what it may add, and the duplication checks that keep the router thin. | diff --git a/src/docs/Capabilities/agentic-development/plugin-distribution.md b/src/docs/Capabilities/agentic-development/plugin-distribution.md index 5e8cdf8..32d5a58 100644 --- a/src/docs/Capabilities/agentic-development/plugin-distribution.md +++ b/src/docs/Capabilities/agentic-development/plugin-distribution.md @@ -84,43 +84,11 @@ load `SKILL.md` when the request matches, and read referenced resources only whe active skill needs them. A description therefore names both the capability and its trigger; the body stays a short route and runtime procedure. -## Skill granularity follows the documentation - -A skill SHOULD map to the nearest canonical index that can route the whole intent. It SHOULD -NOT be split per language, framework, or document merely because those pages exist. - -The coding standards already have the right progressive shape: - -1. `Coding-Standards/index.md` separates the shared baseline from language and tool pages. -2. The language entry adds its own rules. -3. A large standard, such as PowerShell, carries another index that routes to the applicable - construct. - -One coding skill can therefore inspect the artifact, enter the coding standards index, and -follow its descriptions to every applicable page. Separate language skills would duplicate -the dispatch boundary and make cross-language changes depend on several skills activating -correctly. Split a skill only when an intent needs distinct runtime mechanics, scripts, -assets, permissions, or tools — not when it only needs a different documentation branch. - -The repository implementation follows this model: - -```text -.github/plugin/marketplace.json -plugins/ - msx-standards/ - plugin.json - skills/ - msx-coding/ - SKILL.md - msx-documentation/ - SKILL.md - msx-ways-of-working/ - SKILL.md -``` +## Marketplace structure and skill boundaries -The package and marketplace carry discovery metadata and mechanics. Coding requirements -remain under `src/docs/Coding-Standards/`; documentation and process requirements remain -under `src/docs/Ways-of-Working/`. +The [Plugin Marketplaces design](design-plugin-marketplaces.md) is the single source of truth +for marketplace ownership, repository layout, plugin identities, and skill granularity. This +page covers how named intents are distributed; it does not repeat those structural rules. ## GitHub Copilot distribution @@ -128,7 +96,7 @@ An individual registers the marketplace and installs its standards plugin with C ```shell copilot plugin marketplace add MSXOrg/docs -copilot plugin install msx-standards@msxorg +copilot plugin install msx@msxorg ``` Skills configured for Copilot CLI are also available in the @@ -142,7 +110,7 @@ governance repository: ```json { "enabledPlugins": { - "msx-coding@msxorg": true + "msx@msxorg": true }, "extraKnownMarketplaces": { "msxorg": { diff --git a/src/zensical.toml b/src/zensical.toml index 0e65104..1612877 100644 --- a/src/zensical.toml +++ b/src/zensical.toml @@ -172,6 +172,7 @@ nav = [ {"MCP Servers" = "Capabilities/agentic-development/mcp-servers.md"}, {"Runtime Integration" = "Capabilities/agentic-development/runtime-integration.md"}, {"Plugin Distribution" = "Capabilities/agentic-development/plugin-distribution.md"}, + {"Plugin Marketplaces" = "Capabilities/agentic-development/design-plugin-marketplaces.md"}, {"Agent Interaction" = "Capabilities/agentic-development/agent-interaction.md"}, {"Advisory Agents" = "Capabilities/agentic-development/advisory-agents.md"}, {"Conformance" = "Capabilities/agentic-development/conformance.md"},