Skip to content
This repository was archived by the owner on Aug 11, 2026. It is now read-only.
This repository was archived by the owner on Aug 11, 2026. It is now read-only.

docs: sync AGENTS and docs README with completed base state #450

Description

@ahliweb

Objective

Sinkronkan dokumentasi utama AWCMS-Mini dengan kondisi repo terbaru setelah seluruh backlog base generik selesai, agar developer dan coding agent tidak membaca instruksi usang.

Context

Repo saat ini sudah berada pada versi 0.23.5 dan README menyatakan seluruh 18 issue backlog base generik telah tuntas. Namun masih ada bagian dokumentasi yang memuat narasi lama seperti modul tenant/auth/RBAC/sync/deployment belum diimplementasikan dan instruksi mulai dari Issue 0.1.

Assumptions

  • Tidak ada perubahan kode aplikasi pada issue ini.
  • Perubahan hanya dokumentasi dan/atau katalog skill bila ditemukan narasi lama yang sama.
  • Dokumen historis/snapshot yang memang bersifat catatan waktu lampau tidak perlu diubah, kecuali ia dipakai sebagai panduan aktif.

Scope

  • Update AGENTS.md agar status proyek mencerminkan base generik yang sudah selesai.
  • Update docs/awcms-mini/README.md, terutama bagian Langkah berikutnya.
  • Ganti instruksi aktif Mulai dari Issue 0.1 menjadi alur membangun aplikasi turunan / modul domain baru di atas base.
  • Cari narasi usang terkait belum diimplementasikan, mulai Issue 0.1, atau backlog foundation yang sudah selesai.
  • Pastikan referensi tetap mengarah ke README, ADR, docs 01-20, skill, dan modul nyata yang tersedia.

Out of Scope

  • Tidak mengubah implementasi kode aplikasi.
  • Tidak mengubah migration SQL.
  • Tidak membuat API/endpoint baru.
  • Tidak mengubah snapshot historis bila jelas bersifat arsip waktu lampau.

Architecture / Security / Data Impact

  • Architecture: meningkatkan kejelasan onboarding untuk base modular monolith.
  • Security: mencegah coding agent membuat ulang kontrol keamanan yang sudah ada atau melewati guardrail karena membaca dokumen lama.
  • Data: tidak ada dampak data runtime.

Implementation Steps

  1. Baca README.md, AGENTS.md, docs/awcms-mini/README.md, dan .claude/skills/README.md.
  2. Search seluruh repo untuk frasa status usang:
    • belum diimplementasikan
    • Mulai dari Issue 0.1
    • Kerjakan Issue 0.1
    • docs-only sampai scaffold
  3. Perbarui dokumen aktif agar menyebut base generik sudah siap dipakai.
  4. Tambahkan arahan baru: scaffold modul domain baru mengikuti skill awcms-mini-new-module, migration, OpenAPI, AsyncAPI, test, security review, production preflight.
  5. Jalankan validasi docs.

Acceptance Criteria

  • Tidak ada instruksi aktif yang menyuruh memulai dari Issue 0.1 sebagai pekerjaan baru.
  • Tidak ada klaim aktif bahwa tenant/auth/RBAC/sync/deployment belum diimplementasikan.
  • AGENTS.md memuat status terkini dan alur kerja untuk aplikasi turunan.
  • docs/awcms-mini/README.md memuat langkah berikutnya yang relevan untuk base selesai.
  • Dokumentasi tetap membedakan base generik vs domain turunan.

Testing Checklist

  • bun run check:docs
  • bun run lint
  • bun run check bila perubahan docs menyentuh format lint global.

Documentation Checklist

  • AGENTS.md diperbarui.
  • docs/awcms-mini/README.md diperbarui.
  • .claude/skills/README.md dicek bila ada drift.

Risks

  • Mengubah catatan historis yang seharusnya tetap apa adanya.
  • Membuat dokumen terlalu generik sehingga kehilangan arahan implementasi nyata.

Mitigations

  • Bedakan dokumen aktif vs snapshot historis.
  • Tambahkan kalimat bahwa snapshot lama tetap arsip, sedangkan state aktif mengikuti README/AGENTS terbaru.

Next Action

Implementasikan perubahan docs secara atomic, lalu laporkan file changed, commands run, dan test result.

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions