GDOC-SURGICAL · EDIT GOOGLE DOC TANPA NIMPA

    Biar AI update Google Doc lo, tanpa ngehapus kerjaan orang lain.

    AI jago nulis ulang dokumen. Masalahnya, dia nulis ulang semuanya, termasuk editan dan komentar rekan lo. gdoc-surgical cuma ngubah bagian yang lo minta.

    PRD Refund · Google Doc
    Bagian 3 · Target

    Refund diproses otomatis buat pesanan yang gagal dikirim.

    Target rilis: Q3

    Diubah AI

    Target rilis: Q4

    Komentar rekan lo, kemarin

    Batas refund-nya 30 hari ya, udah gw tambahin di bawah.

    Satu baris berubah. Komentar dan tambahan rekan lo tetap di tempatnya.

    Gratis di GitHub: github.com/BrianArfi/gdoc-surgical (publik, lisensi Apache-2.0).

    GratisVersi 1.0.0Apa yang baru

    Kabar baiknya

    Sekarang AI yang nyusun dan update dokumen lo.

    PRD, proposal, SOP. Lo tinggal bilang apa yang berubah, AI yang nulis.

    Masalahnya

    Tapi pas AI update Google Doc bareng, semuanya ditulis ulang.

    • Siangnya

      AI update PRD pagi tadi. Siangnya rekan lo nanya, "Editan gw ke mana?"

    • Pas review

      Komentar lo lepas dari teksnya. Di sampingnya cuma ada tulisan "Original content deleted".

    • Di dokumen

      Gambar hilang, lebar kolom tabel balik ke awal. Gak ada yang dikasih tau.

    • Jam 11 malam

      Lo harus bongkar riwayat versi satu-satu buat nyari editan rekan lo, terus nempel ulang manual.

    Solusinya

    gdoc-surgical cuma ngubah kalimat, baris, atau sel yang lo minta.

    Sisanya tetap persis kayak semula: tulisan rekan lo, komentar, saran, gambar, dan akses berbagi.

    Bedanya

    Sebelum dan sesudah.

    Sebelum

    • AI nulis ulang satu dokumen penuh.
    • Editan rekan dari kemarin ketimpa.
    • AI bilang "udah diganti", padahal kata yang dicari gak ada.
    • Nomor versi mundur tanpa ada yang sadar.

    Sesudah

    • AI cuma ngubah bagian yang lo sebut.
    • Tulisan orang lain tetap utuh.
    • Kalau gak ada yang ketemu, dia bilang gagal.
    • Nomor versi di tabel revisi cuma bisa naik.

    Cara kerjanya

    Tiga langkah, udah.

    1. Minta AI ngubah satu bagian

      Misalnya "ganti target Q3 jadi Q4" atau "tambah satu baris di tabel revisi".

    2. AI baca dokumen yang sekarang dulu

      Bukan salinan lama. Dia cari bagiannya dulu. Buat hapus baris atau ganti sel, dia ngecek isinya masih cocok, kalau gak, dia berhenti.

    3. Buka link dokumennya

      Cuma bagian itu yang berubah. Kerjaan orang lain gak disentuh.

    Yang bisa dia lakuin

    Edit yang presisi, dengan pengaman di tiap langkah.

    Perintah yang paling bisa ngerusak, kayak hapus baris, gak jalan tanpa pengaman.

    • 01

      Cuma bagian yang lo sebut yang berubah

      Editan rekan, komentar, saran, gambar, dan akses berbagi tetap utuh.

      Lo bilang ke AI"Ganti target rilis di bagian 3 jadi Q4."
    • 02

      Ganti satu istilah di semua tempat, dan tau berapa yang kena

      Dia laporin berapa yang diganti. Kalau nol, dia bilang gagal, bukan pura-pura berhasil.

      "Poin Kilat"."Poin Instan", di semua tempat, lengkap sama jumlahnya.
    • 03

      Update tabel tanpa ngerusak tabelnya

      Tambah baris, ganti satu sel, atau hapus satu baris. Sisa tabelnya tetap kayak semula.

      Lo bilang ke AI"Tambah baris v1.3 di tabel revisi: tanggal hari ini, nama gw, 'Tambah aturan refund'."
    • 04

      Gak salah baris, walau dokumennya baru diedit orang

      Hapus baris wajib nyebut teks yang harus ada di situ, dan ganti sel bisa juga. Kalau gak cocok, gak ada yang berubah.

      "Status: Pending"."Status: Approved", cuma kalau isinya masih "Pending".
    • 05

      Nomor versi gak bisa mundur

      Nulis v1.2 di tabel revisi yang udah punya v1.3 ditolak, lengkap sama nomor berikutnya yang bener.

      "Tambah v1.2"."Ditolak. Tabelnya udah sampai v1.3, berikutnya minimal v1.4."
    • 06

      Tambah link tanpa ngubah tulisannya

      Tulisannya tetap sama, sekarang bisa diklik. Termasuk yang ada di dalam tabel.

      Lo bilang ke AI"Pasang link tiketnya di tiap tulisan 'Q3 Roadmap'."
    • 07

      Tambah bagian atau tabel baru di akhir dokumen

      Judul, poin, dan teks biasa masuk dengan format yang bener. Pas buat update mingguan atau catatan keputusan.

      Lo bilang ke AI"Tambah bagian 'Keputusan' di akhir: kita rilis tanggal 30."
    • 08

      Gak ada "berhasil" tanpa bukti

      Tiap laporan berhasil bawa link dokumennya. Kalau Google gak ngebalikin konfirmasi, dia lapor gagal.

      AI bilang "berhasil" tanpa bukti.Tiap laporan berhasil bawa link dokumennya, dan kalau Google gak ngebalikin konfirmasi, dia lapor gagal.
    Dipakai buatUpdate status di PRDTambah baris di tabel revisiTandai approval di tabel sign-offPasang link tiket di dokumenTambah update mingguan di akhir dokumenGanti nama fitur di seluruh dokumenHapus baris draft yang udah gak dipakai
    Sekali AI nimpa Google Doc yang lagi gw review. Editan rekan gw ilang dari dokumennya, dan gw ngabisin sejam balikin dari riwayat versi. Sejak itu, tiap update dokumen lewat alat ini.
    Brian Arfi FaridhiBrian Arfi FaridhiProduct Director di Merit · AI Builder · Pembuat alat ini

    Lihat jalannya

    Dokumen contoh setelah replace: Q3 2026 jadi Q4 2026 di tabel dan di kalimat, sementara kalimat Raka dan komentarnya tetap ada

    Q3 jadi Q4 di tabel dan di kalimatnya. Kalimat Raka dan komentarnya dari kemarin tetap di tempatnya.

    Terminal: gdoc-surgical read menampilkan isi dokumen berindeks, lalu replace melaporkan 1 ketemu di paragraf dan 3 yang diganti

    Dia nyebut dulu berapa yang ketemu, baru nulis, lalu lapor berapa yang diganti.

    Perintah dan keluarannya asli dari gdoc-surgical, dijalankan ke dokumen contoh.

    Keraguan yang wajar

    Yang biasanya ditanyain dulu.

    Perlu bisa coding?
    Sedikit, cuma pas pasang. Langkahnya sekali jalan, ada di bagian teknis. Setelah itu lo tinggal minta ke AI lo, misalnya Claude, pakai bahasa biasa.
    Beneran gratis?
    Iya. Lisensinya Apache-2.0, boleh dipakai buat kerjaan kantor.
    Dokumen gw dikirim ke mana?
    Gak ke mana-mana. Alatnya jalan di komputer lo dan ngomong langsung ke Google pakai akun lo sendiri. Gak lewat server gw.
    Gimana kalau orang lain ngedit pas AI lagi jalan?
    Posisi isi dokumen bisa geser. Makanya hapus baris wajib nyebut teks yang harus ada di situ, dan ganti sel bisa juga. Kalau gak ketemu, gak ada yang berubah.
    Bisa bikin dokumen baru atau baca komentar?
    Gak. Dia cuma ngedit dokumen yang udah ada. Gak bikin dokumen baru, gak nulis ulang satu dokumen, dan gak baca atau nyelesaiin komentar.

    gdoc-surgical

    Biarin AI ngerjain update-nya. Kerjaan tim lo tetap aman.

    Gratis, dan cukup dipasang sekali.

    Bagikan

    Kenal orang yang butuh ini? Kirim ke dia.

    Teks yang ikut kekirim

    Pernah minta AI update Google Doc, terus rekan lo nanya "editan gw ke mana?" AI nulis ulang satu dokumen penuh, termasuk editan dan komentar orang lain. gdoc-surgical bikin AI cuma ngubah kalimat, baris, atau sel yang lo minta. Sisanya tetap utuh. Gratis.

    brianarfi.com/gdoc

    Buat yang teknisCara pasang, kebutuhan, lisensi, dan changelog lengkap.

    Cara pasang

    Dari nol sampai jalan.

    Langkahnya diambil dari README repo-nya. Tinggal salin.

    1. Ambil repo-nya dan pasang dependensinya

      skills.items.gdoc-surgical.page.install.clone.body

      bash
      git clone https://github.com/BrianArfi/gdoc-surgicalcd gdoc-surgicalpip install -r requirements.txt
    2. Sambungin akun Google

      Bikin OAuth client di Google Cloud Console (APIs and Services, Credentials, OAuth client ID, Desktop app), unduh JSON-nya, dan nyalain Google Docs API plus Google Drive API. Token-nya disimpan di ~/.config/gdoc-surgical/default.json dan nge-refresh sendiri.

      bash
      python3 gdoc_surgical.py auth --credentials client_secret.json
    3. Selalu baca dulu

      read dan list-tables nunjukin index tiap paragraf dan tabel, jadi lo tahu targetnya. replace kena SEMUA kemunculan, jadi panjangin teks yang dicari sampai unik.

      bash
      python3 gdoc_surgical.py read         --id DOC_IDpython3 gdoc_surgical.py list-tables  --id DOC_ID
    4. Opsional: pakai sebagai skill agent

      SKILL.md berisi aturan mainnya dalam format yang dibaca Claude Code dan harness sejenis.

      bash
      cp -r gdoc-surgical ~/.claude/skills/

    Kebutuhan

    • Python 3 dan pip.
    • Akun Google, plus file client_secret.json dari Google Cloud buat login OAuth.
    • Opsional: Claude Code atau agent lain yang bisa pakai skill, supaya AI yang jalanin perintahnya.
    • Tes jalan tanpa jaringan dan tanpa kredensial: python3 tests/test_gdoc_surgical.py

    Lisensi

    Apache-2.0

    Versi, lisensi, dan changelog dicek ulang ke sumbernya 2026-10-01

    Changelog

    Apa yang berubah, versi demi versi.

    Disalin dari CHANGELOG produknya, dicek 2026-09-30. Versi yang belum terbit gak ditampilkan.

    Versi 1.0.0Terbaru22 Sep 2026

    Added

    • Targeted, in-place edits to a Google Doc, so hand edits, comments, images and sharing survive: read, list-tables, replace, linkify, append, insert-table, insert-row, set-cell and delete-row.
    • auth command and named token profiles (--account, --token, GDOC_SURGICAL_TOKEN).
    • Guards against a shifted index: --expect on delete-row and set-cell, and an occurrence count before replace writes (exit 2 on zero matches).
    • A revision table cannot go backwards: a version at or below one already present is refused unless --allow-version-regression is passed.
    • A write is reported as success only once a document id comes back.
    • SKILL.md for agent harnesses, offline tests in tests/test_gdoc_surgical.py, MIT license.