Hallmark: audit, perbaiki, buktikan
Latihan desain website bersama agen AI, dari temuan hingga perbaikan teruji.
Mulai praktik 60 menitMateri oleh Dr. Hos Arie Sibarani. Untuk mahasiswa, dosen, peneliti, dan pengembang yang sudah mengenal berkas proyek serta terminal.
Video pembelajaran dan materi presentasi
Jangan Asal Suruh AI! Pelajari cara mengaudit dan memperbaiki website dengan Hallmark, menetapkan batas kerja agen, serta memeriksa hasilnya. Materi oleh Dr. Hos Arie Sibarani; video berdurasi sekitar 20 menit dengan subtitle bahasa Indonesia.
Hasil yang Anda buat
Satu laporan audit, satu perbaikan halaman pada salinan proyek, bukti sebelum dan sesudah, serta refleksi berbasis rubrik. Pilih halaman sederhana dengan satu tujuan pengunjung.
Hallmark adalah skill untuk agen pengembang seperti Codex, Claude Code, dan Cursor. Ia menyediakan aturan desain, referensi tema, dan pemeriksa statis. Halaman ini menyediakan materi praktik dan rubrik; tidak menjalankan agen atau memindai URL pengunjung secara otomatis.
Siapkan lingkungan pengembang
Gunakan komputer dengan Git, Node.js, dan agen yang kompatibel. Hallmark memerlukan Node 18 atau lebih baru; ikuti kebutuhan versi Node proyek Anda bila lebih tinggi. Dari folder proyek, pasang untuk Codex:
npx skills add nutlope/hallmark --agent codexPerintah mengikuti versi yang tersedia di repositori sumber. Tinjau versi dan pilihan pemasangannya. Gunakan --agent claude-code atau --agent cursor sesuai lingkungan Anda; tambahkan -g hanya jika ingin pemasangan global.
Pengembangan di proyek Hossibarani
Salinan Hallmark dikunci pada versi sumber yang ditinjau dalam proyek. Setelah mengambil kode proyek, muat dependensi skill dan jalankan audit:
git submodule update --init --depth 1
npm run audit:design -- app/ai-lab/page.tsxPerintah audit memeriksa berkas lokal dan meneruskan hasil pemeriksa. Temuan FAIL dapat menghasilkan kode keluar gagal; ini berbeda dari kegagalan pemasangan. Agen membutuhkan akses ke folder proyek untuk menggunakan skill.
Praktikum 60 menit
- Tetapkan tujuan — 10 menit. Pilih halaman, audiens, dan satu tindakan utama. Catat URL, tautan, isi, formulir, dan fungsi yang harus tetap tersedia. Simpan tangkapan layar awal.
- Audit — 15 menit. Minta Hallmark membaca halaman. Catat tiga temuan beserta bukti dan dampaknya. Tandai temuan sebagai terkonfirmasi, positif palsu, atau belum diperiksa.
- Perbaiki — 20 menit. Kerjakan satu prioritas pada cabang atau salinan proyek. Pertahankan informasi yang benar, identitas visual, dan fungsi. Periksa perubahan kode.
- Uji dan refleksi — 15 menit. Jalankan audit ulang dan build. Periksa layar ponsel serta desktop, keyboard, tautan, dan isi yang dipertahankan. Isi rubrik dan sebutkan batas pengujian.
Instruksi untuk agen
Contoh berikut menggunakan Codex. Claude Code dan Cursor menggunakan /hallmark. Sesuaikan lokasi berkas dengan proyek.
$hallmark audit app/ai-lab/page.tsx
Tujuan: pengunjung menemukan materi yang sesuai.
Laporkan temuan, bukti, dampak, dan prioritas.
Bedakan pemeriksaan statis dari hasil browser.
Jangan ubah berkas atau terbitkan perubahan.$hallmark redesign app/ai-lab/page.tsx
Kerjakan pada salinan proyek. Pertahankan warna,
URL, isi faktual, status layanan, dan fungsi.
Perbaiki satu masalah prioritas hasil audit.
Tampilkan perbandingan dan hasil pengujian.
Jangan deploy sebelum hasil ditinjau.Contoh nyata: membaca hasil audit Lab
Audit statis katalog pada 2 November 2026 mencatat 3 FAIL, 1 REFLEX, dan 2 WARN. Hasil ini adalah rekaman versi awal setelah peringkasan katalog, bukan skor halaman terkini. Pemeriksaan render tidak dijalankan.
| Temuan | Makna untuk praktik |
|---|---|
| Fokus keyboard tidak terdeteksi | Kode menggunakan variabel kelas bersama. Pemeriksa statis mungkin tidak menelusurinya; uji tombol Tab dan indikator fokus pada browser sebelum menyimpulkan. |
| Rangkaian teks dengan tanda titik tengah | Ini aturan gaya Hallmark. Pertimbangkan pemisahan label; jangan menyamakannya dengan kerusakan fungsi atau pelanggaran aksesibilitas. |
| Palet bawaan dan paragraf pembuka | Tinjau konsistensi identitas serta kejelasan pesan. Peringatan merupakan masukan untuk evaluasi, bukan bukti bahwa pengguna gagal memahami halaman. |
Nilai hasil praktik Anda
Isi berdasarkan bukti. 0: belum diperiksa; 1: masalah besar; 2: sebagian memenuhi; 3: memenuhi dengan bukti; 4: teruji pada konteks tambahan.
Terisi 0 dari 5 kriteria
Formulir berjalan di browser dan tidak mengirim jawaban ke server. Isian hilang saat halaman dimuat ulang; unduh sebelum meninggalkan halaman. Skor ini bukan sertifikasi Hallmark.
Batas alat dan sumber
Pemeriksaan statis tidak membuktikan fungsi backend, kontras aktual, atau pengalaman pengguna. Mode render Hallmark memerlukan Chrome dan puppeteer-core pada lingkungan yang mendukungnya. Tetap lakukan tinjauan manusia dan catat pemeriksaan yang belum dikerjakan.
Materi merujuk Hallmark v2.0.0, commit 4f6a46c6dc325d40ab268c93e25c7b96676ebccd. Proyek berlisensi MIT; foto mengikuti lisensi masing-masing. Lab tidak berafiliasi dengan pengembang Hallmark.