news-times

Imported from article-website/news-times (AGENTS.md). Install upstream with npx skills add article-website/news-times. Copyright stays with the author.

This is NOT the Next.js you know

This version has breaking changes — APIs, conventions, and file structure may all differ from your training data. Read the relevant guide in node_modules/next/dist/docs/ (resolved from this file's directory; in monorepos the next package may not be visible from the repo root) before writing any code. Heed deprecation notices.

This block is written and re-added by next dev — verify at node_modules/next/dist/server/lib/generate-agent-files.js. Removing it from a diff only re-creates the uncommitted change; committing it with your work keeps the tree clean.

BACA INI DULU — NewsTimes

Bagian ini ditulis tim, bukan oleh Next.js. Aman dari penulisan ulang next dev, yang hanya menimpa blok di antara penanda BEGIN/END di atas.

Kondisi proyek dan progres terkini ada di STATUS.md. Baca itu lebih dulu sebelum mengubah apa pun — di situ ada apa yang sudah jalan, apa yang belum, dan hasil pengujian terakhir beserta tanggalnya.

Kalau ada panduan lain di repo ini yang bertentangan dengan berkas ini, berkas ini yang menang — lihat bagian setelah daftar aturan.

Sembilan aturan yang tidak boleh dilanggar

1. Halaman tidak boleh menyentuh database langsung. Jangan import Prisma dari dalam src/app/; semua akses data lewat @/server/repositories.
2. src/data/articles.ts berstatus beku — jangan diubah bentuknya.
3. prisma/schema.prisma tidak boleh diubah sendirian, harus dibahas dengan tim.
4. .env.local tidak boleh di-commit. Yang boleh ikut hanya .env.example.
5. Jangan push langsung ke main. Buat branch, buka PR, minta satu orang review.
6. Satu orang satu wilayah — jangan memperbaiki kerjaan orang lain tanpa sepengetahuannya.
7. Gambar tidak masuk git.
8. Usahakan PR di bawah 400 baris.
9. Status verifikasi hanya boleh PASS, FAIL, atau NOT_RUN. Jangan pernah menulis PASS untuk perintah yang belum benar-benar dijalankan.

Kalau aturan ECC bertabrakan dengan sembilan aturan di atas

Folder .claude/ berisi konfigurasi agent dari ECC. Isinya ikut terbaca agent, termasuk 122 berkas aturan bawaan ECC di .claude/rules/ecc/ yang bukan kesepakatan tim ini.

Sembilan aturan di atas selalu menang. Aturan ECC diperlakukan sebagai bahan rujukan, bukan kewajiban.

Tiga tabrakan yang sudah diketahui:

Kalau menurutmu sebuah aturan ECC memang lebih baik, usulkan ke tim lewat PR — jangan diam-diam dipakai sebagai dasar mengubah kode.

Dokumentasi

Setelah menyelesaikan pekerjaan, perbarui STATUS.md — caranya ada di bagian bawah berkas itu.

Untuk agent selain Claude

Folder .agents/ berisi aturan, skill, dan alur kerja proyek ini dalam format yang dipakai Codex dan Antigravity. Skill yang tersedia: newstimes-konteks, newstimes-akses-data, newstimes-verifikasi, newstimes-perbarui-status.