Saya merombak situs [Neotoma](https://neotoma.io). Dinding teks satu halaman lama kini menjadi presentasi visual yang didukung oleh [dokumentasi lengkap](https://neotoma.io/docs), panduan integrasi khusus alat, dan [penyelaman mendalam arsitektur](https://neotoma.io/architecture). Sebagian besar perubahan berasal dari sesuatu yang dikatakan atau terjebak oleh penguji selama rilis pengembang.

![Tangkapan layar: Pahlawan laman beranda Neotoma — prop nilai dan sesi agen tanpa lapisan status](/images/posts/neotoma-site-overhaul-home-hero.png "tangkapan layar")

## Apa yang disampaikan oleh masukan tersebut kepada saya

Sejak mengumumkan [rilis pengembang](/posts/neotoma-developer-release), saya telah mengumpulkan masukan dari sekitar selusin penguji di seluruh panggilan, chat, email, dan rekaman layar. Sentimennya sangat menggembirakan. Seseorang menyebutnya sebagai "masalah yang sangat relevan" dan menyatakan bahwa "kebanyakan orang sedang menyelesaikan masalah mereka sendiri saat ini." Yang lain mengatakan sepertinya masalah ini layak untuk dipecahkan. Orang lain baru saja dipompa ke alam liar.

Namun masukan yang paling berguna adalah tentang di mana orang mengalami kebuntuan:

### "Untuk siapa ini dan mengapa saya menggunakannya?"

Banyak orang menanyakan hal ini secara langsung. Situs lama dipimpin dengan arsitektur dan abstraksi. Penguji menginginkan rasa sakit yang akut dan spesifik terlebih dahulu. Ada yang membandingkannya dengan menjual vitamin, bukan obat penghilang rasa sakit. Yang lain bertanya langsung: "Apakah saya salah satu dari orang-orang yang melakukan hal ini?" Situs ini perlu menjawab pertanyaan itu dalam beberapa detik pertama.

Halaman kasus penggunaan baru untuk [insinyur infrastruktur AI](https://neotoma.io/ai-infrastructure-engineers), [pembuat sistem agen](https://neotoma.io/agentic-systems-builders), dan [operator individu asli AI](https://neotoma.io/ai-native-operators), ditambah [perbandingan model memori](https://neotoma.io/memory-models), adalah respons langsung.

### "Apakah ini dimaksudkan untuk menggantikan memori saya yang ada, atau tetap berdampingan?"

Seorang penguji teknis bertanya apakah Neotoma harus menjadi sistem memori utama atau berdampingan dengan memori otomatis Claude Code. Yang lain bertanya bagaimana cara kerja penyerapan: apakah itu regex, evaluasi AI, atau agen yang mengisi parameter alat? Situs lama tidak membahas semua ini. Arsitektur dan mekaniknya tersebar di dokumen README dan repo.

[Halaman model memori](https://neotoma.io/memory-models) dan [panduan pengembang](https://neotoma.io/developer-walkthrough) yang baru menjawab kedua pertanyaan tersebut.

### "Bagaimana cara mengaturnya dengan alat saya?"

Salah satu penguji menjalankan Neotoma dengan CLI tetapi bertanya "jadi ini tidak berfungsi dengan OpenClaw?" karena daftar klien di situs tidak jelas. Satu lagi kesalahan modul tidak ditemukan saat mencoba memulai API. Sepertiga menghabiskan satu jam membaca dokumen di VM baru dan menandai tautan rusak di indeks dokumentasi ditambah popup izin macOS yang tidak terduga. Petunjuk penyiapan terkubur dan bervariasi berdasarkan alat, dan cuplikan pemasangan situs tidak memiliki tautan langsung ke apa yang terjadi setelah init.

[Halaman instalasi](https://neotoma.io/install) baru dan panduan integrasi untuk [Cursor](https://neotoma.io/neotoma-with-cursor), [Claude](https://neotoma.io/neotoma-with-claude), [Claude Code](https://neotoma.io/neotoma-with-claude-code), [ChatGPT](https://neotoma.io/neotoma-with-chatgpt), [Codex](https://neotoma.io/neotoma-with-codex), dan [OpenClaw](https://neotoma.io/neotoma-with-openclaw) mengatasi hal ini.

Sinyal positif di balik semua ini: beberapa penguji membuat Neotoma berfungsi dan memverifikasi bahwa Neotoma disimpan dan diambil dengan benar. Seseorang mengonfirmasi bahwa itu "menyimpan barang ketika saya bertanya dan dapat memverifikasi dengan CLI." Inti berfungsi. Situs dan orientasinya tidak.

## Halaman beranda

Halaman beranda sekarang memiliki sembilan bagian berbeda, bukan satu gulir panjang. Tiga hal yang paling langsung merespons umpan balik:

### Tabel jaminan memori

[Tabel jaminan memori](https://neotoma.io/memory-guarantees) adalah jawaban untuk "apa bedanya?" Perbandingan memori platform (Claude, ChatGPT), sistem pengambilan (Mem0, Zep, LangChain Memory), pendekatan berbasis file (Markdown, penyimpanan JSON), dan Neotoma di 12 properti:

![Tangkapan layar: Tabel perbandingan jaminan memori di beranda Neotoma](/images/posts/neotoma-site-overhaul-memory-guarantees-table.png "screenshot")

| Properti | Deskripsi |
| -------- | ----------- |
| [Evolusi keadaan deterministik](https://neotoma.io/memory-guarantees#deterministic-state-evolution) | Pengamatan yang sama selalu menghasilkan status entitas yang sama, apa pun urutannya. Menghilangkan bug pemesanan dan membuat transisi status dapat diuji. |
| [Riwayat berversi](https://neotoma.io/memory-guarantees#versioned-history) | Setiap perubahan menciptakan versi baru alih-alih menimpa. Negara-negara bagian sebelumnya tetap dapat diakses. |
| [Garis waktu yang dapat diputar ulang](https://neotoma.io/memory-guarantees#replayable-timeline) | Urutan pengamatan secara lengkap dapat diputar ulang dari awal untuk merekonstruksi keadaan sejarah apa pun. |
| [Log perubahan yang dapat diaudit](https://neotoma.io/memory-guarantees#auditable-change-log) | Setiap modifikasi mencatat siapa yang membuatnya, kapan, dan dari sumber apa. |
| [Batasan skema](https://neotoma.io/memory-guarantees#schema-constraints) | Entitas mematuhi tipe dan aturan validasi yang ditentukan. Data yang formatnya salah ditolak, bukan diterima secara diam-diam. |
| [Risiko mutasi senyap](https://neotoma.io/memory-guarantees#silent-mutation-risk) | Apakah data dapat berubah tanpa kesadaran eksplisit. Pendekatan platform, pengambilan, dan berbasis file semuanya membawa risiko ini. Neotoma mencegahnya. |
| [Risiko fakta yang bertentangan](https://neotoma.io/memory-guarantees#conflicting-facts-risk) | Apakah pernyataan yang bertentangan dapat muncul bersamaan tanpa terdeteksi. Neotoma menandai dan menyelesaikan konflik alih-alih menyimpan keduanya. |
| [Rekonstruksi keadaan yang dapat direproduksi](https://neotoma.io/memory-guarantees#reproducible-state-reconstruction) | Keadaan saat ini yang lengkap dapat dibangun kembali dari masukan mentah saja, seperti halnya buku besar menyeimbangkan entri-entrinya ke nol. |
| [Kemampuan untuk diperiksa oleh manusia](https://neotoma.io/memory-guarantees#human-inspectability) | Anda dapat memeriksa dengan tepat apa yang berubah antara dua versi dan melacak dari mana setiap fakta berasal. |
| [Orientasi tanpa pengaturan nol](https://neotoma.io/memory-guarantees#zero-setup-onboarding) | Apakah memori berfungsi sejak pesan pertama tanpa instalasi. Memori platform memiliki ini. Neotoma tidak. |
| [Pencarian kesamaan semantik](https://neotoma.io/memory-guarantees#semantic-similarity-search) | Menemukan konteks yang relevan berdasarkan makna, bukan pencocokan persis. Sistem pengambilan dan Neotoma keduanya menyediakan hal ini, dengan cakupan yang berbeda. |
| [Dapat diedit langsung oleh manusia](https://neotoma.io/memory-guarantees#direct-human-editability) | Apakah Anda dapat membuka penyimpanan memori di editor standar dan memodifikasinya secara langsung. Sistem berbasis file memiliki ini. Neotoma tidak. |

Setiap baris tertaut ke halaman penjelasan khusus dengan contoh sebelum/sesudah dan kode CLI. Salah satu penguji mencatat bahwa "penyimpanan umum dengan skema belum terpecahkan" dan skema populer bisa menjadi jawabannya. Tabel jaminan adalah tanggapan saya: berikut adalah properti spesifiknya, di sinilah setiap pendekatan berhasil, di sinilah tidak.

### Sebelum dan sesudah

![Tangkapan layar: Bagian sebelum/sesudah menampilkan respons gagal vs berhasil](/images/posts/neotoma-site-overhaul-before-after-section.png "screenshot")

Animasi intro memutar pertanyaan yang sama melalui dua hasil. Tanpa Neotoma: "Tidak ada kontrak yang ditemukan untuk Kline." Dengan Neotoma: "Net-30, ditandatangani 12 Oktober, diperpanjang secara otomatis pada Q1." Sebelas skenario diputar, masing-masing menampilkan sekilas mode kegagalan nyata.

Di bawah animasi, empat kartu kegagalan mengelompokkan skenario berdasarkan tipe data: fakta keuangan, orang dan hubungan, komitmen dan tugas, peristiwa dan keputusan. Setiap kartu memiliki narasi yang konkret — kontak basi yang ditujukan kepada orang yang salah, tenggat waktu yang terlupa yang memicu pengingat terhadap tugas-tugas lama, catatan yang saling bertentangan saat dua agen membaca versi berbeda dari kontrak yang sama dan tidak ada yang mengetahui keberadaan yang lain.

Ini adalah tanggapan langsung terhadap masukan "vitamin vs obat penghilang rasa sakit". Situs lama dipimpin dengan arsitektur. Bagian ini membahas apa saja yang rusak tanpa keadaan deterministik dan berapa kerugian yang harus Anda tanggung.

### Untuk siapa ini

![Tangkapan layar: Tiga kartu audiens dengan ilustrasi di beranda Neotoma](/images/posts/neotoma-site-overhaul-audience-cards.png "screenshot")

Tiga kartu audiens dengan ilustrasi khusus: [Insinyur infrastruktur AI](https://neotoma.io/ai-infrastructure-engineers), [pembangun sistem agen](https://neotoma.io/agentic-systems-builders), dan [operator individu asli AI](https://neotoma.io/ai-native-operators). Masing-masing tertaut ke halaman khusus dengan mode kegagalan, tipe data, dan pola skema khusus untuk audiens tersebut. Ini adalah jawaban langsung untuk "apakah saya salah satu dari orang-orang yang melakukan hal ini?"

## Dokumentasi

Situs lama memiliki segalanya yang sejalan. Penguji yang menginginkan kedalaman harus membuka repo. Sekarang ada halaman khusus yang diatur dalam navigasi sidebar.

### Panduan pengembang

![Tangkapan layar: Halaman penelusuran pengembang yang menampilkan contoh MCP multi-sesi](/images/posts/neotoma-site-overhaul-developer-walkthrough.png "tangkapan layar")

[Panduan pengembang](https://neotoma.io/developer-walkthrough) adalah skenario multi-sesi yang berjalan melalui loop inti: menyimpan keputusan arsitektur di sesi 1, mengambil dan menindaklanjutinya di sesi 2, menangani pembaruan yang bertentangan di sesi 3, lalu mengaudit jejak observasi penuh. Semua menggunakan panggilan penyimpanan MCP (Model Context Protocol) dengan contoh permintaan/respons nyata. Ini menjawab pertanyaan penyerapan secara langsung: agen memanggil [alat MCP](https://neotoma.io/mcp) dengan parameter terstruktur, Neotoma menyimpan observasi. Tidak ada panggilan model AI yang tersembunyi, tidak ada ekstraksi regex.

### Model memori

![Tangkapan Layar: Halaman model memori yang menampilkan platform, pengambilan, berbasis file, dan memori deterministik](/images/posts/neotoma-site-overhaul-memory-models.png "screenshot")

Halaman [model memori](https://neotoma.io/memory-models) membandingkan empat pendekatan: [memori platform](https://neotoma.io/platform-memory), [memori pengambilan](https://neotoma.io/retrieval-memory), [memori berbasis file](https://neotoma.io/file-based-memory), dan [memori deterministik](https://neotoma.io/deterministic-memory). Di sinilah pertanyaan “haruskah Neotoma menggantikan atau melengkapi ingatan saya yang ada?” pertanyaan terjawab. Setiap model memiliki sub-halaman khusus yang menjelaskan apa itu model, di mana cara kerjanya, dan di mana kerusakannya.

### Yayasan

![Tangkapan Layar: Halaman Yayasan yang menampilkan komitmen yang mengutamakan privasi, deterministik, dan lintas platform](/images/posts/neotoma-site-overhaul-foundations.png "screenshot")

[Foundations](https://neotoma.io/foundations) mencakup [privacy-first](https://neotoma.io/privacy-first), deterministik, dan [lintas-platform](https://neotoma.io/cross-platform) secara mendalam. Halaman yang mengutamakan privasi menanggapi para penguji yang skeptis dalam memasukkan data pribadi ke dalam alat cloud AI. Neotoma berjalan di mesin Anda. Data Anda tetap lokal.

### Arsitektur

![Tangkapan layar: Halaman arsitektur yang menampilkan diagram alur keadaan](/images/posts/neotoma-site-overhaul-architecture-state-flow.png "screenshot")

Halaman [arsitektur](https://neotoma.io/architecture) mencakup aliran status (sumber, observasi, entitas, snapshot entitas), lapisan, dan cara jaminan diterapkan di setiap tahap. Ini adalah salah satu tambahan yang paling banyak diminta.

### Halaman referensi

Tabel endpoint [REST API](https://neotoma.io/api) lengkap, [tindakan MCP](https://neotoma.io/mcp), katalog, dan [referensi baris perintah](https://neotoma.io/cli). Halaman API mencakup deskripsi dan parameter per titik akhir. Halaman MCP mencantumkan 24 tindakan. Halaman CLI mencakup semua 38 perintah.

## Panduan integrasi

Enam halaman khusus alat, masing-masing menelusuri pengaturan mulai dari instalasi hingga penyimpanan pertama:

- [ObrolanGPT](https://neotoma.io/neotoma-with-chatgpt)
- [Claude (Desktop)](https://neotoma.io/neotoma-with-claude)
- [Kode Claude](https://neotoma.io/neotoma-with-claude-code)
- [Kodeks](https://neotoma.io/neotoma-with-codex)
- [Kursor](https://neotoma.io/neotoma-with-cursor)
- [OpenClaw](https://neotoma.io/neotoma-with-openclaw)

![Tangkapan layar: Neotoma dengan panduan integrasi Kode Claude](/images/posts/neotoma-site-overhaul-integration-guide-claude-code.png "tangkapan layar")

Ini adalah jawaban langsung untuk "apakah ini berfungsi dengan X?" dan "bagaimana cara mengaturnya dengan alat saya?" Setiap panduan mencakup konfigurasi, contoh yang dijalankan pertama kali, dan apa yang diharapkan. Halaman ChatGPT paling detail karena pengaturan GPT Kustom memiliki langkah paling banyak. Halaman OpenClaw ada karena penguji secara khusus menanyakan apakah halaman tersebut didukung dan situs lama bersifat ambigu.

## Kasus penggunaan

Tiga halaman audiens khusus kini menyoroti dan menjelaskan untuk siapa Neotoma, memberikan panduan penargetan yang tidak dimiliki halaman beranda lama:

![Tangkapan layar: laman audiens teknisi infrastruktur AI yang menampilkan mode kegagalan dan pola data umum](/images/posts/neotoma-site-overhaul-audience-detail-ai-infrastructure.png "tangkapan layar")

**[Insinyur infrastruktur AI](https://neotoma.io/ai-infrastructure-engineers).** Masalah seperti proses agen yang tidak dapat direproduksi, perubahan status yang tidak terlihat, dan tidak adanya jejak asal. Mode kegagalan umum dengan ikon tertentu. Tipe data yang digunakan tim ini (status sesi, alur, evaluasi, jalur audit) dan tipe entitas yang paling sering muncul (sesi_agen, tindakan, alur, evaluasi).

**[Pembangun sistem agen](https://neotoma.io/agentic-systems-builders).** Struktur serupa berfokus pada framework agen, alur kerja multi-langkah, dan kemampuan observasi. Mode kegagalan seperti perubahan status senyap di antara sesi, alur kerja yang tidak dapat diputar ulang, dan hilangnya konteks ketika satu agen berpindah ke agen lainnya.

**[Operator individu asli AI](https://neotoma.io/ai-native-operators).** Berfokus pada pengalaman sehari-hari tentang hilangnya komitmen, hilangnya konteks antar-alat, dan data pribadi dalam memori penyedia yang tidak jelas. Ini adalah halaman untuk penguji yang bertanya "apakah saya salah satu dari orang-orang yang menginginkan ini?"

## Penginstalan yang dipimpin agen

![Tangkapan layar: Halaman pemasangan agen dengan instruksi salin dan tempel dan demo sesi agen](/images/posts/neotoma-site-overhaul-agent-install.png "tangkapan layar")

Ini baru sejak pengumuman rilis pengembang. Daripada membaca dokumen dan mengonfigurasi secara manual, Anda menyalin satu perintah dari [halaman instalasi](https://neotoma.io/install), menempelkannya ke alat AI Anda, dan agen akan menangani sisanya: menginstal paket, menjalankan init, mengonfigurasi koneksi MCP, dan menyimpan data pertama Anda.

Prompt ini dirancang untuk Claude Code, Codex, Cursor, dan OpenClaw. Ini memberitahu agen untuk menginstal Neotoma dengan `npm install -g neotoma`, menginisialisasinya, dan kemudian menautkan panduan integrasi yang cocok untuk alat tersebut. Agen memindai konteks lokal dan memori platform Anda, melihat pratinjau apa yang ditemukannya, dan hanya menyimpan apa yang Anda setujui.

Setiap panduan integrasi tertaut ke perintah penginstalan sehingga jalur orientasinya sama, apa pun alat yang Anda gunakan untuk memulai. Tujuannya adalah untuk memulai dari nol hingga pengaturan Neotoma yang berfungsi dengan data nyata yang disimpan dalam waktu kurang dari lima menit, tanpa pernah membaca dokumen konfigurasi.

## Dukungan bahasa

Situs dan semua konten postingan sekarang diterjemahkan secara otomatis ke dalam 12 bahasa: Arab, Bengali, Catalan, Prancis, Jerman, Hindi, Indonesia, Mandarin, Portugis, Rusia, Spanyol, dan Urdu. Setiap halaman menyertakan pengalih bahasa, dan tata letak RTL berfungsi untuk bahasa Arab dan Urdu.

Hal ini penting karena rilis pengembang telah menjangkau penguji di luar pasar berbahasa Inggris. Daripada membatasi dokumentasi dalam satu bahasa, setiap halaman — halaman beranda, jaminan memori, panduan integrasi, halaman kasus penggunaan, dan postingan — tersedia di 12 lokal. Terjemahan dibuat secara otomatis dan mungkin tidak sempurna, tetapi terjemahan ini mengurangi hambatan bagi siapa pun yang mengevaluasi Neotoma dalam bahasa utama mereka.

## Apa selanjutnya

Perombakan situs mengatasi kesenjangan presentasi dan dokumentasi. Pekerjaan selanjutnya akan mengatasi kesenjangan produk yang muncul dari para penguji.

- **Orientasi berbasis agen.** Alur penginstalan saat ini membantu Anda menyiapkannya, namun bersifat pasif. Anda menginstal, Anda memulai, Anda mulai menyimpan. Versi berikutnya akan menjadi pengalaman penemuan terpandu di mana agen Anda memindai file lokal Anda, mengusulkan kandidat dengan nilai tertinggi, dan merekonstruksi garis waktu dari data Anda sendiri dalam beberapa menit pertama. Tujuannya adalah momen konkret di mana Anda melihat file proyek Anda yang tersebar berubah menjadi garis waktu terstruktur dengan setiap peristiwa ditelusuri ke sumber tertentu. Saat itulah perbedaan antara Neotoma dan memori obrolan menjadi jelas.

- **Ekspor catatan penurunan harga.** Beberapa pengembang, terutama yang berasal dari Claude Code, mengharapkan memori direpresentasikan sebagai file penurunan harga yang dapat mereka jelajahi dan edit secara langsung. Neotoma menggunakan SQLite sebagai penyimpanan kanoniknya, yang memberi Anda kueri deterministik dan batasan skema, tetapi berarti Anda tidak bisa begitu saja membuka file di editor Anda. Saya menambahkan perintah untuk mengekspor catatan Anda sebagai file penurunan harga pada disk, disusun berdasarkan jenis entitas, dengan metadata dan asal frontmatter. SQLite tetap kanonik. File penurunan harga adalah cermin yang mudah dibaca untuk transparansi dan pemeriksaan.

- **Akses jarak jauh yang lebih lancar untuk ChatGPT dan Claude.** Panduan integrasi sudah ada sekarang, namun jalur penyiapan jarak jauh untuk ChatGPT (GPT Khusus dengan titik akhir API) dan Claude (Desktop dengan MCP jarak jauh) memerlukan lebih banyak dogfood dan proses debug saya sendiri sebelum menjadi semulus jalur lokal untuk Kursor dan Kode Claude. Saya ingin keduanya berfungsi dengan andal secara end-to-end dan memperbarui panduan dengan instruksi dan pemecahan masalah yang lebih jelas.

## Apa yang saya ingin masukan

Rilis pengembang masih aktif. Jika Anda mencoba menginstal Neotoma dan mengerjakan situsnya, saya ingin tahu:

- Apakah posisinya jelas? Saat Anda membuka halaman beranda, apakah Anda memahami apa yang dilakukan Neotoma dan apa bedanya dengan apa yang sudah Anda gunakan?
- Apakah tabel jaminan memori membantu Anda memutuskan apakah Neotoma relevan dengan alur kerja Anda?
- Apakah jalur instalasi dan orientasi jelas? Bisakah Anda beralih dari situs ke pengaturan yang berfungsi tanpa menemui hambatan?
- Apakah panduan integrasi untuk alat Anda akurat?

Kunjungi [neotoma.io](https://neotoma.io), minta agen Anda untuk [memasang](https://neotoma.io/install) dengan petunjuk salin dan tempel, dan sampaikan masukan Anda. Buka terbitan di [GitHub](https://github.com/markmhendrickson/neotoma) atau hubungi langsung.