メニュー
Implementasikan layar/komponen UI AWCMS sesuai design system. Gunakan saat membangun halaman admin/POS/portal, komponen UI, island interaktif, atau memasang design token/theme. Menegakkan token doc 14, state pattern, a11y AA, i18n, dan aturan offline-first doc 15.
Codex または Claude でインストール この Prompt をコピーして Codex、Claude、または他のアシスタントに貼り付けると、Skill ページを確認してインストールできます。
SOC 職業分類に基づく
Triase dan perbaiki temuan CodeQL code scanning AWCMS (github.com/ahliweb/awcms/security/code-scanning). Gunakan saat diminta "analisis code scanning"/"perbaiki CodeQL", saat sebuah PR gagal check CodeQL, atau saat menemukan alert baru. Mendokumentasikan enam false-positive nyata yang sudah ditemukan (name-heuristic password, incompatible-types typeof/null, URL substring-sanitization di test mock, dua kasus dismiss resmi tanpa reformulasi kode, Bun.SQL tagged-template null-cast, dan build-time extension seam trivial-conditional) plus pola "unused-local-variable di test kadang menandai coverage gap", DAN satu counter-example trivial-conditional yang ternyata bug NYATA (dead-code fallback karena helper non-nullish, alert
Port sebuah modul/fitur yang sudah matang & teruji dari repo awcms-mini ke repo awcms secara atomic, adaptasi (bukan copy), sampai semua cek hijau + commit atomic. Gunakan saat diminta "port modul <X> dari mini", "terapkan fitur mini ke awcms", atau saat sebuah modul fondasi awcms-mini belum ada di awcms. Menegakkan kontrak alur mini-first (docs/awcms/alur-pengembangan-mini-first.md): rename prefix awcms_mini_→awcms_, penomoran migrasi lanjutan, drop dependensi/toolchain yang belum ada di awcms, dan verifikasi DoD.
Jalankan proses rilis AWCMS dengan Changesets. Gunakan saat diminta merilis versi, bump version, generate CHANGELOG, membuat tag vX.Y.Z, atau memeriksa changeset pending. Sesuai kebijakan SemVer doc 09.
BACAAN SAJA / HISTORIS (ADR-0034) — kontrak kesiapan ekstensi ERP base (`_shared/business-transaction-contract.ts`/`_shared/erp-reference-data-contract.ts`/`_shared/ports/period-lock-port.ts`) DAN jalur aplikasi-turunan yang skill ini asumsikan SUDAH DIHAPUS. ERP kini dibangun sebagai modul `domain` LANGSUNG di `src/modules/` (pola sama modul base lain), bukan repo turunan; file kontrak & fixture `example-erp-extension` yang dirujuk tidak lagi ada. Rujukan historis dari Issue
Audit dan perkuat backend & integrasi eksternal AWCMS (resiliensi, outbox, webhook/provider, versioning API, observability). Gunakan saat menambah/mengeraskan integrasi ke provider luar (R2, WhatsApp, email, AI, pajak), memperbaiki keandalan delivery, atau menaikkan ketahanan backend. Menegakkan ADR-0006 (provider opsional, di luar transaksi) dan pola outbox doc 16.
Scaffold modul baru pada modular monolith AWCMS. Gunakan saat membuat modul domain baru di src/modules/ (mis. warehouse-management, accounting-tax) atau saat memerlukan struktur module.ts + domain/application/infrastructure/api + README. Ikuti struktur standar doc 10 & 11.
| name | awcms-ui-screen |
| description | Implementasikan layar/komponen UI AWCMS sesuai design system. Gunakan saat membangun halaman admin/POS/portal, komponen UI, island interaktif, atau memasang design token/theme. Menegakkan token doc 14, state pattern, a11y AA, i18n, dan aturan offline-first doc 15. |
Ikuti docs/awcms/14_ui_ux_design_system.md (token, komponen, layout, layar) dan docs/awcms/15_frontend_architecture_integration.md (SSR/islands, API client, offline).
--color-*, --sp-*, --fs-*, termasuk --color-primary-strong/--color-success-strong/--color-danger-strong untuk teks putih di atas warna solid, Issue #434 — semua ≥4.5:1 terukur, jangan pakai varian polos untuk itu); jangan hardcode warna/ukuran. Theme via data-theme tanpa flash.src/components/ui (tidak ada Button/FormField/DataGrid/DataTable/Pagination/FilterBar/ActionBanner/StatusBadge/ConfirmDialog; verifikasi sendiri dengan find src/components -type d) — jangan asumsikan atau rujuk komponen ini. Layar admin nyata (src/pages/admin/offices.astro, roles.astro, users.astro, dst.) memakai hand-rolled markup + CSS class konsisten: <p class="state-notice" role="status|alert"> untuk state akses-ditolak/gagal-sementara (bedakan pesan per kasus, bukan komponen terpisah — jangan bikin blok .permission-denied ad-hoc lain); <p class="admin-create-error" role="alert" hidden> untuk error per-form/per-aksi yang di-toggle via JS; <div class="data-table-scroll"><table class="data-table">…</table></div> (dengan <td class="data-table-empty"> untuk empty state) untuk list/tabel — belum ada pagination/filter UI terpasang di layar admin manapun hari ini (API sudah keyset-cursor, tapi halaman admin merender seluruh hasil apa adanya); <span class="status-badge"> untuk status lifecycle. Untuk konfirmasi aksi destruktif, kode yang ADA SAAT INI memakai window.confirm(...) langsung (lihat roles.astro/offices.astro) — tidak ada dialog kustom; ikuti pola yang sudah ada untuk aksi destruktif baru, jangan diam-diam memperkenalkan komponen dialog baru tanpa keputusan desain eksplisit. Contoh layar admin nyata untuk dicontoh: src/pages/admin/offices.astro dan src/pages/admin/roles.astro.<p class="state-notice" role="status|alert"> — bedakan "akses ditolak" dari "gagal sementara, coba lagi", pesan aman ter-i18n dari error code doc 05), success/submitting.lockElement/sendJson/postJson (src/lib/ui/admin-form-client.ts; ekspor SATU-SATUNYA yang ada — verifikasi dengan grep -n "^export" src/lib/ui/admin-form-client.ts — jangan asumsikan showBanner/submitJson/reloadAfterDelay, ketiganya tidak ada) untuk form/tombol mutation di halaman admin. lockElement mencegah double-submit (disable tombol + label busy selama request, kembali ke semula termasuk saat gagal); sendJson/postJson mengembalikan { ok, errorCode } narrow yang tidak pernah throw. Import dari modul ini wajib, bukan sekadar DRY: CSP repo ini default-src 'self' tanpa 'unsafe-inline' (astro.config.mjs/security-headers middleware) — Astro meng-hoist <script> tanpa import menjadi inline (diblokir CSP), sedangkan script yang meng-import dari admin-form-client.ts dibundle jadi file eksternal /_astro/*.js yang diizinkan 'self'; tanpa import ini, script halaman admin bisa "diam-diam mati" karena diblokir CSP tanpa error yang jelas. Jangan duplikasi implementasi ini per halaman, dan jangan fetch mentah.GET /auth/me; backend tetap validasi (UI hiding bukan kontrol).awcms-i18n (katalog .po gettext, resolusi locale via middleware, formatter locale-aware, LanguageSwitcher.astro) — string UI statis selalu lewat t("namespace.key"), tidak pernah hardcode, termasuk komponen kecil (theme toggle, skip-link, dst. — Issue #434 menemukan ThemeToggle.astro lolos ekstraksi awal karena PR i18n tidak menyentuhnya).AdminLayout.astro, Issue #434). Sidebar admin responsif (Issue #693): di bawah --bp-md jadi off-canvas drawer dengan toggle aria-expanded/aria-controls, scrim penutup, Esc menutup + fokus kembali ke toggle, fokus pindah ke drawer saat dibuka, dan sisa halaman di-inert-kan selama drawer terbuka — jangan bangun drawer/dialog baru tanpa pola setara (lihat komentar <script> AdminLayout.astro).MaskedText; jangan cache PII mentah di IndexedDB.SyncIndicator (doc 15).overflow-x: auto), jangan biarkan tabel memaksa scroll horizontal seluruh halaman (Issue #434) — pola nyata: <div class="data-table-scroll"><table class="data-table"> seperti dipakai offices.astro/roles.astro/users.astro.disabled-kannya di client sebagai satu-satunya penjaga (contoh nyata: TenantBadge.astro menggantikan TenantSwitcher.astro yang dulu begitu). Kalau kapabilitasnya memang tidak ada untuk siapapun hari ini, jangan render bentuk kontrolnya sama sekali — render badge/teks statis. Kalau kapabilitasnya BISA ada untuk sebagian user, computed data (daftar opsi, izin) harus datang dari server berdasarkan otorisasi nyata, bukan flag/state klien; dan endpoint tujuan aksi tetap harus menolak permintaan dari user yang tidak berwenang meski UI-nya "kebetulan" tidak disembunyikan (defense-in-depth, backend adalah penegak sesungguhnya).Layout shell (admin/POS/portal) dan tabel route→persona→API ada di doc 14 §Screen inventory — patuhi route dan komponen utamanya.
fetch mentah.@axe-core/playwright, lihat tests/e2e/admin-a11y-smoke.e2e.ts) tidak menemukan pelanggaran critical/serious.awcms-new-endpoint (kontrak API), awcms-i18n (katalog .po, locale, formatter), awcms-sensitive-data (masking), awcms-testing (render/state test), awcms-browser-test (E2E Playwright + smoke aksesibilitas otomatis), awcms-ux-review (audit layar yang sudah ada), awcms-wizard-form (form multi-step — identitas/detail/lampiran/review sebelum submit).