Editor markdown dibuat untuk catatan, bukan untuk agen

12 September 2026 · ThreadGrab

Ada satu kategori file yang tidak ada lima tahun lalu dan kini berada di pusat cara perangkat lunak ditulis. Bukan kode sumber. Ini tumpukan markdown yang memberi tahu coding agent apa yang harus dilakukan: CLAUDE.md, AGENTS.md, aturan, skills, sub-agen, perintah. Pada 2 September 2026, Kunihiro Ishiguro menerbitkan tulisan berjudul "Markdown Editors Weren't Built for Coding Agents, So I Made One" dan merilis editor yang ia inginkan: Marginal.

Tulisan itu dibuka dengan masalah yang saya kenali dari arah yang sama sekali berbeda. Penulisnya bercerita bahwa setelah memakai coding agent secara intensif, terutama Claude Code, ia berakhir dengan "jumlah dokumen markdown yang luar biasa banyak, kadang lebih dari 100, tersebar di berbagai subdirektori", dan "sama sekali kehilangan jejak skills mana yang tersedia, sub-agen mana yang terpasang, dan aturan mana yang berlaku".

Saya menulis tentang pengarsipan konten sosial, jadi minat saya di sini bukan editornya. Melainkan kelas file-nya. File instruksi itu adalah catatan tentang apa yang pernah diberitahukan kepada sebuah AI, dan hampir tidak ada orang yang menyimpan salinan bertanggalnya.

Apa yang sebenarnya dilakukan Marginal secara berbeda

Sebagian besar editor markdown memperlakukan file sebagai file. Anda memberinya sebuah folder dan ia menampilkan isinya. Marginal membalik itu: Anda memberi tahu coding agent mana yang Anda pakai, dan ia menemukan file yang benar-benar dibaca agen itu, di mana pun file itu berada.

Perbedaan itulah keseluruhan produknya. Keluhan penulisnya tepat - sebagian file instruksi bersifat lokal untuk proyek, sebagian dibagikan lewat akun di mesin tertentu, dan tiap agen mencari di jalur yang berbeda. Tampilan folder generik tidak bisa menjawab "aturan mana yang berlaku sekarang", karena jawabannya tersebar di setidaknya tiga lokasi dan bergantung pada agen mana yang sedang berjalan.

Agen yang didukung dan file yang dibaca masing-masing

Menurut panduan Marginal, agen dipilih di Pengaturan pada bagian AI, dengan Claude Code sebagai bawaan. Panduannya mencantumkan setiap folder yang dibaca tiap agen:

Baca tabel itu dua kali dan sesuatu yang jelas muncul. Empat dari enam agen membaca file bernama AGENTS.md, dan semuanya membacanya dari tempat berbeda. Nama file yang sama berarti hal berbeda tergantung siapa yang melihat. Jika Anda memelihara instruksi untuk lebih dari satu agen, Anda memelihara dokumen yang saling tumpang tindih tanpa indeks bersama - persis keadaan yang digambarkan penulisnya.

Fitur lainnya, secara singkat

• Daftar file di subfolder - opsional, untuk saat markdown Anda tersebar di folder bertingkat. Saring berdasarkan potongan jalur, termasuk / untuk mencocokkan direktori.
• Dua antarmuka AI - pilih teks dan tekan ⌘K untuk penulisan ulang sebaris yang muncul sebagai diff yang Anda terima atau tolak sebagai satu langkah undo; atau tekan ⌘J untuk panel terminal dan jalankan claude atau codex di sana.
• Muat ulang langsung saat agen menulis - ketika agen menulis ke file yang sedang Anda buka, Marginal menyadarinya dan menawarkan memuat ulang, dan skill yang baru disimpan muncul di bilah samping tanpa membuka ulang folder.
• Baca dan ekspor - klik dua kali file di Finder untuk membukanya dalam mode baca, lalu ekspor sebagai PDF atau HTML.
• Mode edit Emacs dan Vim dengan pemetaan tombol khusus, serta sepuluh tema bawaan dalam lima pasang terang/gelap (Marginal, GitHub, Solarized, Zenburn, Dracula), plus tema JSON dari pengguna yang dimuat tanpa memulai ulang.

Satu detail implementasi layak disebut karena menjelaskan kualitas ekspornya: satu mesin markdown Rust menggerakkan editor, pratinjau, ekspor PDF, dan konteks yang diberikan ke AI. Satu pengurai, empat pengguna.

Model harganya lebih ramah dari kebanyakan

Marginal punya satu paket, dua cara bayar: US$ 10 per bulan, atau US$ 96 per tahun yang berarti US$ 8 per bulan, dengan uji coba 14 hari tanpa kartu. Tapi pembagian antara gratis dan berbayar adalah bagian menariknya, karena garisnya ditarik di penulisan, bukan di pembacaan:

Konsekuensi yang dinyatakan saat langganan berakhir adalah hanya-baca, bukan terkunci: "File Anda adalah markdown biasa di disk Anda, dan tidak pernah disandera." AI berjalan dengan kunci Anda sendiri dari Anthropic, OpenAI, Google, xAI atau Alibaba Cloud, disimpan di keychain sistem dan bukan di server vendor, dan situsnya menyatakan dengan jelas bahwa langganan tidak pernah membatasi AI.

Mengapa file instruksi agen layak disimpan bertanggal

Inilah bagian yang menyambung ke pekerjaan saya sebenarnya. Marginal menjawab "apa yang berlaku sekarang". Ia tidak menjawab "apa yang berlaku saat itu terjadi", dan keduanya pertanyaan berbeda.

Pertimbangkan isi sebuah CLAUDE.md atau AGENTS.md setelah beberapa bulan pemakaian nyata. Isinya menumpuk aturan yang harus diikuti agen, konvensi proyek, pola yang dilarang, deploy yang tidak boleh Anda sentuh. Ia diedit terus-menerus, sering oleh agen itu sendiri. Enam bulan dari sekarang, ketika Anda membaca commit, file rencana, atau audit keamanan yang dihasilkan agen, file instruksi sebagaimana adanya saat itu adalah separuh catatan yang hilang. Versi yang Anda pegang hari ini adalah dokumen berbeda yang kebetulan memakai nama file yang sama.

Ini mode kegagalan yang sama dengan mengarsipkan thread berdasarkan handle-nya. Keduanya kasus di mana yang Anda simpan masih bisa diakses, tetapi mengarah ke hal lain. Notula mencakup arah pembacaan - memastikan markdown Anda cukup bersih agar bisa dipakai agen. Marginal mencakup arah penyuntingan. Tidak ada yang mencakup arah historis, yang bukan produk siapa pun dan masalah semua orang.

Menangkap keadaan agen bersama konten yang dihasilkannya

Anda tidak perlu alat khusus untuk ini, dan itulah kabar baiknya. File instruksi adalah markdown biasa di disk Anda, jadi salinan bertanggal hanyalah salinan. Pekerjaannya adalah memutuskan apa yang di-snapshot dan di mana menyimpannya.

Skrip snapshot minimal - letakkan di samping proyek dan jalankan setiap kali agen melakukan sesuatu yang mungkin perlu Anda jelaskan nanti:

#!/usr/bin/env bash
# Snapshot the coding-agent instruction files for a project.
set -euo pipefail

PROJECT_DIR="${1:-.}"
STAMP="$(date -u +%Y-%m-%dT%H-%M-%SZ)"
OUT="agent-state/${STAMP}"

mkdir -p "$OUT"

# Instruction files this project may use, across the agents Marginal lists.
for f in CLAUDE.md AGENTS.md QWEN.md GEMINI.md; do
  if [ -f "$PROJECT_DIR/$f" ]; then
    cp "$PROJECT_DIR/$f" "$OUT/$f"
  fi
done

# Cursor rules, if present.
if [ -d "$PROJECT_DIR/.cursor/rules" ]; then
  cp -R "$PROJECT_DIR/.cursor/rules" "$OUT/cursor-rules"
fi

# Skills and commands, if present.
for d in .claude/skills .claude/commands .codex/prompts; do
  if [ -d "$PROJECT_DIR/$d" ]; then
    mkdir -p "$OUT/$(dirname "$d")"
    cp -R "$PROJECT_DIR/$d" "$OUT/$d"
  fi
done

echo "Snapshot written to $OUT"

Jalankan dengan direktori proyek sebagai argumen dan Anda mendapat folder bertanda waktu yang berisi persis instruksi yang berlaku saat itu. Commit snapshot-nya, atau simpan di luar git jika aturannya memuat hal sensitif - apa pun caranya, file itu ada sebagai berkas, bukan sebagai ingatan bahwa Anda pernah berniat memeriksanya.

Nama file adalah bagian yang mudah. Separuh lain dari arsip adalah mengetahui apa yang sebenarnya dikatakan konten yang Anda tangkap, dan untuk itu pola provenans berperan:

# Record the instruction version alongside what the agent produced.
# Keep this in the same directory as the artifact it explains.
cat > artifact.provenance.txt <<EOF
agent: claude-code
instruction_files: CLAUDE.md AGENTS.md
captured_at: $(date -u +%Y-%m-%dT%H:%M:%SZ)
source_url: https://github.com/org/repo/commit/abc1234
snapshot_dir: agent-state/$(date -u +%Y-%m-%dT%H-%M-%SZ)
note: rules in effect at generation time, not today's rules
EOF

Inti file kedua adalah baris terakhirnya. Arsip apa pun yang menyimpan artefak tanpa aturan yang membentuknya akan salah dibaca nanti - bukan karena ada yang lalai, tetapi karena aturannya berubah diam-diam dan tidak ada yang mencatat perubahan itu.

Rangkaiannya, dari ujung ke ujung

Susun potongannya berurutan dan muncul pola yang jauh lebih tua daripada coding agent:

1. Penemuan - temukan file yang benar-benar berlaku. Marginal, di dalam editor.
2. Snapshot - salin dengan tanggal, agar versinya bertahan melewati suntingan berikutnya.
3. Penangkapan - simpan artefak yang dihasilkan agen bersama aturan yang menghasilkannya.
4. Verifikasi ulang - sebelum mengutip sesuatu dari berbulan-bulan lalu, periksa snapshot-nya, bukan file saat ini.

Langkah 1 kini menjadi produk yang dijual seseorang seharga US$ 10 per bulan, yang menunjukkan masalahnya nyata dan umum. Langkah 2 sampai 4 masih manual, dan itulah yang menentukan apakah arsip Anda masih berguna setahun lagi.

Di mana ThreadGrab berperan

ThreadGrab menangkap konten publik X, Bluesky dan LinkedIn menjadi Markdown dengan tanda waktu dan URL sumber, sehingga yang Anda simpan mempertahankan identitas yang dimilikinya saat Anda menyimpannya. Ini pengarsip konten sosial, bukan alat pengembang, dan tidak membaca repositori Anda. Yang ia bagi dengan masalah Marginal adalah prinsipnya: salinan yang Anda kendalikan, ditandai dengan kapan Anda mengambilnya, adalah satu-satunya versi yang masih bermakna seperti semula.

Jika Anda memelihara instruksi agen, pertanyaannya bukan apakah Anda akan butuh versi lama. Melainkan apakah Anda akan memilikinya.

Pertanyaan umum

Terakhir diverifikasi: 12 September 2026. Sumber utama: Marginal, "Markdown Editors Weren't Built for Coding Agents, So I Made One" oleh Kunihiro Ishiguro (2 September 2026) di marginal.md/blog.html; panduan Marginal di marginal.md/docs termasuk halaman coding agents dan tabel file instruksi per agen; serta halaman harga di marginal.md/pricing.html untuk paket US$ 10 bulanan / US$ 96 tahunan, ketentuan uji coba 14 hari, pembagian fitur gratis dan berbayar, dan penyedia kunci API yang didukung. Kiriman tulisan itu di Hacker News (3 September 2026) dikutip untuk rendahnya volume diskusi. Harga dan daftar agen yang didukung adalah detail yang paling mungkin berubah; periksa di halaman vendor sebelum membeli.