git:20260928.6c89ad6 to v3.0.0

80 added, 12 removed. Audit A to A.

---

name: zero-tech-debt-auditor

- description: Autonomous orchestrator that scans, refactors, and eradicates technical debt at the end of the development lifecycle to achieve a "Zero Debt" codebase / Orkestrator otonom untuk menghapus utang teknis sebelum rilis.

- author: vibes-plug-swarm

+ description: "Autonomous orchestrator that scans, refactors, and eradicates technical debt at the end of the development lifecycle to achieve a Zero Debt codebase / Orkestrator otonom untuk menghapus utang teknis sebelum rilis."

+ author: "Roedy Rustam"

+ version: "3.0.0"

---

# Zero Tech Debt Auditor 🧹

+ [English](#english) | [Bahasa Indonesia](#bahasa-indonesia)

+ ---

+ <a name="english"></a>

+ ## English

+ ### Description

+ Autonomous orchestrator that scans, refactors, and eradicates technical debt at the end of the development lifecycle to achieve a "Zero Debt" codebase before production release.

**CRITICAL RULE**: Applications are NOT considered "Production-Ready" until they pass the Zero Technical Debt (Zero Debt) audit. This skill must be invoked at the final stage of development.

- ## Core Philosophy

+ ### Core Philosophy

Technical debt slows down future scaling. The `zero-tech-debt-auditor` acts as an autonomous SonarQube. It does not just report issues; it **fixes** them autonomously.

- ## Audit Dimensions (Dimensi Audit)

+ ### Trigger Conditions

+ - Invoked at the final verification phase before deployment (Phase 9 of zero-to-prod).

+ - When preparing an existing project for refactoring or technical debt elimination.

+ - When running comprehensive code health, deduplication, and dead code cleanup sweeps.

- ### 1. Code Duplication & DRY Enforcement

+ ### Audit Dimensions

+ #### 1. Code Duplication & DRY Enforcement

- Scan the entire codebase for repeated logic.

- Extract duplicated UI elements into reusable generic components.

- Extract duplicated business logic into shared utility functions or custom hooks.

- ### 2. Dead Code Elimination (Knip Protocol)

+ #### 2. Dead Code Elimination (Knip Protocol)

- Identify and remove unused files, exports, dependencies, and types.

- - Command the AI to review `package.json` and remove any library that is not actively imported.

+ - Review `package.json` and remove any library that is not actively imported.

- ### 3. Type Safety Rigidity (TypeScript Strictness)

+ #### 3. Type Safety Rigidity (TypeScript Strictness)

- Search for `any` or `@ts-ignore` and replace them with strict `Zod` schemas, discriminated unions, or generic types.

- Ensure all function returns are explicitly typed.

- ### 4. Hardcoded Secrets & Magic Numbers

+ #### 4. Hardcoded Secrets & Magic Numbers

- Audit the codebase for hardcoded API URLs, keys, or "magic numbers" (e.g., `const timeout = 5000;`).

- Refactor them into centralized constant files (`constants.ts`) or environment variables (`process.env`).

- ### 5. Test Coverage Handoff

+ #### 5. Test Coverage Handoff

- Ensure that critical business logic (e.g., payment webhooks, auth guards) have at least basic unit tests.

- If tests are missing, automatically generate them.

- ## Execution Protocol (Protokol Eksekusi)

+ ### Execution Protocol

When triggered, the Swarm Director must:

1. **Analyze:** Read the entire `src` directory.

2. **Report:** Generate a `TECH_DEBT_REPORT.md` (Artifact) listing the violations found.

3. **Eradicate:** Autonomously edit the files to fix the violations.

4. **Verify:** Run `npm run lint` and `npm run build` to ensure the eradications did not break the app.

- ## Orchestration & Integration (Integrasi Orkestrasi)

+ ### Orchestration & Integration

- Connected to `zero-to-prod-orchestrator`: Acts as Phase 9 (Final Handoff).

- Connected to `biome-linter-formatter-expert`: Uses strict linting rules to enforce consistency.

- Connected to `autonomous-tdd-debugger`: Fixes any tests broken during the refactoring process.

+ ---

+ <a name="bahasa-indonesia"></a>

+ ## Bahasa Indonesia

+ ### Deskripsi

+ Orkestrator otonom yang memindai, melakukan refactoring, dan menghapus utang teknis (technical debt) di akhir siklus hidup pengembangan untuk mencapai basis kode "Zero Debt" sebelum rilis ke produksi.

+ **ATURAN KRUSIAL**: Aplikasi TIDAK dianggap "Siap Produksi" sampai lulus audit Zero Technical Debt. Skill ini wajib dijalankan pada tahap akhir pengembangan.

+ ### Filosofi Utama

+ Utang teknis memperlambat skalabilitas masa depan. `zero-tech-debt-auditor` bertindak seperti SonarQube otonom. Bukan hanya melaporkan masalah, melainkan **memperbaikinya secara otonom**.

+ ### Kondisi Pemicu

+ - Dijalankan pada fase verifikasi akhir sebelum peluncuran (Fase 9 zero-to-prod).

+ - Saat mempersiapkan proyek yang sudah ada untuk pembersihan atau refaktorisasi utang teknis.

+ - Saat melakukan pembersihan menyeluruh terhadap kode mati, duplikasi, dan inkonsistensi tipe.

+ ### Dimensi Audit

+ #### 1. Duplikasi Kode & Penegakan DRY

+ - Pindai seluruh codebase untuk logika berulang.

+ - Ekstrak elemen UI yang berulang menjadi komponen generic yang dapat digunakan kembali.

+ - Ekstrak logika bisnis yang berulang ke fungsi utilitas bersama atau custom hook.

+ #### 2. Eliminasi Kode Mati (Protokol Knip)

+ - Identifikasi dan hapus file, ekspor, dependensi, dan tipe yang tidak terpakai.

+ - Tinjau `package.json` dan hapus dependensi yang tidak pernah diimpor.

+ #### 3. Ketelitian Tipe (TypeScript Strictness)

+ - Cari penggunaan `any` atau `@ts-ignore` dan ganti dengan skema `Zod`, discriminated unions, atau tipe generic yang ketat.

+ - Pastikan semua nilai kembalian fungsi memiliki tipe eksplisit.

+ #### 4. Kunci Rahasia & Angka Ajaib (Magic Numbers)

+ - Audit codebase untuk URL API, kunci rahasia, atau konstanta ajaib yang di-hardcode.

+ - Refaktor ke dalam file konstanta terpusat (`constants.ts`) atau variabel lingkungan (`process.env`).

+ #### 5. Cakupan Pengujian

+ - Pastikan logika bisnis penting (seperti webhook pembayaran, penjaga autentikasi) memiliki unit test dasar.

+ - Buat test otomatis jika belum ada.

+ ### Protokol Eksekusi

+ 1. **Analisis:** Pindai seluruh direktori `src`.

+ 2. **Laporan:** Buat artifak `TECH_DEBT_REPORT.md` yang merinci pelanggaran yang ditemukan.

+ 3. **Pemberantasan:** Edit file secara mandiri untuk memperbaiki masalah.

+ 4. **Verifikasi:** Jalankan linting dan build untuk memastikan perbaikan tidak merusak aplikasi.

+ ### Integrasi Orkestrasi

+ - Terhubung ke `zero-to-prod-orchestrator`: Bertindak sebagai Fase 9 (Serah Terima Akhir).

+ - Terhubung ke `biome-linter-formatter-expert`: Memakai aturan linting ketat untuk menjaga konsistensi.

+ - Terhubung ke `autonomous-tdd-debugger`: Memperbaiki pengujian yang terganggu selama proses refactoring.