← ClaudeAtlas

write-explainerlisted

Explain a bug, feature, module, or section of code to someone new to the codebase - full mechanism, file:line citations, developer to developer
ku5ic/dotfiles · ★ 0 · AI & Automation · score 69
Install: claude install-skill ku5ic/dotfiles
## When to use this The subject is already understood well enough to explain - root cause from `/flow-debug`, a feature just built or reviewed, or a module/section of code someone needs oriented to - and the goal is understanding, not a change. Produces a citation-heavy walkthrough for a reader unfamiliar with the code. Use `/write-devnote` instead for a short peer-to-peer note on a completed change. Use `/flow-fix` or `/flow-plan` instead when the goal is to change code, not explain it. ## Procedure 1. Establish the subject and source. - `$ARGUMENTS` may name a debug report or bug ticket, a feature or module name, a file or directory path, or nothing at all - in which case default to whatever's already been discussed in this conversation. - If a file is named, read it in full. - If it's a bug/ticket or feature/module name with no artifact, check the conversation and project memory for matching context before asking the user to point at one. - If nothing can be found, stop and ask what to explain. 2. Do not trust any existing citations - from a debug report, prior conversation, or memory - at face value. Re-read every file mentioned in its current state before repeating a citation. Code moves; a prior artifact is a starting hypothesis, not a fact. 3. Identify the natural entry point for understanding the subject: for a bug, the user action or event that starts the chain; for a feature or module, where it's mounted, its main export, or the first file a reader wo