Skip to content

docs(serapan): ADR-0120 milik redesain admin awcms, bukan repo ini - #105

Closed
ahliweb wants to merge 1 commit into
mainfrom
docs/serapan-adr-0120
Closed

ahliweb wants to merge 1 commit into
mainfrom
docs/serapan-adr-0120

Conversation

@ahliweb

@ahliweb ahliweb commented Sep 5, 2026

Copy link
Copy Markdown
Owner

Konteks

bun run audit:serapan memerah karena ahliweb/awcms menerbitkan ADR-0120
dan tak ada yang membacanya di repo ini — gerbang itu memang ada untuk
menangkap persis kasus ini.

Apa isi ADR-0120

ADR-0120
memutuskan redesain shell admin awcms, dipicu satu canvas Claude Design
(redesign/AWCMS Admin.dc.html) dan tiga defek yang ia bongkar:

  1. Pasangan warna yang "kelihatan benar" gagal WCAG — tiga dari lima
    status (primary, success, danger) gagal 4.5∶1 saat teks pekat
    dipasang di atas latar pucatnya sendiri. Ini kejadian ketiga/keempat
    defek kelas yang sama di awcms (setelah Issue #434 dan PR #720).
  2. Border kontrol yang tak mengidentifikasi apa pun--color-border
    hanya 1.29∶1/1.34∶1, di bawah 3∶1 yang diwajibkan WCAG 1.4.11.
  3. Field kontrak icon yang dideklarasikan tapi mati
    ModuleDescriptor.navigation[].icon tak pernah dibaca AdminLayout.astro.

Keputusannya: satu hue kini punya sampai tiga keluarga token (-strong yang
sudah ada, -on-soft yang baru, dan --color-border-strong yang baru),
setiap pasangan diukur di kedua tema lewat
bun run design:token-contrast:check yang digerbangi, field icon dibuat
hidup, tipografi Public Sans/JetBrains Mono di-self-host, dan
client-asset-budget.ts mendapat kelas anggaran font sendiri. Semua
berkas yang disentuh — tokens.css, admin.css, AdminLayout.astro,
sidebar-menu.ts, admin-icons.ts, design-token-contrast-check.ts,
client-asset-budget.ts — milik awcms.

Vonis yang dicatat

diperiksa — dibaca, tidak menyentuh jalur build statis repo ini.

Alasannya: repo ini tak punya satu pun berkas yang ADR-0120 sentuh (sudah
diverifikasi dengan grep, nihil). Layar admin sudah kembali sepenuhnya ke
awcms sejak ADR-0020, dan
celahnya hanya dipersempit untuk permukaan USER yang sebuah situs
turunan boleh nyatakan lewat permukaanAdmin
(ADR-0034)
— template ini sendiri tidak menyatakannya. Peta token repo ini sendiri di
ui-ux-design-system.md sudah
menyatakan jalur adopsi ke kosakata AWCMS sebagai proses bertahap dan
manual, bukan sinkron otomatis — jadi redesain nilai-token di sana tidak
otomatis menjalar ke sini.

Tidak ada kerja kode yang menyusul dari vonis ini.

Perubahan

  • .claude/skills/awcms-astro-integrasi/SKILL.md — baris ADR-0120 ditambah
    ke blok serapan bertanda.
  • .claude/skills/awcms-astro-integrasi/SKILL.id.md — angka puncak
    diperbarui (ADR-0119 → ADR-0120) dan penanda i18n-source-hash
    disegarkan mengikuti isi SKILL.md yang baru.

Verifikasi

$ bun run audit:serapan
── audit serapan ──
    cakupan: 72 ADR awcms bervonis, lantai 0049, puncak 0120
    buku besar: 0 `belum`, tepat pada plafonnya
    kesegaran: 121 ADR di ahliweb/awcms, semua yang >= lantai sudah bervonis

✓ Tidak ada pelanggaran.

$ bun run audit:dokumen
✓ Tidak ada pelanggaran.

$ bun run audit:translation
audit:translation OK — 63 mirror(s) current against their English source; 0 document(s) on the shrink-only translation ledger.

$ bun test
741 pass
12 skip
0 fail

Baseline (741 pass, 12 skip, 0 fail) sama persis — tidak berkurang, tidak ada gagal baru.

🤖 Generated with Claude Code

…punya layarnya

`bun run audit:serapan` memerah karena ahliweb/awcms menerbitkan ADR-0120 dan
tak ada yang membacanya di sini. ADR itu memecah satu hue status jadi tiga
keluarga token (`-strong`, `-on-soft` baru, dan `--color-border-strong` baru)
supaya janji kontras WCAG-nya digerbangi, bukan sekadar diasumsikan — tapi
setiap berkas yang ia sentuh (`tokens.css`, `admin.css`, `AdminLayout.astro`,
`sidebar-menu.ts`, `admin-icons.ts`, `design-token-contrast-check.ts`) adalah
shell admin milik `awcms` sendiri, dan repo ini tak satu pun memilikinya:
layar admin sudah kembali ke `awcms` sejak ADR-0020, dan celahnya hanya
dipersempit untuk permukaan USER yang sebuah situs turunan boleh nyatakan
lewat `permukaanAdmin` (ADR-0034) — bukan untuk template ini, yang tak
menyatakannya.

Divonis `diperiksa` di blok serapan `SKILL.md`, dengan alasannya tertulis di
baris itu sendiri. Mirror Indonesianya (`SKILL.id.md`) diperbarui mengikuti:
puncak jadi ADR-0120, dan penanda `i18n-source-hash` disegarkan ke hash
`SKILL.md` yang baru supaya `audit:translation` tidak melihatnya basi.

Tidak ada kerja kode yang menyusul dari vonis ini — ADR-0120 tidak
menyentuh jalur build statis repo ini sama sekali.

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
@ahliweb

ahliweb commented Sep 5, 2026

Copy link
Copy Markdown
Owner Author

Dilipat ke #104 dan sudah termerge lewat sana (commit docs(serapan): ADR-0120 … utuh di dalamnya).

Alasannya bukan kerapian: main punya DUA gerbang merah yang berdiri sendiri — audit:serapan (yang PR ini perbaiki) dan empat advisory fast-uri. Selama keduanya ada, tidak satu pun PR bisa hijau sendirian: yang mana pun mendarat lebih dulu tetap membawa merahnya yang lain. Menggabungkannya adalah satu-satunya urutan yang bisa hijau sebelum merge.

🤖 Generated with Claude Code

@ahliweb ahliweb closed this Sep 5, 2026
@ahliweb
ahliweb deleted the docs/serapan-adr-0120 branch September 5, 2026 11:44
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant