Project Brain:
Otak dari Setiap Project

Project Brain adalah sekumpulan file Markdown yang ditaruh di folder .ai/ dalam setiap project yang menggunakan AEOS. Fungsinya: memberi AI konteks persisten tentang project spesifik itu. Bedanya dengan AEOS Core yang ngasih standar umum, Project Brain ngasih konteks khusus project kamu.

Ada 5 file dalam Project Brain:

AGENTS.md adalah file pertama yang dibaca AI saat masuk project. Isinya esensi project: buat apa project ini, misinya apa, batasannya di mana, dan prinsip apa yang harus dipegang.

Apa Isi AGENTS.md?

Contoh AGENTS.md untuk Bakso Mas Jo

# AGENTS

# Purpose

Bakso Mas Jo - Website pemesanan bakso online untuk
pelanggan di kompleks Perumahan Griya Asri dan sekitarnya.

# Mission

Membantu Pak Jo menjual bakso secara online dengan sistem
pemesanan yang mudah, tracking delivery real-time, dan
manajemen stok bahan baku otomatis. Target: 50 order/hari
dalam 3 bulan pertama.

# Scope

In scope:
- Landing page menu bakso dengan foto dan harga
- Sistem pemesanan (pilih menu, keranjang, checkout)
- Tracking delivery (status: dimasak, diantar, sampai)
- Admin panel untuk Pak Jo (kelola menu, liat order)
- Notifikasi WhatsApp otomatis ke pelanggan

Out of scope:
- Pembayaran online (cash on delivery dulu)
- Aplikasi mobile native
- Multi-kurir atau marketplace

# Working Principles

* Follow AEOS standards (rules, memories, skills).
* Execution first, discussion when blocked.
* Keep it simple. Ship working increments.
* Security is a constraint, not optional.
* Responsive dan mobile-first (pelanggan mostly akses dari HP).

# Final Principle

Bakso Mas Jo harus online dalam 2 minggu.
Fitur yang nggak esensial: skip dulu.

Salah vs Benar

CURRENT_SPRINT.md adalah status real-time project. Ini yang ngejawab: "Kita lagi di mana? Udah sejauh mana? Yang masih kurang apa?" File ini harus di-update setiap kali ada progress.

Apa Isi CURRENT_SPRINT.md?

Contoh CURRENT_SPRINT.md untuk Bakso Mas Jo

# CURRENT_SPRINT

# Sprint

Sprint 1

Status: In Progress

# Sprint Goal

Membuat landing page menu bakso, sistem registrasi/login
pelanggan, dan fitur order sederhana. Target: pelanggan
bisa buka website, liat menu, dan kirim order dalam
3 hari kerja.

# Progress

60%

# Current Focus

Integrasi WhatsApp API untuk notifikasi order masuk ke
Pak Jo.

# Completed

* Landing page menu bakso dengan foto dan harga
* Halaman registrasi dan login pelanggan
* Halaman profil pelanggan
* Sistem keranjang belanja sederhana

# Remaining Tasks

* Form checkout dan konfirmasi order
* Integrasi WhatsApp API (Wablas)
* Tracking status order (dimasak, diantar, sampai)
* Admin panel sederhana buat Pak Jo
* Deploy ke VPS Debian + Nginx

# Known Issues

* API key Wablas masih nunggu aktivasi (udah daftar,
  nunggu 1x24 jam)
* Foto bakso masih pake placeholder dari Unsplash,
  nunggu Pak Jo kirim foto asli

Salah vs Benar

DECISIONS.md adalah yang paling sering dilupain, tapi paling berharga dalam jangka panjang. Ini catatan semua keputusan engineering penting beserta alasannya. Kenapa pake Laravel bukan React? Kenapa pake PostgreSQL bukan MySQL? Semua dicatat di sini.

Apa Isi DECISIONS.md?

Contoh DECISIONS.md untuk Bakso Mas Jo

# DECISIONS

# Engineering Decisions

Record of important decisions and their rationale.
AI dan developer harus paham reasoning sebelum
mengubah keputusan.

# Decision 001

## Title

Stack: Laravel instead of Go

## Decision

Pake Laravel 11 sebagai framework backend, bukan Go.

## Reason

Pak jo butuh website dalam 2 minggu. Tim vibecoding
lebih paham Laravel daripada Go. Laravel juga punya
ekosistem yang lebih cepat untuk CRUD + auth + notifikasi.
Go akan dipake nanti kalau skala udah besar dan butuh
performa tinggi.

# Decision 002

## Title

CSS Framework: Tailwind instead of Bootstrap

## Decision

Pake Tailwind CSS 3 + Alpine.js, bukan Bootstrap.

## Reason

Sesuai standar AEOS Design Skill yang mewajibkan Tailwind.
Tailwind lebih fleksibel untuk desain light-theme yang
nggak keliatan kayak template Bootstrap generic.
Alpine.js cukup untuk interaktivitas ringan tanpa perlu
React/Vue.

# Decision 003

## Title

Database: PostgreSQL instead of MySQL

## Decision

Pake PostgreSQL 16, bukan MySQL.

## Reason

PostgreSQL lebih baik untuk JSON data (menu bakso
punya variants: ukuran, topping, level pedas).
Juga support queue Laravel lebih stabil. Sesuai
standar AEOS DevOps Skill.

# Decision 004

## Title

Notification: WhatsApp instead of Email/SMS

## Decision

Pake WhatsApp API (Wablas) untuk notifikasi order,
bukan email atau SMS.

## Reason

Target pasar ibu rumah tangga dan anak kos. Mereka
lebih sering buka WhatsApp daripada email. Biaya
lebih murah daripada SMS. Lebih personal dan cepat.

# Decision 005

## Title

Payment: COD only, no payment gateway

## Decision

Pembayaran Cash on Delivery (COD) dulu. Nggak pake
payment gateway (Midtrans/Xendit) di fase awal.

## Reason

Mengurangi kompleksitas development. Pak Jo lebih
nyaman dengan COD. Pelanggan di kompleks juga kenal
sama Pak Jo, jadi trust issue minimal. Payment gateway
bisa ditambah di sprint berikutnya kalo perlu.

Salah vs Benar