improve-codebase-architecture
๐ฏSkillfrom mattpocock/skills
Installation
npx vibeindex add mattpocock/skills --skill improve-codebase-architecturenpx skills add mattpocock/skills --skill improve-codebase-architecture~/.claude/skills/improve-codebase-architecture/SKILL.md
|An agent skill from Matt Pocock's engineering toolkit that helps improve your codebase architecture. Part of a composable skill set designed to fix common AI coding agent failure modes through structured, experience-based workflows.
Overview
An agent skill from Matt Pocock's engineering toolkit that helps improve codebase architecture through a structured, experience-driven workflow. Part of the "Skills For Real Engineers" collection, it addresses common failure modes seen with Claude Code, Codex, and other coding agents. The skill is designed to be small, composable, and model-agnostic, working with any coding agent while keeping the developer in control of architectural decisions.
Key Features
- Structured architecture improvement workflow that addresses common AI agent failure modes
- Composable with other skills in the toolkit, such as
/grill-mefor alignment and/triagefor ticket management - Model-agnostic design that works with any coding agent (Claude Code, Codex, and others)
- Quick setup via
npx skills@latest add mattpocock/skillswith a guided configuration step
Who is this for?
- Software engineers using AI coding agents who want structured processes for codebase improvements rather than ad-hoc changes
- Tech leads looking for repeatable, experience-based workflows to guide AI agents through architectural refactoring
- Teams that have experienced misalignment between what they asked an AI agent to do and what it actually built
Same repository
mattpocock/skills(55 items)
SKILL.md
More from this repository10
Interviews the user relentlessly about every aspect of a plan or design until reaching shared understanding, resolving each branch of the decision tree one by one. Provides recommended answers for each question and explores the codebase when answers can be found there.
A skill that runs a grilling session to challenge your plan against an existing domain model, sharpen terminology by building a shared language in CONTEXT.md, and document architectural decisions in ADRs before coding begins.
Enforces test-driven development with a strict red-green-refactor loop using vertical slices (one test then one implementation at a time), emphasizing behavior verification through public interfaces rather than implementation-coupled testing.
Initial setup skill for Matt Pocock's engineering skills collection that configures your backlog manager, triage labels, and documentation paths for AI coding agents.
A collection of small, composable engineering skills designed for real development workflows, featuring grilling sessions for requirement alignment, issue tracking integration, and task triage with customizable labels.
A composable skill for triaging issues and tickets using configurable labels, designed to fix common failure modes in AI coding agents by providing structured backlog management workflows.
A collection of composable engineering skills by Matt Pocock designed to fix common AI coding agent failure modes: misalignment via grilling sessions, verbosity through shared domain language (CONTEXT.md), code quality with TDD red-green-refactor loops, and codebase entropy with architecture improvement workflows.
A model-invoked productivity skill that interviews users relentlessly about a plan or design until every branch of the decision tree is resolved. It serves as the reusable interview loop behind the grill-me and grill-with-docs skills.
A model-invoked engineering skill that actively builds and sharpens a project's domain model by challenging terms against the glossary, stress-testing with edge-case scenarios, and updating CONTEXT.md and ADRs inline.
A model-invoked engineering skill that provides shared discipline and vocabulary for designing deep modules: maximizing behavior behind small interfaces, placing code at clean seams, and ensuring testability through public APIs.