Gabriel Chiappa

Brazilian by birth. American by choice.
Sun, Pisces ♓️ Rising, Sagittarius ♐️ Moon, Scorpio ♏️
@gabriel_chiappa

[Know Your Computer 💻 @ComputerrBooks]

coding in the early 2000s vs coding now 😹

[Shraddha Bharuka @BharukaShraddha]

Most people treat CLAUDE.md like a prompt file.

That’s the mistake.

If you want Claude Code to feel like a senior engineer living inside your repo, your project needs structure.

Claude needs 4 things at all times:

• the why → what the system does
• the map → where things live
• the rules → what’s allowed / not allowed
• the workflows → how work gets done

I call this:

The Anatomy of a Claude Code Project 👇

━━━━━━━━━━━━━━━

1️⃣ CLAUDE.md = Repo Memory (keep it short)

This is the north star file.

Not a knowledge dump. Just:

• Purpose (WHY)
• Repo map (WHAT)
• Rules + commands (HOW)

If it gets too long, the model starts missing important context.

━━━━━━━━━━━━━━━

2️⃣ .claude/skills/ = Reusable Expert Modes

Stop rewriting instructions.

Turn common workflows into skills:

• code review checklist
• refactor playbook
• release procedure
• debugging flow

Result:
Consistency across sessions and teammates.

━━━━━━━━━━━━━━━

3️⃣ .claude/hooks/ = Guardrails

Models forget.

Hooks don’t.

Use them for things that must be deterministic:

• run formatter after edits
• run tests on core changes
• block unsafe directories (auth, billing, migrations)

━━━━━━━━━━━━━━━

4️⃣ docs/ = Progressive Context

Don’t bloat prompts.

Claude just needs to know where truth lives:

• architecture overview
• ADRs (engineering decisions)
• operational runbooks

━━━━━━━━━━━━━━━

5️⃣ Local CLAUDE.md for risky modules

Put small files near sharp edges:

src/auth/CLAUDE.md
src/persistence/CLAUDE.md
infra/CLAUDE.md

Now Claude sees the gotchas exactly when it works there.

━━━━━━━━━━━━━━━

Prompting is temporary.

Structure is permanent.

When your repo is organized this way, Claude stops behaving like a chatbot…

…and starts acting like a project-native engineer.

[Gabriel Chiappa @_gabrielchiappa]

I'm on the waitlist for @perplexity_ai's new agentic browser, Comet: https://t.co/POpGZwuTlU

[Gabriel Chiappa @_gabrielchiappa]

Me sinto invadido. Pelas rashas 😂

[Gabriel Chiappa @_gabrielchiappa]

Humans, I highly recommend that you make as much money as you can now. The #AIRevolution will crash all models of economy systems we have. But have faith, it will be for the best. #ai

[Gabriel Chiappa @_gabrielchiappa]

Win a Brooklyn Mirage Season Pass: https://t.co/ExeCse5lVM

[Gabriel Chiappa @_gabrielchiappa]

@TMobile @Tesla That’s mine! 😂 #TMobileTelsaTuesdays #contest

[Thais Braz @thaisbraz]

Eu e o arcrebiverso

[Hacker Real @hacker_real1]

#BBB22

🎡Parcial do @hacker_real1🎡
3° parcial:

🧬Jessilane - 35,4%

💃🏿Natália - 23,9%

🥷🏻Rodrigo - 40,7%

👇
600 RTs e 2.000 FAV libero a próxima parcial

[Hacker Real @hacker_real1]

#BBB22

🎡Parcial do @hacker_real1🎡
2° parcial:

🧬Jessilane - 38,5% +/-

💃🏿Natália - 19,8%

🥷🏻Rodrigo - 41,7% +/-

Rodrigo recebendo 90 mil votos por seg.
Jessilane recebendo 75 mil votos por seg.
Natália 40 mil votos p/ seg.

👇
500 RTs e 2.000 FAV libero a próxima parcial

[PEPITA @PepitaOfc]

A casa saindo do mood Hig School Music e entrando no mood: The walking dead … foi a gente que pediu sim #BBB22

[Gabriel Chiappa @_gabrielchiappa]

I entered the #FridayFortyNYC for @CursedChildNYC on @TodayTix! Get tickets for performances next week at $40 #CursedChildNYC https://t.co/pbs3wBh0aO

[Gabriel Chiappa @_gabrielchiappa]

Que reação é essa, mano? HAHAHA #BBB22

[Milena 🙂 @cruel2summer]

Que homem gosto mds.. #BBB22

[Gabriel Chiappa @_gabrielchiappa]

Temos um vencedor: Rodrigo jogador. #BBB22

[Gabriel Chiappa @_gabrielchiappa]

Finalmente um fósforo. #BBB22

[Gabriel Chiappa @_gabrielchiappa]

Eslovênia jogadora. #BBB22

[Gabriel Chiappa @_gabrielchiappa]

Gente, preciso de atualização aqui: o que é um hétero top? 😂 #BBB22

[Gabriel Chiappa @_gabrielchiappa]

@rafaeeuul demais.

[Gabriel Chiappa @_gabrielchiappa]

Curti o discurso do Luciano. #BBB22