deepen-codebase-design
Deepen Codebase Design
Explore a codebase the way an experienced maintainer would: follow friction, identify complexity, and turn the strongest refactor direction into an RFC artifact under docs/.
Favor deeper modules, simpler interfaces, lower cognitive load, and better information hiding.
Read Order
- Read
references/review-rubric.mdbefore exploring. - Read
references/philosophy-of-software-design.mdwhen calibrating Ousterhout concepts and anti-patterns. - Read
references/rfc-template.mdonly when drafting or updating the RFC artifact.
Core Contract
Follow this lifecycle:
- Explore the codebase organically and note architectural friction.
- Present a short ranked list of improvement candidates.
- Ask the user which candidate to explore.
More from khoahyh/skills
jujutsu-colocated
Safe, practical workflows for using Jujutsu (`jj`) in colocated repositories (`.git` + `.jj`) and parallel-agent environments. Use when planning, editing, splitting, recovering, coordinating, isolating parallel agents with workspaces, or publishing changes with `jj`, especially when avoiding destructive history/state operations.
13greptile-address
Run one Greptile review-address pass on a pull request. Trigger or wait for checks once, analyze Greptile comments once, fix actionable feedback once, resolve addressed threads, and report what remains. Use when the user wants to address the latest greptile review comments on their PR.
8write-effect-ts
Write idiomatic Effect TypeScript using Effect.gen, Effect.fn, Schema, services, layers, Config, and @effect/vitest. Use when a repository uses `effect` or `@effect/*`, or when adding, refactoring, debugging, or reviewing Effect code around `ServiceMap.Service`, `Context.Tag`, `Effect.Service`, `Layer`, `Schema`, config, HTTP clients, CLI code, or Effect tests.
4sharingan
This skill should be used when the user asks to clone and analyze a repository into a portable context bundle, such as "clone this repo and build reusable context", "package repository context artifacts", or "prepare repo context for another skill or agent workflow".
3