Topic field guide
Architecture
Keep fast-moving agent-built codebases understandable, modular, and inexpensive to change.
Prompts
Map an unfamiliar codebase
Build a useful model of modules, data flow, boundaries, and domain language before changing code.
Copy and adapt
Find architecture opportunities worth taking
Identify improvements that reduce future change cost instead of merely rearranging files.
Copy and adapt
Design a deep module
Place substantial behavior behind a small, stable interface at a real domain seam.
Copy and adapt
Reduce codebase entropy
Review a change or area with a bias toward deletion, locality, and fewer concepts.
Copy and adapt
Define the project’s domain vocabulary
Create a shared language that improves naming, documentation, and agent comprehension.
Copy and adapt
Write an architecture decision record
Record a technical choice as context, forces, consequences, and revisit conditions.
Copy and adapt
Plan a behavior-preserving refactor
Create a sequence of small structural changes with explicit regression protection.
Copy and adapt
Find boundaries that leak
Trace knowledge duplicated across consumers and locate the missing owner.
Copy and adapt
Directory picks
Improve Codebase Architecture
Finds high-leverage opportunities to create deeper modules and reduce future change cost.
mattpocock/skills
Domain Modeling
Builds shared vocabulary, challenges ambiguous concepts, and maintains domain context.
mattpocock/skills
Codebase Design
Applies deep-module principles to place behavior behind small, truthful interfaces.
mattpocock/skills
Composition Patterns
Builds flexible React component APIs without accumulating prop and conditional complexity.
vercel-labs/agent-skills
Supabase Postgres Best Practices
Guides schema, query, security, and performance decisions for Supabase-backed applications.
supabase/agent-skills
Reducing Entropy
Reviews designs and refactors with a bias toward deletion, locality, and fewer total concepts.
joshuadavidthomas/agent-skills
Coding Standards
Provides language-agnostic judgment for boundaries, state, effects, errors, complexity, and maintainability.
joshuadavidthomas/agent-skills
Workflows
Understand an unfamiliar codebase
Move from repository noise to a working model of the domain, execution path, and modules relevant to your change.
20–45 min
Rescue a codebase becoming a ball of mud
Find the repeated change pain, create a deeper seam, and refactor without turning the effort into a rewrite.
45–90 min
Collections