agentleFS
pranataa-labspranataa-labs/Workflow-Master/skills/domain-scaffolding/SKILL.md

domain-scaffolding

Skill2 starsChanged 9 days agoMITView on GitHub

Zero-friction procedure for scaffolding a complete domain application (Rule 16): e-commerce/bookstore, clinic queue, POS/cashier, SaaS, LMS, service booking, or company profile. Picks the archetype and stack, builds a dual-sided app (customer flow plus protected admin backoffice with obfuscated route), seeds 6-12 realistic items with images and demo accounts, applies the shadcn slate design system, and ends with a clean production handoff. Use whenever the user asks to build a new system or app for a business domain without detailed requirements.

  • Reads credentials

1 other project uses a version of this.

Adopted by

Most recently taken up by

The file

Files
SKILL.md

Domain Scaffolding

Prosedur pelaksanaan Rule 16. Katalog fitur per arketipe ada di rules/16-autonomous-domain-archetypes-scaffolding.md; skill ini mengatur urutan kerja dan standar hasil akhir.

Rule terkait: 16 (Archetypes), 05 (Security), 18 (Auth Boundaries, Clean Handoff), 19 (Anti-Slop UI, Mobile Ergonomics). Skill pendukung: shadcn-admin-design-system, laravel-web-studio, verify-and-test, security-audit, readme-github-sync, github-repo-publish.


1. Prinsip

  • Jangan menanyakan kebutuhan dasar (auth, keranjang, warna, font). Putuskan sendiri berdasarkan arketipe.
  • Tanyakan hanya hal yang tidak bisa ditebak dan berdampak besar, misalnya integrasi pembayaran nyata atau stack yang diwajibkan klien.
  • Hasil pertama harus dapat dijalankan dan didemokan, bukan kerangka kosong.

2. Pemilihan Arketipe dan Stack

Permintaan penggunaArketipe (Rule 16)Stack default
Toko buku, fashion, toko kue, toko bungaA: E-CommerceLaravel + Blade + Tailwind (gunakan laravel-web-studio)
Antrian klinik, servis, rumah sakitB: Queue & ClinicLaravel + React/Next untuk layar antrian real-time
Kasir, POS restoran/retailC: POSLaravel + Livewire atau React SPA
SaaS, langganan, multi-tenantD: SaaSNext.js + Prisma/Postgres atau Laravel
Kursus online, LMSE: LMSLaravel atau Next.js
Booking salon, bengkel, jasa, company profileF: Service BookingLaravel + Blade

Bila repositori sudah memiliki stack, ikuti stack yang ada.


3. Urutan Kerja

flowchart LR
  A["1 Blueprint"] --> B["2 Schema dan Seed"] --> C["3 Auth dan Role"] --> D["4 Customer Flow"] --> E["5 Admin Backoffice"] --> F["6 Design Pass"] --> G["7 Verify dan Audit"] --> H["8 Handoff"]

3.1 Blueprint

Tulis docs/BLUEPRINT.md memakai resources/blueprint-template.md: arketipe, persona, sitemap customer dan admin, entitas, dan alur utama.

3.2 Schema dan Seed

  • Skema ternormalisasi (3NF), foreign key, index pada kolom pencarian dan filter (Rule 03).
  • Seeder berisi 6 sampai 12 item domain dengan nama, deskripsi, harga, dan stok yang realistis dalam bahasa Indonesia.
  • Setiap item memiliki gambar. Sumber: https://images.unsplash.com/... dengan parameter ukuran, atau aset lokal di public/images/seed/. Jangan memakai placeholder abu-abu.
  • Akun demo:
PeranEmailPassword
Adminadmin@example.compassword123
Useruser@example.compassword123

3.3 Auth dan Role

  • Peran minimal: admin, user. Tamu tidak login.
  • Aksi member (keranjang, checkout, booking, riwayat) dikunci di server dan disembunyikan di UI bagi tamu (Rule 18).
  • Rute admin memakai prefix terobfuskasi, misalnya /panel-7f3k/, bukan /admin (Rule 05), dan dilindungi middleware role.

3.4 Customer Flow

Beranda, katalog dengan pencarian dan filter, detail item, alur transaksi utama arketipe (checkout, ambil nomor antrian, booking slot), dan halaman riwayat milik user.

3.5 Admin Backoffice

Dashboard KPI (pendapatan, transaksi, item terlaris), CRUD entitas utama dengan tabel ber-paginasi, pencarian, dan filter, manajemen status transaksi, serta manajemen pengguna.

3.6 Design Pass

Terapkan shadcn-admin-design-system (slate oklch, sidebar 16rem, header sticky blur). Patuhi Rule 19: bento grid asimetris bila relevan, tanpa gradient ungu acak, target sentuh minimal 44 px, bottom sheet di ponsel, dan env(safe-area-inset-*). Copy berbahasa Indonesia yang lugas.

3.7 Verify dan Audit

  • verify-and-test: minimal test untuk otorisasi (tamu ditolak, user tidak dapat mengakses data user lain, user tidak dapat membuka panel admin) dan perhitungan bisnis utama.
  • security-audit Fase 1 dan 2 secara ringkas.

3.8 Handoff

Lihat Bagian 4.


4. Checklist Clean Production Handoff (Rule 18)

  • Form login tidak terisi otomatis dengan kredensial demo
  • Tidak ada tombol "login sebagai admin", bypass auth, atau rute debug
  • Akun demo hanya didokumentasikan di README, bagian "Akun Demo"
  • APP_DEBUG=false dan .env.example lengkap tanpa nilai rahasia
  • Seeder demo dipisah (DemoSeeder) agar dapat dinonaktifkan di produksi
  • README lulus readme-github-sync dan menyertakan screenshot customer dan admin
  • diff-review -All tanpa [BLOCK]

5. Laporan Akhir

Sampaikan: arketipe dan stack yang dipilih beserta alasan singkat, cara menjalankan (perintah yang dapat disalin), URL customer dan admin (termasuk prefix terobfuskasi), akun demo, hasil verifikasi, dan daftar fitur yang sengaja ditunda.

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

No reviews yet

People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.

  • It worked
  • Partly
  • It didn't
What did you use it for? e.g. Reviewing pull requests in a Rails app

Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.