⚙️ [Maintenance]: Agents can coordinate substantial module work consistently

[Marius Storhaug (MariusStorhaug)]

Agents and contributors can now coordinate substantial module work across focused sessions and author reusable PSModule plugin skills with consistent process guidance.

New: Module development orchestration skill

The psmodule-module-development-orchestration skill guides a parent session through decomposition, branch selection, child-session handoffs, review, integration, stop conditions, and report-back. It follows trunk-based development for existing modules and reserves integration branches for the documented bootstrap exception.

New: Plugin skill authoring guidance

The documentation now explains how to write focused plugin skills and the psmodule-skill-authoring skill points authors to that shared guidance. Common process rules remain linked to the canonical Process-PSModule and MSX ways of working instead of being duplicated across skills.

---

Technical details

• Added .github/plugin/psmodule/skills/psmodule-module-development-orchestration/SKILL.md.
• Added .github/plugin/psmodule/skills/psmodule-skill-authoring/SKILL.md.
• Added docs/content/guides/writing-plugin-skills.md.
• Updated .github/plugin/README.md, docs/content/index.md, and docs/zensical.toml for discoverability.
• Corrected stale MSX documentation paths and verified the live destinations.
• Kept orchestration and skill-authoring procedures focused on agent-specific behavior; organization-wide process rules remain linked to canonical MSX guidance.
• Implementation plan progress: orchestration skill, skill-authoring guidance, plugin discoverability, documentation navigation, branch-policy decisions, canonical-link migration, and repository-native validation guidance are complete; no follow-up implementation work is included.
• Standards and framework alignment:

Changed surface	Standards checked	Framework docs checked	Result
.github/plugin/** (Copilot plugin skills and README)	MSX agentic development and Markdown	Process-PSModule plugin conventions and orchestration guide	Aligned
docs/content/**, docs/zensical.toml (documentation)	MSX Markdown and natural-language guidance	Process-PSModule documentation model and site navigation	Aligned

• Validation: git diff --check, metadata and navigation review, strict Zensical build, 26 unique MSX URL checks with all responses in the 2xx range, Analyze, Lint, Lint code base, Build, and CodeQL passed. Publish was skipped as expected for this draft.
• Issue convergence sweep: this change implements the agent-operational and skill-authoring portions of the orchestration guidance; no additional open issues were fully satisfied by the diff.

Relevant issues (or links)

Related work

• Depends on 📖 [Docs]: Coordinate substantial module work across focused sessions #455
• References Document module development orchestration pattern #482

[github-actions]

Super-linter summary

Language	Validation result
CHECKOV	Pass ✅
CSS	Pass ✅
CSS_PRETTIER	Pass ✅
GITHUB_ACTIONS	Pass ✅
GITHUB_ACTIONS_ZIZMOR	Pass ✅
GITLEAKS	Pass ✅
GIT_MERGE_CONFLICT_MARKERS	Pass ✅
HTML	Pass ✅
JAVASCRIPT_ES	Pass ✅
JAVASCRIPT_PRETTIER	Pass ✅
MARKDOWN	Pass ✅
NATURAL_LANGUAGE	Pass ✅
POWERSHELL	Pass ✅
PRE_COMMIT	Pass ✅
SPELL_CODESPELL	Pass ✅
TRIVY	Pass ✅
YAML	Pass ✅

All files and directories linted successfully

For more information, see the GitHub Actions workflow run

Powered by Super-linter