Memahami AEOS Core

AEOS adalah singkatan dari Anjrah Engineering AI Operating System. Namanya memang terdengar besar, tapi intinya sederhana: AEOS adalah standar engineering yang mengajarkan AI (dan kamu sebagai vibecoder) cara membangun software dengan prinsip yang konsisten.

Tapi ingat: AEOS bukan framework, bukan boilerplate, dan bukan AI agent. Dia cuma kumpulan file Markdown yang berisi rules, memories, skills, workflows, dan templates. Semua file ini bisa dibaca oleh AI IDE mana pun yang bisa membaca file Markdown.

Misi utama AEOS: "Bukan lebih banyak dokumentasi, tapi software yang lebih baik." Semua yang ada di AEOS bertujuan untuk menghasilkan kode yang bersih, testable, deployable, dan bener-bener dipake.

Sebelum kamu ngerti detail file-file AEOS, kamu harus paham dulu 6 prinsip yang mendasarinya. Semua aturan yang ada di AEOS lahir dari prinsip-prinsip ini. Kalau kamu paham prinsip ini, kamu nggak bakal bingung kenapa suatu aturan ditulis seperti itu.

Salah satu masalah terbesar dalam vibecoding adalah: kode udah ditulis, tapi belum tahu apakah beneran "selesai." Makanya AEOS punya Definition of Done (DoD), yaitu standar yang harus dipenuhi sebelum sebuah tugas, fitur, atau perbaikan bug bisa dinyatakan selesai.

Berikut adalah Definition of Done yang harus dipenuhi di setiap tugas AEOS:

Folder rules/ berisi satu file utama: global-rules.md. Ini adalah konstitusi engineering, yaitu aturan tertinggi yang nggak pernah berubah. Bedanya dengan prinsip inti: prinsip inti itu filosofi umum, sedangkan rules ini aturan konkret yang langsung bisa diterapkan pas ngoding. Ada 10 bagian:

"Bangun software yang bertahan terhadap perubahan, bukan software yang memprediksi setiap perubahan masa depan." Ini ngajarin kita buat nggak paranoid sama masa depan. Fokus sama masalah hari ini, tapi bikin kode yang gampang diubah nantinya. Clarity beats cleverness. Intinya: kode yang bener itu kode yang gampang dibaca dan diubah, bukan kode yang pinter tapi ruwet.

Mulailah dari implementasi terkecil. Tambahin layer, pattern, dan dependensi hanya setelah versi sederhananya terbukti nggak cukup. Default ke standard library dan tools sederhana sebelum pake yang baru. Kalau dua desain sama-sama bagus, pilih yang lebih sedikit moving parts-nya. Ini prinsip Occam's Razor dalam software engineering.

Kirim increment yang berfungsi sebelum menyempurnakan dokumen desain. Planning itu berguna hanya jika dia memperpendek jalan menuju kode yang bekerja. Prototype jadi production hanya ketika dibangun ulang, bukan diganti namanya. Momentum itu penting. Satu fitur kecil yang selesai nilainya lebih besar dari satu fitur besar yang setengah jadi.

Kode dibaca manusia berkali-kali setelah ditulis sekali. Maka optimalkan untuk pembaca. Nama harus menjelaskan intent. Kalo kamu butuh komentar buat jelasin apa yang dilakukan suatu fungsi, berarti fungsi itu terlalu besar atau namanya kurang jelas. Komentar itu buat jelasin why, bukan what. Fungsi dan modul harus cukup kecil untuk diingat di working memory.

Jangan buat file, folder, atau abstraksi sebelum dibutuhkan. Tolak library yang menyelesaikan masalah yang belum kamu punya. Hindari konfigurasi demi konfigurasi. Default yang sensible lebih baik. Hapus kode mati. Kode mati itu nggak harmless; dia adalah kebohongan yang bisa menyesatkan orang lain.

Setiap fitur harus observable, testable, dan deployable sebelum dianggap selesai. Logging, error handling, dan monitoring bukan afterthought. Security dan performance adalah constraint, bukan tugas opsional. Jangan pernah ngandelin langkah manual di production. Otomatiskan atau hilangkan.

AI itu membantu, bukan memiliki. Setiap keputusan direview oleh human lead. Manusia ngasih konteks; AI ngasih eksekusi. AI harus ngikutin standar project, bukan menciptakan konvensi pribadi. When in doubt, ask. Jangan diam-diam asumsi.

Commit harus kecil, atomik, dan pakai present tense. Satu branch hidup cuma selama satu logical change. Jangan commit build artifacts, secrets, atau konfigurasi lokal. Jaga main branch tetap deployable kapan pun.

Dokumentasikan keputusan, bukan cuma kode. Jelaskan why kode ini ada. Jaga dokumentasi tetap dekat dengan hal yang dideskripsikan. README harus jelasin cara run, test, dan deploy project. Hindari menduplikasi apa yang sudah jelas bagi engineer kompeten.

Kalau ada aturan yang menghalangi progress, buat pengecualian secara eksplisit dan reversible. Dokumen ini memandu judgment, bukan menggantikannya. Pilihan engineering terbaik adalah yang membuat perubahan selanjutnya lebih mudah. Ini adalah meta-rule yang ngajarin kita fleksibel, bahwa aturan boleh dilanggar asalkan alasannya jelas dan bisa dibalikkin.

Folder memories/ berisi preferensi yang harus diingat AI lintas sesi. Bedanya dengan rules: rules itu aturan yang harus dipatuhi (konstitusi), memories itu preferensi yang memudahkan kerja AI dengan kamu (kebiasaan). Isinya adalah global-memory.md dengan 6 bagian:

Default to action. Eksekusi dulu sebelum menjelaskan, kecuali tugasnya ambigu atau berisiko tinggi. Tanya cuma kalau beneran buntu atau kalau cost dari pilihan yang salah itu mahal. Prefer increment pendek yang selesai daripada rencana panjang yang spekulatif. Tunjukkin hasil, lalu rangkum keputusan secara singkat.

VPS adalah source of truth. Semua kerja signifikan terjadi via remote SSH. Komputer lokal cuma klien untuk viewing, editing, dan testing. Workspace yang sama harus bisa diakses dari berbagai device. File yang disimpan di VPS harus bisa dijalankan dari VPS tanpa setup lokal.

Software harus readable first. Maintainability mengalahkan cleverness. Pilih solusi sederhana yang udah production-ready dibanding eksperimen elegan. Jaga ukuran kodebase cukup kecil untuk dipahami cepat. Hindari layer, wrapper, dan dependensi yang nggak perlu.

Light theme adalah default. Dark mode opsional, nggak pernah required. Hindari interface yang keliatan kayak generated by AI. Pake pola UI real yang polished dan human-designed. Desain yang timeless dan profesional di atas tren yang norak. Inspirasi dari shadcn/ui, Ant Design, Mantine, Tabler, daisyUI.

Pertahankan Meta Pixel dan Meta Conversions API integrations. Tracking infrastructure itu penting secara default. Jangan treat it as optional. Jangan pernah hapus atau modif tracking tanpa konfirmasi eksplisit. Growth-related code adalah bagian dari product, bukan secondary concern.

Jangan commit otomatis. Selalu tunggu approval eksplisit. Jangan push ke remote otomatis. Push adalah deliberate action. Jangan rewrite history kecuali di-approve user. Hindari destructive git commands.

Folder skills/ berisi standar untuk domain-domain spesifik yang harus diterapkan AI tanpa diminta. Kalau rules adalah aturan umum, skills adalah keahlian khusus di bidang tertentu. Ada 6 file skills:

Skill ini ngajarin AI (dan kamu) untuk berpikir sebelum coding. Setiap keputusan implementasi harus didahului oleh keputusan produk yang jelas: masalah apa yang diselesaikan, untuk siapa, dan apa jalur terkecil menuju validasi.

• Problem first: Sebutkan masalah dalam satu kalimat. Kalau nggak bisa, stop. Kamu belum paham.
• User first: Sebutkan satu profil user nyata dan momen tepat masalah itu terjadi.
• Scope: Tulis apa yang in-scope dan out-of-scope sebelum kerja desain.
• MVP: Bangun hal terkecil yang memvalidasi asumsi inti. Satu user, satu workflow, satu metrik.
• Challenge assumptions: Serang asumsi-asumsi kamu sendiri sebelum dipertahankan.
• Risk awareness: Identifikasi risiko teknis, user, dan bisnis sebelum nulis kode.

Ini skill paling besar dan paling detail. Isinya standar engineering yang harus diterapkan AI tanpa diminta. Ada 15 bagian, dari execution first hingga maintainability.

Highlight penting:

• Anti-Bloat Coding: Tolak library yang solve masalah trivial. Hindari wrapper di atas wrapper.
• Human-Readable Code: Namain variable untuk pembaca manusia. Fungsi harus cukup kecil untuk cerita satu hal.
• MVP First: Bangun slice terkecil yang berguna. Ship. Learn. Expand.
• YAGNI: Jangan implementasi fitur yang mungkin berguna someday.
• Rule of Three: Duplikat pertama itu kebetulan. Kedua itu warning. Ketiga harus direfactor.
• Testing Mindset: Test melindungi behavior yang penting, bukan setiap code path.
• AI Continuity: Implementasi harus preserve project continuity.

Standar desain untuk membangun interface yang terasa profesional, konsisten, dan human-designed (bukan keliatan kayak hasil generated AI).

• Clarity over decoration: Setiap elemen harus punya tujuan. Buang visual noise.
• Light theme first: Desain utama di light theme. Dark mode adalah tambahan.
• Accessible by default: Kontras, touch targets, focus states, reduced motion.
• Mobile responsive: Mobile-first. Touch targets minimal 44x44px.
• PWA: Internal tools harus installable sebagai PWA.

Ada juga AI design anti-patterns, yaitu hal-hal yang bikin UI keliatan generated: gradient overload, massive hero sections, one-off styling, tiny touch targets, inconsistent spacing.

Standar deployment dan infrastructure. Fokus: Debian VPS, Nginx sebagai reverse proxy, PostgreSQL, Redis, systemd, SSL via Let's Encrypt.

• Debian stable untuk production. Security update mingguan.
• Single project per VPS untuk isolation.
• Develop langsung di production VPS, bukan localhost.
• Systemd services untuk application management.
• Environment variables untuk semua secrets, never di source code.

Standar growth dan marketing: SEO, GEO (Generative Engine Optimization), Meta Pixel, Meta Conversions API, UTM tracking, landing page optimization, Core Web Vitals. Termasuk aturan "Internal Tools: No Index", yaitu internal tools wajib di-exclude dari search engine via X-Robots-Tag: noindex.

Guidelines komunikasi yang jelas selama ngoding bareng AI:

• Execution first: Kalo tugas jelas, implement before explain.
• Concise: Kalimat pendek. Satu ide per paragraf. Prefer list.
• Challenge assumptions: Kalo ada yang kelihatan salah, bilang langsung.
• Ask only when necessary: Jangan tanya izin buat baca file atau run test.
• Explain trade-offs: Bandingkan opsi, rekomendasi satu.
• Report risks: Flag risk begitu liat: breaking changes, security issues.
• Never fabricate facts: Jangan ngarang isi file, function behavior, API responses.

Folder workflows/ berisi prosedur standar untuk aktivitas engineering yang berulang. Ini kayak SOP (Standard Operating Procedure) di pabrik: tinggal ikutin langkah-langkahnya, nggak perlu pusing mikir "mulai dari mana". Ada 5 workflow:

Folder templates/ berisi artifact reusable yang bisa dicopy ke project. Yang paling utama adalah Project Brain, yaitu sekumpulan file yang ditaruh di folder .ai/ dalam project kamu. Fungsinya: kasih AI konteks persisten tentang project spesifik itu. Terdiri dari 5 file:

Empat langkah praktis untuk mulai pake AEOS Core:

AEOS kompatibel dengan: Windsurf (Cascade), Cursor, Devin, Claude Code, dan AI IDE lain yang bisa baca file Markdown. Nggak ada platform-specific code. Nggak ada vendor lock-in. Cuma Markdown biasa.

AEOS Core bukan magic. Dia cuma alat. Yang bikin hasil kamu bagus adalah kamu yang paham kenapa setiap aturan ada. Makanya panduan ini dibuat, biar kamu nggak cuma clone repo doang, tapi beneran ngerti.

Sekarang kamu udah paham setiap folder, setiap file, dan setiap filosofi di balik AEOS Core. Nggak cuma clone doang. Kamu udah punya foundation yang kuat buat vibecoding. Selamat berkarya!