hibranwar
Kursus → Modul 4: Workspace
Sesi 4 dari 7

Manajemen File

Sesi 4.4 · ~5 menit baca

Harga dari Kekacauan

Setiap content producer pernah begini: simpan file bernama final_draft.md, terus final_draft_v2.md, terus final_draft_FINAL.md, terus final_draft_FINAL_actually_final.md. Ini bukan lelucon. Ini hasil alami dari produksi konten tanpa sistem manajemen file. Dan waktu AI masuk ke gambar, kekacauannya berlipat ganda. Sekarang kamu punya file prompt, file output, file yang udah direview, dan beberapa versi dari masing-masing.

Produksi konten profesional butuh file yang terorganisir. Bukan karena organisasi itu mulia, tapi karena ketidakteraturan menghabiskan waktu kamu, menyebabkan error, dan bikin pipeline kamu ga mungkin di-scale.

Struktur file adalah arsitektur pipeline. Setiap folder di proyek kamu mewakili satu tahap di proses produksi. Input, prompt, raw output, output yang udah direview, final. Kalo kamu ga bisa melacak satu konten dari sumber ke publikasi cuma dengan mengikuti struktur folder, berarti strukturnya salah.

Struktur Proyek Standar

Proyek produksi butuh lima folder utama, masing-masing mewakili tahap pipeline, plus satu folder konfigurasi buat setting dan kredensial.

graph TD ROOT["nama-proyek/"] --> IN["inputs/"] ROOT --> PR["prompts/"] ROOT --> RAW["outputs/raw/"] ROOT --> REV["outputs/reviewed/"] ROOT --> FIN["outputs/final/"] ROOT --> CFG[".config/"] ROOT --> README["README.md"] ROOT --> ENV[".env"] ROOT --> GIT[".gitignore"] IN --> R1["research-brief.md"] IN --> R2["source-data.csv"] PR --> S1["system-prompt-v3.md"] PR --> S2["few-shot-examples.md"] RAW --> D1["2026-04-02-draft-001.md"] RAW --> D2["2026-04-02-draft-002.md"] REV --> RV1["2026-04-02-reviewed.md"] FIN --> F1["published-article.md"] style ROOT fill:#222221,stroke:#c8a882,color:#ede9e3 style IN fill:#191918,stroke:#6b8f71,color:#ede9e3 style PR fill:#191918,stroke:#c8a882,color:#ede9e3 style RAW fill:#191918,stroke:#c47a5a,color:#ede9e3 style REV fill:#191918,stroke:#8a8478,color:#ede9e3 style FIN fill:#191918,stroke:#6b8f71,color:#ede9e3

Konvensi Penamaan

Penamaan file yang konsisten itu bukan preferensi. Itu kebutuhan. Waktu kamu punya 200 file dalam satu folder, satu-satunya cara nemuin yang kamu butuhkan adalah penamaan yang bisa diprediksi. Dua aturan menghilangkan sebagian besar kekacauan penamaan.

Aturan Contoh Buruk Contoh Bagus Kenapa
Prefix tanggal buat output draft.md 2026-04-02-draft-001.md File terurut kronologis, versi jelas beda
Kebab-case semuanya My Blog Post.md my-blog-post.md Tanpa spasi berarti ga perlu escaping di terminal
Versi pake angka prompt-final.md system-prompt-v03.md Versi bernomor terurut dengan benar, "final" ga ada artinya
Prefix tipe buat prompt blog.md prompt-blog-review.md Tipe keliatan tanpa perlu buka filenya

Pake leading zero di nomor versi (v03 bukan v3) supaya sorting file berfungsi dengan benar. v10 cuma terurut setelah v9 kalo kamu pake v09.

File README

Setiap root proyek butuh file README.md. File ini menjawab tiga pertanyaan buat siapa pun yang buka proyek (termasuk kamu sendiri di masa depan, enam bulan dari sekarang): Apa ini? Apa isi tiap folder? Gimana cara jalanin pipeline-nya?

Ga perlu panjang. Sepuluh baris cukup. Tapi sepuluh baris itu mencegah kebingungan yang menumpuk waktu proyek tumbuh melebihi apa yang bisa kamu simpan di kepala.

Scaling Struktur

Struktur lima folder ini cukup buat proyek tunggal. Waktu kamu jalanin batch operation yang menghasilkan puluhan konten, kamu tambah satu layer: folder tipe konten di dalam setiap folder tahap.

Buat proyek yang menghasilkan blog post dan deskripsi produk sekaligus:

Struktur tumbuh bersama proyek. Mulai simpel. Tambah kedalaman hanya waktu struktur flat jadi ga praktis. Kompleksitas prematur sama berbahayanya dengan optimasi prematur.

Bacaan Lanjutan

Tugas

Desain struktur folder buat proyek produksi AI pertama kamu. Bikin di VS Code. Sertakan folder buat: input, prompt, raw output, output yang udah direview, dan final. Bikin README.md di root yang mendokumentasikan apa isi tiap folder. Beri nama tiga file hipotetis buat tiap folder pake konvensi penamaan di atas. Struktur ini akan dipake sepanjang sisa kursus.