# Prompt untuk Memahami Codebase Baru dengan AI, Gratis

> Prompt untuk memahami codebase baru di Claude Code, Cursor, dan ChatGPT. Gratis, read-only, memetakan repository asing dengan path file di setiap klaim.

URL: https://www.matthewswong.com/id/toolkit/codebase-onboarding-prompt/

- Author: Matthews Wong (https://www.matthewswong.com/id/about/)
- Diperbarui: 13 November 2026

> **Poin utama:** Tempel prompt ini sebelum meminta agent mengubah repository yang belum pernah dilihatnya. Agent membaca instruksi, manifest, entry point, satu fitur dari ujung ke ujung, test, dan commit terbaru, lalu menulis satu laporan: fungsi sistem, cara menjalankan dan mengetesnya, peta modul, alur request, konvensi, area berisiko, dan pertanyaan terbuka. Tidak ada file yang diubah.

- Jenis: Prompt
- Bisa dipakai di: Claude Code, Cursor, Claude.ai, ChatGPT
- Unduh: [codebase-onboarding-prompt.md](https://www.matthewswong.com/downloads/toolkit/codebase-onboarding-prompt/codebase-onboarding-prompt.md) (2.3 KB)
- Lisensi: Bebas dipakai, diubah, dan dibagikan, termasuk untuk pekerjaan.

## File-nya

Persis isi unduhannya. Baca dulu, lalu salin atau unduh.

### codebase-onboarding-prompt.md

```markdown
You are onboarding onto a repository you have never seen. Your job is to map it, not to change it.

Repository: [REPOSITORY PATH OR URL]
What I plan to work on next: [THE AREA OR TASK I CARE ABOUT, OR "NOT DECIDED YET"]

## Rules

- Read-only. Do not create, edit, move or delete any file. Do not install dependencies, run migrations, commit or push.
- You may run commands that only read: listing files, searching, printing git history. Ask before running anything else, including the test suite.
- Report only what you saw in a file, and give the path for every claim. If you inferred something, label it "inferred".
- If you cannot open the repository, say so and ask me to paste the file tree, the README and the manifest files. Do not describe a codebase you have not read.

## Read in this order

1. README, CONTRIBUTING, and any agent instruction files (CLAUDE.md, AGENTS.md, editor rules).
2. Manifests and build files: package.json, pyproject.toml, pom.xml, go.mod, Makefile, Dockerfile, CI workflows.
3. The entry points: where the process starts, and where routes, commands or jobs are registered.
4. One complete feature, followed end to end from the entry point to the data store and back.
5. The tests: where they live, how they are run, what they cover.
6. The last 20 commits: what changes often, and how commits are written.

## Output

Write one Markdown report with these sections, in this order:

1. **What the system does**: three to five sentences on who uses it and for what.
2. **Run and test**: the exact commands to install, run, test, lint and build, each with the file that declares it. Mark any you did not find.
3. **Module map**: a table of the main directories or modules, with one line each on what it owns.
4. **How a request flows**: the feature you traced, as numbered steps with file paths.
5. **Conventions to follow**: naming, folder layout, error handling, test style and commit style, each with one example file.
6. **Risky areas**: code with no tests, very large files, shared state, authentication, migrations, anything a small change could break.
7. **Open questions**: what the code could not tell you, phrased as questions for me.

If I named an area or task above, end with the five files I should read first for it, and why.

Stop after the report. Do not propose a refactor and do not start the task.
```

## Pakai saat

- Anda baru bergabung di sebuah proyek dan perlu tahu cara kerjanya sebelum perubahan pertama.
- Anda mewarisi repository dengan README seadanya dan tidak ada lagi orang yang bisa ditanya.
- Anda akan memberi agent sebuah tugas di kode yang belum dibacanya.
- Anda me-review pull request di service yang bukan wilayah kerja Anda.

## Dari unduh sampai jalan

1. **Buka agent di root repository.** Jalankan Claude Code atau Cursor di folder proyek supaya agent bisa membaca file sendiri. Di jendela chat tanpa akses ke kode, lampirkan atau tempel struktur folder, README, dan file manifest; prompt ini menyuruh agent memintanya.
2. **Isi dua placeholder.** Isi path atau URL repository, lalu area atau tugas yang Anda pedulikan. Kalau belum diputuskan, tulis saja begitu. Menyebut tugas menambah daftar penutup berisi lima file yang perlu dibaca lebih dulu.
3. **Cocokkan laporan dengan kodenya.** Setiap klaim membawa path file. Buka tiga di antaranya dan jalankan perintah instal serta test yang tercantum di laporan. Perintah yang salah lebih murah ditemukan sekarang daripada di tengah pengerjaan tugas.
4. **Jawab pertanyaan terbuka, lalu simpan laporannya.** Bagian terakhir berisi hal yang tidak bisa dijawab kode. Jawab pertanyaan itu, lalu simpan laporan yang sudah dikoreksi di repository atau pindahkan perintah dan konvensinya ke CLAUDE.md, supaya sesi berikutnya berangkat dari sana.

## Kenapa ditulis seperti ini

- **Read-only adalah aturan pertama.** Prompt ini melarang membuat, mengubah, atau menghapus file, menginstal dependency, menjalankan migration, dan melakukan commit. Agent yang mulai memperbaiki sambil menjelajah meninggalkan diff yang tidak Anda minta dan peta yang tidak bisa dipercaya.
- **Urutan baca yang tetap.** Instruksi, manifest, entry point, satu fitur dari ujung ke ujung, test, lalu 20 commit terakhir. Tanpa urutan, agent membaca file apa pun yang terbuka lebih dulu dan menggambarkan sudut itu seolah-olah seluruh sistem.
- **Setiap klaim butuh path.** Agent hanya melaporkan apa yang dilihatnya di file dan menandai sisanya sebagai inferred. Itulah yang membuat laporan bisa dicek acak dalam beberapa menit, dan mencegah agent menggambarkan arsitektur yang tidak ada di kode.
- **Satu request yang ditelusuri, bukan daftar folder.** Laporan mengikuti satu fitur dari entry point ke data store dan kembali, berupa langkah bernomor dengan path file. Daftar folder memberi tahu letak file. Request yang ditelusuri memberi tahu ke mana perubahan Anda harus masuk.
- **Area berisiko dan pertanyaan terbuka.** Dua bagian terakhir menyebut kode yang bisa rusak oleh perubahan kecil dan hal yang tidak terjawab oleh kode. Bagian inilah yang biasanya tidak ada di README, dan yang Anda perlukan sebelum memperkirakan sebuah tugas.

## Yang sering salah

- Laporan ini adalah peta, bukan bukti. Agent bisa salah membaca alur, jadi jalankan perintah yang tercantum dan buka beberapa path-nya sebelum Anda mengandalkannya.
- Di monorepo besar, satu kali jalan hasilnya dangkal. Arahkan placeholder repository ke satu service atau package, lalu jalankan prompt ini sekali per area.
- Di jendela chat tanpa akses file, agent hanya tahu apa yang Anda tempel. Laporan yang dibangun dari README saja hanya mengulang README.
- Prompt ini tidak menjalankan aplikasi atau test kecuali Anda izinkan, jadi perintah yang tercantum bisa saja dideklarasikan di file tetapi tetap rusak.

## FAQ

### Prompt apa yang dipakai untuk memahami codebase baru dengan AI?

Pakai prompt yang menetapkan urutan baca, meminta laporan dengan bentuk tetap, dan melarang perubahan. Prompt ini membaca instruksi, manifest, entry point, satu fitur dari ujung ke ujung, test, dan commit terbaru, lalu melaporkan fungsi sistem, cara menjalankannya, peta modul, satu request yang ditelusuri, konvensi, area berisiko, dan pertanyaan terbuka.

### Apakah prompt ini akan mengubah file saya?

Prompt ini melarang agent membuat, mengubah, memindahkan, atau menghapus file, menginstal dependency, menjalankan migration, commit, atau push, serta mewajibkannya bertanya sebelum menjalankan apa pun selain perintah read-only. Prompt adalah instruksi, bukan kunci, jadi biarkan permintaan persetujuan di agent Anda tetap aktif bila ingin jaminan yang pasti.

### Apakah bisa dipakai di ChatGPT atau Claude.ai tanpa akses ke repository?

Bisa, tetapi hasilnya kurang dalam. Prompt ini menyuruh agent mengatakan bahwa ia tidak bisa membuka repository dan meminta struktur folder, README, serta file manifest. Laporan hanya mencakup apa yang Anda tempel, jadi tambahkan entry point dan file satu fitur supaya alur request-nya berguna.

### Apa bedanya dengan meminta agent menjelaskan proyek ini?

Pertanyaan terbuka menghasilkan ringkasan README dan nama folder. Prompt ini meminta perintah beserta file yang mendeklarasikannya, satu request yang ditelusuri lewat file sungguhan, dan daftar hal yang tidak terjawab oleh kode. Bagian itulah yang bisa Anda periksa dan tindak lanjuti.

## Pelajari apa yang dikemas file ini

- Pelajaran gratis: [CLAUDE.md Adalah: Contoh File, Lapisan, dan Urutan Memuatnya](https://www.matthewswong.com/id/learn/claude-code-tips/claude-md-file-example/)
- Pelajaran gratis: [Menaruh Instruksi di Claude Code: Panduan Memilih yang Tepat](https://www.matthewswong.com/id/learn/claude-code-tips/where-to-put-instructions-claude-code/)
- Pelajaran gratis: [Cara Hemat Token Claude Code: Konteks, Compaction, dan Scope](https://www.matthewswong.com/id/learn/claude-code-tips/save-tokens-claude-code/)
- [Onboarding AI Coding Agent ke Codebase yang Asing](https://www.matthewswong.com/id/blog/ai-agent-onboarding-unfamiliar-codebase/)
- [Context Engineering untuk AI Coding Agent di Monorepo](https://www.matthewswong.com/id/blog/context-engineering-monorepo-ai-agents/)
- [How Claude Code Works: Agentic Coding Explained](https://www.matthewswong.com/id/blog/how-claude-code-works-agentic-coding/)
- [Cara Menulis CLAUDE.md yang Meningkatkan Output AI](https://www.matthewswong.com/id/blog/writing-claude-md-memory-guide/)

[Semua item toolkit](https://www.matthewswong.com/id/toolkit/)

---

- HTML version: https://www.matthewswong.com/id/toolkit/codebase-onboarding-prompt/
- English: https://www.matthewswong.com/en/toolkit/codebase-onboarding-prompt/
- Site index for agents: https://www.matthewswong.com/llms.txt
- Sitemap: https://www.matthewswong.com/sitemap.xml
- API description (OpenAPI): https://www.matthewswong.com/openapi.json
