codebase-walkthrough

Trace end-to-end codebase flows with diagrams and file references.

1|Updated Mar 3, 2026
One-click install
npx skills add https://github.com/AndreJorgeLopes/devflow --skill codebase-walkthrough
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-walkthrough
Source: https://github.com/AndreJorgeLopes/devflow/tree/main/skills/codebase-walkthrough
Command: npx skills add https://github.com/AndreJorgeLopes/devflow --skill codebase-walkthrough

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

It prevents wasted implementation time by helping you understand exactly how the codebase handles a task end-to-end before you start changing anything.

Core Features & Use Cases

  • Flow-first walkthroughs: builds an end-to-end journey diagram (main path plus side effects) and walks every leg including persistence and downstream consumers.
  • Code-grounded explanations: shows the relevant file paths, line ranges, and key function signatures/code blocks (without dumping entire files) for each leg of the flow.
  • Change impact mapping: links the ticket’s changes to the specific affected legs, files, and before/after data shapes.
  • Implementation-ready reading list: produces a prioritized “files to read” list limited to directly relevant and essential context files.
  • Assumptions surfaced early: explicitly calls out assumptions and open questions, marking what must be verified rather than guessed.

Quick Start

Ask the AI to run a deep walkthrough for your ticket or task so it traces the full flow (including side effects and code) before proposing any implementation changes.

Frequently Asked Questions about codebase-walkthrough

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I trace an end-to-end codebase flow before implementing changes?

Tracing an end-to-end codebase flow involves mapping the main path and side effects to build a journey diagram. It walks every leg including persistence and downstream consumers, providing file paths and line numbers before you start coding.

What is the best way to plan changes in unfamiliar code across multiple services?

Planning changes across multiple services requires mapping the change impact to specific affected files and data shapes. This approach surfaces assumptions early and produces a prioritized files-to-read list, ensuring you only modify directly relevant code.

How do I map the impact of a ticket on downstream consumers and persistence points?

Mapping ticket impact links your requested changes to specific affected legs, files, and before/after data shapes. It explicitly traces downstream consumers and persistence points to ensure architectural understanding and prevent wasted implementation time.

Can I get code-grounded excerpts with file paths for architecture tracing?

Architecture tracing provides code-grounded explanations by showing relevant file paths, line ranges, and key function signatures for each leg of the flow. It extracts specific code blocks without dumping entire files to maintain context.

How do I surface assumptions and open questions before starting implementation planning?

Implementation planning surfaces assumptions by explicitly calling out open questions and marking what must be verified rather than guessed. This prevents wasted effort by ensuring architectural understanding before proposing any implementation changes.