Menu
Audit architectural friction and propose concrete deepening candidates without editing first.
Install with Codex or Claude Copy this prompt, paste it into Codex, Claude, or another assistant, and let it review the skill page and install it for you.
Based on SOC occupation classification
Maintain CHANGELOG.md as meaningful merges land. Use after merging a feature branch, before cutting a release, or when asked "what changed?".
Cut a GitHub release by updating changelog, validating release checks, creating a tag, and publishing with gh.
Ship current work through a GitHub pull request using git and gh.
Record durable architectural decisions in docs/adr with compact context and consequences.
Shared vocabulary for designing deep modules, interfaces, seams, and adapters.
Diagnose hard bugs by building a tight repro loop before changing code.
| name | improve-codebase-architecture |
| description | Audit architectural friction and propose concrete deepening candidates without editing first. |
| metadata | {"author":"mattpocock","version":"1.0.2"} |
Use this for architecture audits, modularity questions, and testability problems. This skill uses codebase-design vocabulary.
CONTEXT-MAP.md and relevant CONTEXT.md.docs/adr/ if present.For each candidate, include:
strong, worth exploring, or speculative.moodle_mcp.moodle: transport, retries, rate limits, feature detection, and cache seams.moodle_mcp.api: parsing and domain behavior.moodle_mcp.tools: thin FastMCP wrappers and stable tool signatures.moodle_mcp.resources: read-only context serialization.moodle_mcp.models: response model boundaries.moodle_mcp.cli: Typer command composition.If a candidate is rejected for a durable reason, offer an ADR. Do not create one unless the user agrees.
Architecture reports do not require tests. If code changes follow, use implement and relevant checks.