Claude Code Projects: mas dagkong codebase, mga test ug git

01

Pagkahibalo sa agianan sa usa ka codebase

In simple words

Kung mosulod ka sa dakong library, dili nimo basahon ang tanang libro. Mangutana ka kung asa ang mga mapa, unsa ang naa sa matag estante, ug kinsay nakahibalo sa bilding. Si Claude Code mahimong imong giya. Pangayoa una siya og mapa, ug human ana pilia ang usa ka estante nga trabahoon.

Key facts

Molihok ang Claude Code sa bisan unsang folder ug basahon niya pag-usab ang mga file sa matag tool call. Sugdi sa lapad ("give me an overview of this codebase"), unya pig-ota ("how is authentication handled?").
Opisyal nga prompt recipes nga sulayan: "explain the main architecture patterns used here", "what are the key data models?", "trace the login process from front-end to database".
I-type ang @ ug ang path aron iapil ang file o folder sa imong mensahe, pananglitan @src/utils/auth.js. Ang reference sa folder nagpakita og listahan sa mga file, dili ang sulod. Ang mga file nga labaw sa 256KB dili apilon.
Ang pag-eksplorar nagpuno sa imong context sa mga file reads. Gisugyot sa docs nga ipaubos kini: "use a subagent to investigate how our auth system handles token refresh". Ang subagent nagabasa sa iyang kaugalingong context window ug magpadala balik og summary.
Ang tukma nga prompt makatipid og usa ka hugna sa pagtul-id. Ngalanan ang file, ihulagway ang simtomas ug ingna kung unsa ang pasabot sa "fixed". Huyang: "fix the login bug". Kusgan: "users report login fails after the session times out. look at token refresh in src/auth/, write a failing test that reproduces it, then fix it".
Padagana ang /context all sulod sa session aron makita kung unsang mga file sama sa CLAUDE.md ang na-load.

Pananglitan project used in this course (Python)

tipcalc/
 __init__.py
 pricing.py   # tip(amount, percent)
 split.py    # split_bill(amount, percent, people)
tests/
 __init__.py
 test_split.py

Step by step

Ablihi ang terminal sa proyekto nga adunay labing menos lima ka file (gamita imong kaugalingon, o bisan unsang gamay nga open-source nga proyekto). Sugdi ang claude.
I-type: give me an overview of this codebase. Basaha ang tubag.
Pangutan-a: what are the key modules, and how do they depend on each other?
Pili og usa ka file ug pangutan-a: Explain the logic in @path/to/file (i-type ang tinuod nga path human sa @).
Pangutan-a: where is the code that handles the most important feature, and which tests cover it?
Isulat ang mapa sa imong kaugalingong pulong sa notes file: mga module, unsay buhat sa matag usa, asa ang mga test.
Check: makapasabot ka, nga dili motan-aw, kung unsang file ang imong abliha aron usbon ang usa ka ginganlan nga feature.

Watch on YouTube

Claude Code best practices from AnthropicAnthropic · YouTube · youtube.com

Videos by other creators on YouTube, for reference. They are not made by or affiliated with The Future Market.

LESSON 01Pagkahibalo sa agianan sa usa ka codebase

LESSON 01 / ANIMATED LESSON / ENGLISH VOICE00:00 / 01:00

Voice

Read the video script

[Host] "Dako nga codebase? Ayaw basaha tanan. Pangayoa og mapa."
[Screen: Claude Code nga nagtubag sa 'give me an overview of this codebase'] "Sugdi sa lapad, unya pig-ota."
[Text on screen: @path/to/file] "Gamita ang at sign aron ituro ang usa ka file."
[Screen: summary gikan sa subagent] "Pabasaha ang subagent sa daghang file ug summary lang ang ipabalik."
[Host] "Ang imong kaugalingong mapa sa imong kaugalingong pulong mao gyud ang tumong."

Try it now

Pili og proyekto nga daghan og files. Gamita ang mga lakang sa ibabaw aron magsulat og usa ka pahina nga mapa: mga module, agos sa data ug asa nahimutang ang mga test. Unya pangayoa si Claude nga ipakita ang usa ka butang sa imong mapa nga sayop o kulang.

ClaudeStuck? Copy a ready-made prompt for Claude

Copy this, open Claude, paste it, and Claude will walk you through the lesson step by step.

For a grown-up: Claude is for adults (18+). Copy this, paste it into Claude, and use the answer to explain the lesson to your child.

I'm learning "Claude Code Projects: mas dagkong codebase, mga test ug git" on The Future Market. Lesson 1: "Pagkahibalo sa agianan sa usa ka codebase".

What the lesson teaches:
- Molihok ang Claude Code sa bisan unsang folder ug basahon niya pag-usab ang mga file sa matag tool call. Sugdi sa lapad ("give me an overview of this codebase"), unya pig-ota ("how is authentication handled?").
- Opisyal nga prompt recipes nga sulayan: "explain the main architecture patterns used here", "what are the key data models?", "trace the login process from front-end to database".
- I-type ang @ ug ang path aron iapil ang file o folder sa imong mensahe, pananglitan @src/utils/auth.js. Ang reference sa folder nagpakita og listahan sa mga file, dili ang sulod. Ang mga file nga labaw sa 256KB dili apilon.
- Ang pag-eksplorar nagpuno sa imong context sa mga file reads. Gisugyot sa docs nga ipaubos kini: "use a subagent to investigate how our auth system handles token refresh". Ang subagent nagabasa sa iyang kaugalingong context window ug magpadala balik og summary.
- Ang tukma nga prompt makatipid og usa ka hugna sa pagtul-id. Ngalanan ang file, ihulagway ang simtomas ug ingna kung unsa ang pasabot sa "fixed". Huyang: "fix the login bug". Kusgan: "users report login fails after the session times out. look at token refresh in src/auth/, write a failing test that reproduces it, then fix it".
- Padagana ang /context all sulod sa session aron makita kung unsang mga file sama sa CLAUDE.md ang na-load.

The exercise I'm working on:
Pili og proyekto nga daghan og files. Gamita ang mga lakang sa ibabaw aron magsulat og usa ka pahina nga mapa: mga module, agos sa data ug asa nahimutang ang mga test. Unya pangayoa si Claude nga ipakita ang usa ka butang sa imong mapa nga sayop o kulang.

I'm stuck. Please:
1. Explain the main idea in plain, simple words with one everyday example.
2. Walk me through the exercise one small step at a time. Ask me what I've done so far before giving the next step.
3. Don't just give me the final answer. Help me do it myself, and check my work when I share it.

I'm a parent helping my child (about 8 years old) with a lesson called "Pagkahibalo sa agianan sa usa ka codebase" from the course "Claude Code Projects: mas dagkong codebase, mga test ug git".

Here's what the lesson says:
Kung mosulod ka sa dakong library, dili nimo basahon ang tanang libro. Mangutana ka kung asa ang mga mapa, unsa ang naa sa matag estante, ug kinsay nakahibalo sa bilding. Si Claude Code mahimong imong giya. Pangayoa una siya og mapa, ug human ana pilia ang usa ka estante nga trabahoon.

The activity:
Pili og proyekto nga daghan og files. Gamita ang mga lakang sa ibabaw aron magsulat og usa ka pahina nga mapa: mga module, agos sa data ug asa nahimutang ang mga test. Unya pangayoa si Claude nga ipakita ang usa ka butang sa imong mapa nga sayop o kulang.

Please explain this so an 8-year-old understands: short sentences, a fun everyday example, and no hard words.
Then give me 3 simple questions I can ask my child to check they understood, and a way to do the activity together, one tiny step at a time.

Open Claude

Sources

Claude Code docs, Common workflows (Understand new codebases, Reference files and directories, Delegate research to subagents): code.claude.com/docs/en/common-workflows
Claude Code docs, Best practices (Write a specific prompt): code.claude.com/docs/en/best-practices

My notes

I learned this

02