Improve Codebase Architecture

Your codebase is the real prompt. Use this skill to find places where agents will get lost, make scattered changes, or accelerate entropy, then turn them into human-approved module-deepening refactors.

Core stance: agents are tactical programmers; the human is the strategic programmer. Do not AFK-rewrite architecture.

Quick Start

1. Explore the codebase like a new starter with no memory.
2. Return a numbered shortlist of deepening candidates; do not design solutions yet.
3. Ask: “Which candidate should we grill?”
4. Ground the chosen candidate in code, ask boundary questions, then sketch a deep/gray-box module.
5. If requested, create a focused RFC/issue for an implementation agent.

Process

Explore for AI friction. Build the mental map exposed by the filesystem: product/domain areas, obvious public interfaces, tests/feedback loops, and places requiring too much hidden context. The friction you experience is signal.