skills.rest
hawkyre
hawkyreCOMMUNITY
Explore all skills by this author →
GitHub

learn-system

Map entry points, data flow, and architecture of codebases.

30|2|Updated Apr 28, 2026
Search Tags:#architecture#onboarding#codebase#trace#diagrams#learn#mental-model
One-click install
npx skills add https://github.com/hawkyre/hawk-skills --skill learn-system
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: learn-system
Source: https://github.com/hawkyre/hawk-skills/tree/main/skills/learn-system
Command: npx skills add https://github.com/hawkyre/hawk-skills --skill learn-system

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Helps onboarding and mental-model building by systematically exploring unfamiliar codebases: triggers, flow, data structures, and decisions.

Core Features & Use Cases

  • Entry-point exploration: identify what triggers execution, high-level flow, key data structures, and critical decisions.
  • Visual mental model: create diagrams (mermaid/ASCII) showing components, data flow, external dependencies, and error boundaries.
  • Concrete flow tracing: walk through a real scenario with function calls, data shapes, and edge cases.
  • Socratic verification: when you articulate your understanding, the system helps identify gaps and missing pieces.
  • Capture the understanding: produce an architecture note outlining purpose, data flow, key concepts, and modification points.

Quick Start

Begin by identifying triggers and high-level flow, then sketch a component diagram and trace a representative scenario.

Frequently Asked Questions about learn-system

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

FAQPage Schema
How do I build a mental model of an unfamiliar codebase?▼

To build a mental model of an unfamiliar codebase, you systematically explore triggers, high-level flow, key data structures, and critical decisions. This approach maps execution paths and data flow to form a coherent understanding of the system architecture.

What is the best way to trace concrete flows and data shapes during codebase onboarding?▼

The best way to trace concrete flows during codebase onboarding is to walk through a real scenario, tracking function calls, data shapes, and edge cases. This method reveals the actual execution path and data transformations within the system.

Can I generate architecture diagrams from an existing legacy codebase?▼

Yes, you can generate architecture diagrams from a legacy codebase by creating visual mental models using mermaid or ASCII. These diagrams map components, data flow, external dependencies, and error boundaries to visualize the system structure.

How do I identify entry points and critical decisions when reviewing legacy modules?▼

You identify entry points and critical decisions in legacy modules by exploring what triggers execution and mapping the high-level flow. This highlights the key data structures and logic branches that control the system's behavior.

How do I capture and document my understanding of a system's architecture?▼

You capture your understanding of a system's architecture by producing a concise architecture note. This note outlines the system's purpose, data flow, key concepts, and specific modification points for future reference and onboarding.

Related Skills

Explore More Software Engineering Skills→
rmanzokurmanzoku
1

chezmoi-knowledge

Explain chezmoi source and target mapping, prefixes, ignore rules, and symlink behavior.

Community
Intermediate
KingSharkGKingSharkG

codebase-exploration

Trace execution paths and map architecture layers to identify key files.

Community
Advanced
genomewalkergenomewalker
3

mermaid

Render Mermaid diagrams into ASCII art or SVG files.

Community
Basic
silaslopes100silaslopes100

reversa-archaeologist

Extract algorithms, control flows, and data dictionaries from source code.

Community
Advanced