edkuksa/skills
1
0
Fork 0
mirror of https://github.com/mattpocock/skills.git synced 2026-07-29 02:52:42 +07:00
Code Issues Packages Projects Releases Wiki Activity

Merge pull request #533 from mattpocock/yagni-scope-improve-architecture

Browse Source 
improve-codebase-architecture: scope the scan to where change is landing (YAGNI)
This commit is contained in:
Matt Pocock
2026-07-13 11:27:15 +01:00
committed by GitHub
parent 33dfc9b28f 45afd8074a
commit 04fee67571
3 changed files with 12 additions and 0 deletions
Download Patch File Download Diff File Expand all files Collapse all files
skills/engineering/improve-codebase-architecture/SKILL.md
+5
View File
@@ -17,6 +17,11 @@ This command is _informed_ by the project's domain model and built on a shared d
### 1. Explore
**Scope before you scan — YAGNI.** Deepening a module pays off by making future changes to it easier, so put extra weight on the parts of the codebase that have recently changed. Decide *where* to look before you look:
- If the user named a direction — a module, a subsystem, a pain point — take it, and skip the inference below.
- Otherwise, walk back a good stretch of the commit history (`git log --oneline`) to find the codebase's hot spots — the files and areas that keep coming up — and let those paths pull your attention first. If the changes are scattered with no clear hot spot, widen the net.
Read the project's domain glossary (`CONTEXT.md`) and any ADRs in the area you're touching first.
Then use the Agent tool with `subagent_type=Explore` to walk the codebase. Don't follow rigid heuristics — explore organically and note where you experience friction: