martinopedal

Reproducible playbook for verifying azure-analyzer is fully clean before/after a release. Covers docs freshness, simulation/mock leakage, runtime correctness, CI green, and PSGallery publish parity. Every step writes its result to the decisions inbox so the run is auditable.

When a multi-track plan references unbuilt modules, decide extract vs consume-as-built

Write repository documentation in the house voice: direct, concrete, no AI-tells, only ✅ ❌ emojis

{what this skill teaches agents}

Squad branching model: main-as-trunk workflow with short-lived issue branches

Rubber-duck Copilot PR/issue comments against the 3-model gate before changing any code

{what this skill teaches agents}

Write project documentation in a direct, human voice. Strip AI tells, ban em-dashes, and keep emojis to a small functional set. Applies to all docs of record (README, docs/, .github/agents/, .squad/templates/, .squad/decisions.md, .squad/skills/*/SKILL.md, agent histories, copilot-instructions.md). Does not apply to historical artifacts under .squad/orchestration-log/ and .squad/log/.

Architecture contract for any feature that takes action OUTSIDE the tool's process boundary based on findings. The audit half stays read-only against the audited Microsoft tenant. Any agentic add-on writes only against the operator's own ticketing platform or IaC repo, never against the audited cloud. Applies to issue #16 (remediation-PR drafter), #11 (catalogue drift watcher when it files issues), #9 (playbook reporter when consumed by an agent), and any future agent-driven CLI subcommand.

Core conventions and patterns for this codebase

Core conventions and patterns for this codebase

{what this skill teaches agents}

Detect and set up account-locked gh aliases for multi-account GitHub. The AI reads this skill, detects accounts, asks the user which is personal/work, and runs the setup automatically.

Documentation emoji policy, voice profile, and prose rules