design-codebase-with-senior-dev
Design Codebase With Senior Dev
Determine whether the codebase needs a structural change at all. Reconstruct the current design from repository evidence, expose the forces that make it costly or unsafe, analyze structural technical debt, and choose the least powerful design that resolves those forces without silently changing behavior.
This skill is assessment-only. Inspect and run non-mutating checks, but never edit implementation files. Finish with a validated, receipt-stamped Codebase Design Assessment emitted through finalize_assessment.py and a deterministic handoff.
Invocation Modes
Mode A: Targeted Design Assessment
Use this mode when the user supplies a specific target: a module, subsystem, file set, dependency boundary, architectural concern, technical-debt concern, proposed pattern, migration, or requested structural change. Assess the supplied target without broadening into an unrelated repository audit.
Mode B: Autonomous Target Discovery
Use this mode when the user asks for architectural improvement or design assessment but does not identify a specific target, pain point, module, or subsystem. In this mode, perform a bounded, read-only discovery pass to select one defensible structural concern for assessment. Do not stop or ask the user to choose a target when repository evidence can safely do so.