@ojokesusu/lintasai 1.1.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (86) hide show
  1. package/.github/workflows/publish-npm.yml +40 -0
  2. package/.github/workflows/validate.yml +93 -0
  3. package/AUDIT_POST_SETUP_PROMPT_v1.md +280 -0
  4. package/BOOTSTRAP_PROJECT_DOCS_PROMPT_v1.md +3 -0
  5. package/CHANGELOG.md +313 -0
  6. package/CLAUDE_universal_v1.md +1021 -0
  7. package/CONTRIBUTING.md +101 -0
  8. package/FIRST_SESSION_PROMPT_v1.md +7 -0
  9. package/JALANKAN_KIT.md +188 -0
  10. package/LICENSE +21 -0
  11. package/MULAI_DI_SINI.md +145 -0
  12. package/PROJECT_KICKOFF_PROMPT_v1.md +3 -0
  13. package/PROJECT_LIFECYCLE_PROMPT_v1.md +536 -0
  14. package/PROJECT_MIGRATION_PROMPT_v1.md +3 -0
  15. package/README.md +505 -0
  16. package/SETUP_POLA_B_PROMPT_v1.md +5 -0
  17. package/SPLIT_REPO_MIGRATION_PROMPT_v1.md +485 -0
  18. package/TEAM_ROLLOUT_GUIDE_v1.md +172 -0
  19. package/UPDATE_DOCS_PROMPT_v1.md +3 -0
  20. package/UPDATE_KIT_PROMPT_v1.md +213 -0
  21. package/bin/lintasai.js +81 -0
  22. package/docs/SIGNED_RELEASE.md +162 -0
  23. package/install-windows.ps1 +225 -0
  24. package/kit.ps1 +508 -0
  25. package/lib/agents-md.ps1 +174 -0
  26. package/lib/git-helpers.ps1 +104 -0
  27. package/lib/kit-files.psd1 +133 -0
  28. package/lib/manifest-signing.ps1 +65 -0
  29. package/lib/manifest.ps1 +267 -0
  30. package/lib/rollback.ps1 +241 -0
  31. package/lib/safety.ps1 +193 -0
  32. package/lib/template-deploy.ps1 +242 -0
  33. package/lib/version-detect.ps1 +161 -0
  34. package/package.json +36 -0
  35. package/setup-pola-b.ps1 +687 -0
  36. package/templates/ANALOGI_LIBRARY.md +7 -0
  37. package/templates/CLAUDE_TEAM_GUIDE.md +505 -0
  38. package/templates/CROSS_REPO_TYPES_PIPELINE.md +473 -0
  39. package/templates/DB_SCHEMA_SCAN_PROMPT.md +194 -0
  40. package/templates/DISCORD_BOT_INTEGRATION.md +187 -0
  41. package/templates/GLOSSARY_NON_PROGRAMMER.md +361 -0
  42. package/templates/INDEX.md +157 -0
  43. package/templates/MCP_SETUP.md +1145 -0
  44. package/templates/MIGRATE_TO_SUBFOLDER_PROMPT_v1.md +220 -0
  45. package/templates/ONBOARDING.md +172 -0
  46. package/templates/PROJECT_STARTER_TEMPLATES.md +264 -0
  47. package/templates/PROMPT_LIBRARY.md +790 -0
  48. package/templates/RLS_SETUP_PROMPT.md +167 -0
  49. package/templates/SECURITY_INCIDENT_PLAYBOOK.md +191 -0
  50. package/templates/SPLIT_REPO_AGENTS_TEMPLATES.md +32 -0
  51. package/templates/SPLIT_REPO_NON_PROGRAMMER_PROMPTS.md +604 -0
  52. package/templates/SPLIT_REPO_TOOLS_SETUP.md +388 -0
  53. package/templates/STACK_DETECTION_PATTERN.md +261 -0
  54. package/templates/STACK_GUIDE.md +564 -0
  55. package/templates/STACK_MIGRATION_GUIDE.md +154 -0
  56. package/templates/STACK_VERSIONS.md +31 -0
  57. package/templates/UPDATE_GUIDE.md +246 -0
  58. package/templates/_EXAMPLE.md +110 -0
  59. package/templates/_PATTERNS.md +173 -0
  60. package/templates/architecture.md +180 -0
  61. package/templates/architecture_auto.md +61 -0
  62. package/templates/decisions/README.md +108 -0
  63. package/templates/decisions/_TEMPLATE.md +84 -0
  64. package/templates/feature-flags-advanced.md +171 -0
  65. package/templates/github/CODEOWNERS.template +61 -0
  66. package/templates/github/GENERATE_TYPES_SCRIPT.md +77 -0
  67. package/templates/github/PUBLISH_SHARED_WORKFLOW.yml +52 -0
  68. package/templates/github/RECEIVE_BACKEND_UPDATE.yml +106 -0
  69. package/templates/github/RENOVATE_FRONTEND.json +28 -0
  70. package/templates/github/TRIGGER_FRONTEND_UPDATE.yml +29 -0
  71. package/templates/github/pull_request_template.md +44 -0
  72. package/templates/github/scripts/ai-review.js +153 -0
  73. package/templates/github/workflows/ai-review.yml +61 -0
  74. package/templates/github/workflows/backup-schemas.yml +169 -0
  75. package/templates/glossary.md +110 -0
  76. package/templates/split-agents/BACKEND.md +149 -0
  77. package/templates/split-agents/FRONTEND.md +141 -0
  78. package/templates/split-agents/SHARED.md +82 -0
  79. package/templates/split-agents/TOOLS.md +77 -0
  80. package/tests/Run-Tests.ps1 +19 -0
  81. package/tests/lib-safety.Tests.ps1 +66 -0
  82. package/tests/rollback.Tests.ps1 +66 -0
  83. package/tests/uninstall.Tests.ps1 +265 -0
  84. package/tests/update-kit.Tests.ps1 +78 -0
  85. package/uninstall.ps1 +794 -0
  86. package/update-kit.ps1 +907 -0
@@ -0,0 +1,101 @@
1
+ # Contributing — Panduan Usul Perubahan Aturan Tim
2
+
3
+ Kit ini standar tim IT. Anggota tim **dianjurkan** usul perubahan kalau ketemu masalah, ide bagus, atau aturan yang sudah tidak relevan. File ini menjelaskan cara usul yang efisien.
4
+
5
+ > Panduan lengkap governance ada di [`TEAM_ROLLOUT_GUIDE_v1.md`](TEAM_ROLLOUT_GUIDE_v1.md). File ini fokus pada **cara anggota tim berkontribusi**.
6
+
7
+ ---
8
+
9
+ ## Siapa boleh usul?
10
+ **Semua anggota tim.** Junior atau senior, sama saja — ide bagus bisa datang dari mana saja. Owner standar (1 orang) yang approve final.
11
+
12
+ ## Apa yang bisa diusulkan?
13
+ - Tambah aturan baru (mis. "wajib ada test untuk fungsi utility yang dipakai >2 tempat").
14
+ - Ubah aturan existing (mis. "ganti format commit dari custom ke Conventional Commits").
15
+ - Hapus aturan yang sudah tidak relevan.
16
+ - Tambah/ubah/hapus prompt atau template.
17
+ - Perbaiki typo / klarifikasi instruksi yang ambigu.
18
+ - Tambah skenario pakai baru (mis. "skenario 5: migrasi proyek multi-repo").
19
+ - Tambah ide opsional (tier "should"/"nice") ke seksi 15 di CLAUDE.md.
20
+
21
+ ## Apa yang TIDAK perlu diusulkan (langsung kirim aja)
22
+ - Typo fix di file kit (kirim langsung ke channel `#it-standard`).
23
+ - Pertanyaan klarifikasi soal cara pakai (tanya di channel, jawaban bisa jadi FAQ baru).
24
+ - Bug report (kirim langsung — bug != usulan perubahan aturan).
25
+
26
+ ---
27
+
28
+ ## Format usulan (template)
29
+
30
+ Buat issue/PR baru di repo standar dengan format berikut. Bahasa Indonesia, ramah.
31
+
32
+ ```markdown
33
+ # Usulan: <judul singkat dalam 1 baris>
34
+
35
+ > Pengusul: <nama / handle> · Tanggal: <YYYY-MM-DD> · Target versi: <v1.x / v2>
36
+
37
+ ## Aturan yang diusulkan
38
+ <1-3 kalimat. Apa aturan barunya? Atau aturan lama yang mana yang diubah?>
39
+
40
+ Contoh konkret aturan baru:
41
+ > "Semua handler API yang melakukan write database WAJIB pakai transaction."
42
+
43
+ ## Alasan
44
+ <1-2 paragraf. Kenapa aturan ini perlu? Masalah apa yang sudah pernah ketemu di proyek? Manfaat apa yang didapat tim?>
45
+
46
+ ## Dampak
47
+ - **Proyek yang terdampak:** semua / sebagian (sebutkan) / spesifik
48
+ - **Effort migrasi per-proyek:** ringan (<30 menit) / sedang (1-2 hari) / besar (sprint terpisah)
49
+ - **Breaking change?** Ya / Tidak. Kalau ya, prioritas tier P0 / P1 / P2.
50
+ - **File kit yang berubah:** CLAUDE.md / PROMPT mana / template mana
51
+
52
+ ## Alternatif yang dipertimbangkan
53
+ <2-3 alternatif yang ditolak + alasan kenapa pilihan utamamu lebih baik>
54
+
55
+ ## Contoh penerapan
56
+ ```code
57
+ <snippet kode yang menunjukkan aturan diterapkan>
58
+ ```
59
+
60
+ ## Pertanyaan terbuka (opsional)
61
+ <hal-hal yang kamu sendiri masih ragu, supaya diskusi tim membantu memutuskan>
62
+ ```
63
+
64
+ ---
65
+
66
+ ## Alur review
67
+
68
+ 1. **Anggota** buka issue/PR pakai template di atas.
69
+ 2. **Tim** diskusi di issue/PR (atau channel `#it-standard`). Junior boleh nimbrung — debat ide, bukan orang.
70
+ 3. **Owner** standar review di akhir bulan (cadence default).
71
+ 4. Keputusan owner: **Approve** (masuk versi berikutnya), **Reject** (catat alasan, simpan untuk arsip), atau **Minta revisi** (balik ke pengusul).
72
+ 5. Kalau approve: owner update file kit, bump versi (patch/minor/major sesuai), rilis ke tim.
73
+
74
+ ## Cadence rilis
75
+ - **Patch (`v1.x.y`):** kapan saja, untuk typo fix / klarifikasi.
76
+ - **Minor (`v1.x`):** akhir bulan kalau ada usulan baru yang terkumpul.
77
+ - **Major (`vX`):** dijadwalkan eksplisit, announce minimal 1 minggu sebelumnya. Breaking change.
78
+
79
+ ---
80
+
81
+ ## Yang dihindari saat berkontribusi
82
+
83
+ - **Modif kit di lokal diam-diam** — anggota tim lain gak tahu, standar tim pecah. Selalu usul resmi.
84
+ - **Modif aturan untuk 1 proyek doang** — pakai mekanisme **exception** (lihat `TEAM_ROLLOUT_GUIDE_v1.md` seksi "Exception management"), bukan ubah kit global.
85
+ - **Usul tanpa alasan konkret** — "rasanya lebih bagus" gak cukup. Sertakan masalah nyata yang pernah ketemu.
86
+ - **Argumen pakai authority** ("X di [perusahaan besar] pakai begini") — kasih konteks kenapa relevan untuk tim **kita**.
87
+ - **Debat di DM owner satu-satu** — diskusi di channel/issue supaya semua anggota bisa belajar dari pertimbangan.
88
+
89
+ ---
90
+
91
+ ## Code of Conduct singkat
92
+
93
+ - **Junior boleh usul, senior wajib dengar.** Ide bagus dari junior sering nemu blind spot senior.
94
+ - **Kritik ide, bukan orang.** "Aturan ini bermasalah karena X" ≠ "kamu salah".
95
+ - **Asumsi positif.** Pengusul tidak bermaksud nge-troll; kalau usulnya aneh, tanya konteksnya dulu sebelum reject.
96
+ - **Bahasa Indonesia, casual ramah.** Sesuai gaya kit ini.
97
+
98
+ ---
99
+
100
+ ## Pertanyaan?
101
+ Buka di channel `#it-standard` atau DM owner standar (lihat `TEAM_ROLLOUT_GUIDE_v1.md` untuk siapa owner saat ini).
@@ -0,0 +1,7 @@
1
+ # DEPRECATED (lintasAI v1.0.0 republish 2026-06-04)
2
+
3
+ File ini deprecated. First-session workflow sudah jadi bagian dari JALANKAN_KIT.md.
4
+
5
+ -> Pakai [JALANKAN_KIT.md](JALANKAN_KIT.md)
6
+
7
+ Content lama bisa dicek di git history sebelum 2026-06-04.
@@ -0,0 +1,188 @@
1
+ > ## INI FILE BUAT AI BACA, BUKAN KAMU!
2
+ >
3
+ > **Halo staff baru!** Kalau kamu **bukan programmer**, JANGAN baca isi file ini — bikin pusing dan nggak perlu. Langsung buka **`MULAI_DI_SINI.md`** (1 halaman, bahasa awam).
4
+ >
5
+ > **Cara pakai file ini (4 langkah):**
6
+ > 1. Buka **Claude Code** (aplikasi AI-nya).
7
+ > 2. **Copy seluruh isi file ini**: tekan `Ctrl+A` (select all) lalu `Ctrl+C` (copy).
8
+ > 3. **Paste ke chat Claude Code**: tekan `Ctrl+V` lalu Enter.
9
+ > 4. **Selesai** — AI auto-execute semua langkah di bawah.
10
+ >
11
+ > **Total waktu**: ~5 menit kamu copy-paste + AI kerja sendiri.
12
+
13
+ ---
14
+
15
+ Tolong jalankan setup Pola B kit AI di proyek ini. Aku sudah copy folder `claude-ai-rules-kit/` (atau versi terbaru di-extract dari zip / di-clone dari GitHub) ke root proyek.
16
+
17
+ Eksekusi workflow ini end-to-end (rename folder, run script, write skeleton `docs/` + file tim `.github/`, scan struktur proyek read-only). AI proceed dengan defaults tanpa nanya tiap step REGULER. Cuma **2-3 popup utama** yang require explicit input. Destructive ops tetap WAJIB konfirmasi 1x.
18
+
19
+ > **Confirmation Policy (auto-confirm mode)**: Sesuai user auto-confirm preference: AI proceed dengan defaults tanpa nanya tiap step REGULER. Cuma popup utama (2-3) yang require explicit input. Destructive ops (delete, force-push, rm -rf, DROP, prisma migrate prod) tetap WAJIB konfirmasi 1x walau auto-confirm aktif. Lihat `CLAUDE_universal_v1.md` section 8.1 (AI Anti-Prompt-Injection Rules) untuk detail.
20
+
21
+ > Catatan: Claude Code IDE mungkin tetap nanya YES/NO untuk tool call individu (PowerShell, Edit) tergantung permission setting kamu (centang "Always allow" kalau muncul). Itu IDE-level, bukan dari prompt ini.
22
+
23
+ ---
24
+
25
+ ## WORKFLOW (lakukan otomatis tanpa konfirmasi tambahan AI-side, kecuali Popup #1, #2, dan #3 conditional)
26
+
27
+ ### Bagian 1 — Setup teknis (auto, no popup)
28
+
29
+ 1. Konfirmasi folder kit (`claude-ai-rules-kit/` atau nama serupa, atau `.claude-kit/` kalau clone dari GitHub) ada di root proyek.
30
+ 2. Rename folder jadi `.claude-kit/` kalau belum (PowerShell `Rename-Item`). Kalau hasil clone, biasanya sudah `.claude-kit/`.
31
+ 3. **Kalau hasil clone**: hapus `.claude-kit/.git/` supaya tidak konflik dengan git proyek user (`Remove-Item .claude-kit\.git -Recurse -Force` di PowerShell).
32
+ 4. Jalankan `.\.claude-kit\setup-pola-b.ps1 -Force` via PowerShell. Kalau kena Execution Policy: `Set-ExecutionPolicy -Scope Process -ExecutionPolicy Bypass` dulu.
33
+ 5. Tunjukkan output script (setup-pola-b.ps1 auto-copy file skeleton + 17 file tim profesional ke proyek by default).
34
+ 6. Verifikasi: `AGENTS.md` di root tergenerate + 14 file inti `.claude-kit/` ada + 5 file skeleton `docs/` + 17 file tim (`.github/` workflows + `docs/` panduan tim).
35
+ 7. Baca `AGENTS.md` + `.claude-kit/CLAUDE_universal_v1.md` (terutama seksi 4.1 Multi-Divisi + 4.2 Pattern-Driven + 4.3 Guided Step-by-Step + 7.1-7.5 dokumentasi) untuk load aturan.
36
+
37
+ ### Bagian 2 — POPUP UTAMA #1: Setup Mode
38
+
39
+ > **Sebelum show popup**, AI auto-detect stack via `templates/STACK_DETECTION_PATTERN.md`. Hasil detection dipakai untuk auto-decide Popup #2 default + Popup #3 conditional.
40
+
41
+ 8. **AI WAJIB tanya user** dengan format persis ini (Popup #1):
42
+
43
+ ```
44
+ 🎯 lintasAI Setup — Pilih mode (Enter = default Quick):
45
+
46
+ [1] QUICK (default, recommended untuk 90% user)
47
+ ✅ Setup kit + AGENTS.md
48
+ ✅ Auto-generate docs skeleton saat dibutuhkan (LAZY)
49
+ ✅ Bulk-bootstrap NANTI saat user explicitly request
50
+ Effort: 5 menit
51
+
52
+ [2] FULL (untuk owner yang mau comprehensive)
53
+ ✅ Setup kit + AGENTS.md
54
+ ✅ Bulk-bootstrap docs SEKARANG (30-60 menit, token-heavy)
55
+ ✅ Schema scan + dependency audit
56
+ Effort: 60 menit
57
+
58
+ [3] ADVANCED (untuk power user)
59
+ Custom: pick & choose per feature
60
+
61
+ Pilihan: ___ (default 1)
62
+ ```
63
+
64
+ 9. Tunggu jawaban user (auto-confirm: kosong/Enter → "1" = Quick):
65
+ - **"1" / Enter / kosong** ⭐ DEFAULT → Mode Quick. Lanjut Popup #2. Bulk-bootstrap di-defer (LAZY-GENERATE aktif).
66
+ - **"2"** → Mode Full. Lanjut Popup #2 + auto-execute bulk-bootstrap SEMUA kandidat CRITICAL + schema scan setelah Popup #2 dijawab.
67
+ - **"3"** → Mode Advanced. Lanjut Popup #2, lalu prompt sub-menu pick & choose per feature (auth saja / DB saja / dst).
68
+
69
+ ### Bagian 3 — POPUP UTAMA #2: Project Type & Future Plans
70
+
71
+ 10. **AI WAJIB tanya user** dengan format persis ini (Popup #2):
72
+
73
+ ```
74
+ 🏗️ Project type kamu apa? (untuk customize recommendations)
75
+
76
+ [1] SOLO project (kamu sendiri, no staff coming)
77
+ [2] SMALL TEAM (1-5 staff hired or planning)
78
+ [3] GROWING TEAM (5+ staff, considering split repo nanti)
79
+ [4] MIGRATION (existing big project mau adopt lintasAI)
80
+
81
+ Pilihan: ___ (default detect dari STACK_DETECTION_PATTERN.md)
82
+ ```
83
+
84
+ 11. Tunggu jawaban user (auto-confirm: kosong/Enter → auto-detect dari stack pattern; fallback "1" Solo kalau tidak ada signal):
85
+ - **"1" SOLO** → Skip split repo offer. CODEOWNERS placeholder OK. Skip team-onboarding heavy docs.
86
+ - **"2" SMALL TEAM** → Setup file tim `.github/` + `docs/CLAUDE_TEAM_GUIDE.md` aktif. Skip split repo offer. Reminder edit CODEOWNERS dengan username actual.
87
+ - **"3" GROWING TEAM** → Semua "Small Team" + auto-offer split repo migration di akhir (jadi Popup #3 conditional kalau juga mature + monolithic).
88
+ - **"4" MIGRATION** → Auto-execute `PROJECT_LIFECYCLE_PROMPT_v1.md` (Stage D: Migration) workflow (scan code existing → assess docs gap → migrasi bertahap).
89
+
90
+ 12. **AI auto-execute file tim copy + scan + bulk-bootstrap berdasarkan combo Popup #1 + Popup #2** (tanpa popup tambahan):
91
+ - File tim ter-copy oleh setup script (anti-overwrite, 17 file: `.github/workflows/*`, `.github/scripts/*`, `.github/CODEOWNERS`, `.github/pull_request_template.md`, `docs/CLAUDE_TEAM_GUIDE.md`, `docs/PROMPT_LIBRARY.md`, `docs/ONBOARDING.md`, `docs/STACK_GUIDE.md`, `docs/MCP_SETUP.md`, `docs/RLS_SETUP_PROMPT.md`, `docs/DB_SCHEMA_SCAN_PROMPT.md`, `docs/GLOSSARY_NON_PROGRAMMER.md`, `docs/SECURITY_INCIDENT_PLAYBOOK.md`, `docs/feature-flags-advanced.md`, `docs/decisions/_TEMPLATE.md`, `docs/decisions/README.md`).
92
+ - **UNIVERSAL ADAPTIVE SCAN** (read-only, no cap): auto-detect tech stack dari manifest, glob recursive folder source umum, pattern CRITICAL (auth / db / security / api / entry / feature domain), filter skip auto-generated, hitung total kandidat per kategori + per subfolder.
93
+ - **DB schema scan** (kalau detected): `prisma/schema.prisma`, `db/schema.ts`, `models/*`, `migrations/*`, `@Entity` annotation → generate `docs/db-schema.md` via `templates/DB_SCHEMA_SCAN_PROMPT.md`.
94
+ - **Auto-decide grouping strategy**: < 30 kandidat → flat di `docs/<basename>.md`; >= 30 → subfolder grouping (`docs/api/`, `docs/lib/`, `docs/security/`, `docs/features/<nama>/`, `docs/middleware/`).
95
+ - **Bulk-bootstrap derive dari Popup #1**:
96
+ - Popup #1 = "1" Quick → SKIP bulk-bootstrap. LAZY-GENERATE per-file aktif.
97
+ - Popup #1 = "2" Full → execute `PROJECT_LIFECYCLE_PROMPT_v1.md` (Stage B: Bootstrap Docs) untuk SEMUA kandidat + schema scan + dependency audit.
98
+ - Popup #1 = "3" Advanced → tampilkan sub-menu pick kategori (auth saja / DB saja / security saja / dst).
99
+
100
+ ### Bagian 4 — Sapa user + announce aturan (auto, no popup)
101
+
102
+ 13. Sapa user Bahasa Indonesia ramah, sebut versi kit aktif + kondisi yang aktif (mode Popup #1 + project type Popup #2 + status bulk-bootstrap).
103
+
104
+ 14. Umumkan **4 aturan dokumentasi tim profesional** (`CLAUDE_universal_v1.md` seksi 7.1-7.4) — **WAJIB untuk SEMUA kondisi**:
105
+ - **7.1 AUTO-SYNC** — tiap edit code yang punya `docs/<basename>.md`, AI WAJIB update `.md` di sesi yang sama.
106
+ - **7.2 LAZY-GENERATE** — tiap buat/edit file kode CRITICAL yang belum ada `.md`, AI **sugest** generate per-file.
107
+ - **7.3 READ-MINIMAL** — AI baca `docs/architecture.md` + `docs/architecture_auto.md` DULU, lalu cherry-pick.
108
+ - **7.4 ARCHITECTURE REGISTRY** — `docs/architecture.md` = peta makro user-edit + `docs/architecture_auto.md` = registry TOC AI-maintained.
109
+
110
+ 15. Arahkan user ke action items berdasarkan project type (Popup #2):
111
+ - **SMALL TEAM / GROWING TEAM**: edit `.github/CODEOWNERS` ganti placeholder dengan GitHub username actual. Setup `ANTHROPIC_API_KEY` di GitHub Secrets. Baca `docs/CLAUDE_TEAM_GUIDE.md` + `docs/PROMPT_LIBRARY.md`.
112
+ - **SOLO**: skip CODEOWNERS setup. Reminder kalau pakai DB: setup PostgreSQL role per `docs/MCP_SETUP.md`.
113
+ - **MIGRATION**: workflow migration sudah jalan, follow output `PROJECT_LIFECYCLE_PROMPT_v1.md` (Stage D: Migration).
114
+
115
+ ### Bagian 5 — POPUP CONDITIONAL #3: Audit Now? (cuma muncul kalau project mature)
116
+
117
+ 16. **AI auto-detect project maturity** via `templates/STACK_DETECTION_PATTERN.md`:
118
+ - **Trigger conditions** (SEMUA harus terpenuhi):
119
+ - Project punya code real (>= 90 file source, bukan boilerplate fresh)
120
+ - Business logic exist (folder `src/` / `app/` / `lib/` terisi feature actual)
121
+ - Bukan template default (manifest punya custom deps, bukan starter kit kosong)
122
+ - Kalau **tidak match** → skip Popup #3, langsung closing.
123
+
124
+ 17. **AI WAJIB tanya user kalau trigger terpenuhi** (Popup #3 conditional):
125
+
126
+ ```
127
+ 🔍 Project kamu mature (detected: 90+ files, business logic exist).
128
+
129
+ Mau audit komprehensif sekarang? (8-dimensi analysis, 5-10 menit)
130
+ [Y] Yes (default)
131
+ [N] No, audit nanti
132
+
133
+ Pilihan: ___ (default Y)
134
+ ```
135
+
136
+ 18. Tunggu jawaban (auto-confirm: kosong/Enter → "Y" = audit sekarang):
137
+ - **"Y" / Enter / kosong** ⭐ DEFAULT → Eksekusi `AUDIT_POST_SETUP_PROMPT_v1.md` workflow langsung (read-only). 8 dimensi: refactor / security / qa-test / database / devops / performance / docs-gap / onboarding. Adversarial verify per finding. Output ranked low → high risk (3 tier) + analogi non-programmer + sprint execution plan. Detail di `CLAUDE_universal_v1.md` section 4.4 + file standalone `AUDIT_POST_SETUP_PROMPT_v1.md`.
138
+ - **"N"** → Skip audit. Tutup dengan: **"Semua aktif. Mulai task pertama kapanpun — aku sudah load aturan + LAZY-GENERATE siap. Audit bisa di-trigger kapan saja dengan: 'audit project' / paste AUDIT_POST_SETUP_PROMPT_v1.md / 'review codebase'."**
139
+
140
+ ### Bagian 6 — Auto-Decide: Split Repo Migration (no popup, derive dari Popup #2)
141
+
142
+ 19. **AI auto-decide split repo migration offer** berdasarkan Popup #2 answer + stack detection:
143
+ - **Popup #2 = "1" SOLO atau "2" SMALL TEAM** → SKIP, jangan tanya.
144
+ - **Popup #2 = "3" GROWING TEAM** + stack detection match (project mature + monolithic Next.js full-stack atau similar) → auto-execute migration workflow check:
145
+ - Cek `docs/MIGRATION_REMINDER.md` atau `docs/decisions/*split-repo*.md` exist → SKIP (anti-spam, user sudah decide sebelumnya).
146
+ - Kalau belum ada record → tampilkan offer split repo (preview architecture, trade-off, 3 pilihan YES/NO/LATER). Kalau user pilih LATER → catat reminder di `docs/MIGRATION_REMINDER.md`. Kalau YES → execute `SPLIT_REPO_MIGRATION_PROMPT_v1.md`.
147
+ - **Popup #2 = "4" MIGRATION** → split repo offer di-defer ke akhir workflow `PROJECT_LIFECYCLE_PROMPT_v1.md` (Stage D: Migration) (sudah handle di sana).
148
+
149
+ ---
150
+
151
+ ## Aturan AI selama workflow ini
152
+
153
+ - **Auto-confirm mode (per user preference)** dari user paste prompt → lakukan tiap step REGULER langsung tanpa nanya. Untuk **destructive ops** (delete, force-push, rm -rf, DROP, prisma migrate prod) AI WAJIB tanya 1x walau auto-confirm aktif (lihat `CLAUDE_universal_v1.md` section 8.1). JANGAN minta konfirmasi AI-side tambahan untuk step reguler **kecuali**:
154
+ - **Popup #1** (Step 8 — WAJIB tanya Setup Mode [1] Quick / [2] Full / [3] Advanced).
155
+ - **Popup #2** (Step 10 — WAJIB tanya Project Type [1] Solo / [2] Small / [3] Growing / [4] Migration).
156
+ - **Popup #3 CONDITIONAL** (Step 17 — HANYA muncul kalau project mature: 90+ files + business logic exist + bukan boilerplate. Kalau tidak match, skip diam-diam tanpa popup).
157
+ - **BOOTSTRAP FASE 5** (per-file approval optional — pakai mode "approve all per kategori" untuk efisiensi).
158
+ - Auto-decide tanpa popup untuk:
159
+ - **Bulk-bootstrap mode** → derive dari Popup #1 (Quick = skip bulk, Full = bulk semua, Advanced = sub-menu).
160
+ - **Split repo migration** → derive dari Popup #2 (Solo/Small = skip, Growing = offer kalau mature + monolithic, Migration = defer ke workflow migration).
161
+ - **Audit komprehensif** → derive dari project maturity detection (mature = Popup #3 muncul, fresh = skip).
162
+ - Kalau ERROR yang gak bisa di-fix sendiri, lapor + saran fix.
163
+ - JANGAN ubah file di `.claude-kit/` (read-only).
164
+ - Anti-overwrite di `docs/` + `.github/`: file existing di-skip, tidak ditimpa.
165
+ - **Default Quick (1)** kalau user jawab kosong/Enter di Popup #1. Filosofi: 90% user butuh setup ringan + LAZY-GENERATE on-demand; bulk-bootstrap bisa di-trigger nanti saat owner explicitly request.
166
+ - **Default auto-detect** kalau user jawab kosong/Enter di Popup #2. Stack pattern detection biasanya akurat untuk inferring project type.
167
+ - **Default Yes (Y)** kalau user jawab kosong/Enter di Popup #3 conditional. Filosofi: context masih hangat dari setup, audit comprehensive 5-10 menit = high-leverage moment.
168
+ - IDE permission prompt (PowerShell/Edit YES-NO) di luar kontrol prompt ini.
169
+ - Semua respons AI ke user dalam **Bahasa Indonesia** (sesuai aturan global).
170
+
171
+ ---
172
+
173
+ ## Untuk Staff Baru (Day 0 Pertama Kali Pakai lintasAI)
174
+
175
+ Setelah selesai workflow di atas, kalau kamu **staff IT non-programmer baru pertama kali pakai lintasAI**, AI akan auto-trigger **Guided Step-by-Step Pattern** (`CLAUDE_universal_v1.md` section 4.3):
176
+
177
+ - 6 phase universal (Foundation → Reading → Project Context → Environment Setup → First Micro-Task → Daily Work Starts)
178
+ - Wait-for-confirm pattern: AI minta kamu konfirm tiap step sebelum lanjut, tidak overwhelm
179
+ - Berlaku universal untuk SEMUA project (akses, bigseo, pbn-monitor, dst.)
180
+ - Phase 2 (reading GLOSSARY + SECURITY_PLAYBOOK) cuma sekali per staff — di-skip kalau pernah baca
181
+
182
+ Trigger conditions: detect `architecture.md` fresh-generated, `AGENTS.md` placeholder belum filled, atau user eksplisit ngomong "halo aku staff baru".
183
+
184
+ Detail lengkap di `CLAUDE_universal_v1.md` seksi 4.3.
185
+
186
+ ---
187
+
188
+ Mulai dari langkah 1 sekarang.
package/LICENSE ADDED
@@ -0,0 +1,21 @@
1
+ MIT License
2
+
3
+ Copyright (c) 2026 Tim IT — Claude AI Rules Kit
4
+
5
+ Permission is hereby granted, free of charge, to any person obtaining a copy
6
+ of this software and associated documentation files (the "Software"), to deal
7
+ in the Software without restriction, including without limitation the rights
8
+ to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
9
+ copies of the Software, and to permit persons to whom the Software is
10
+ furnished to do so, subject to the following conditions:
11
+
12
+ The above copyright notice and this permission notice shall be included in all
13
+ copies or substantial portions of the Software.
14
+
15
+ THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
16
+ IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
17
+ FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
18
+ AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
19
+ LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
20
+ OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
21
+ SOFTWARE.
@@ -0,0 +1,145 @@
1
+ # Halo Staff Baru! Mulai dari Sini
2
+
3
+ > **File ini buat KAMU baca, BUKAN buat AI.**
4
+ >
5
+ > Kalau kamu **bukan programmer** dan baru gabung tim — selamat datang. Habiskan ~10 menit baca file ini pelan-pelan. Setelah selesai, kamu sudah punya gambaran besar cara kerja tim.
6
+ >
7
+ > Jangan copy-paste isi file ini ke AI. Ini bukan instruksi buat AI, ini "buku panduan saku" buat kamu.
8
+
9
+ ---
10
+
11
+ ## Apa Itu lintasAI?
12
+
13
+ Bayangin tim ini kayak toko online di Tokopedia.
14
+
15
+ - **Proyeknya** = toko kamu (misal jualan baju).
16
+ - **Kode** = stok barang + sistem kasir + desain etalase.
17
+ - **lintasAI** = template Notion siap-pakai + plugin Tokopedia Seller. Sudah ada layout, sudah ada aturan kerja, sudah ada checklist. Kamu tinggal pakai, tidak perlu bikin dari nol.
18
+
19
+ Tanpa lintasAI, tiap orang kerja dengan cara sendiri-sendiri — pusing waktu mau gabungin hasil. Dengan lintasAI, semua orang di tim ngikut **1 cara kerja yang sama**, dibantu AI biar lebih cepat.
20
+
21
+ **Singkatnya**: lintasAI = standar kerja tim + asisten AI yang sudah tau aturan tim.
22
+
23
+ ---
24
+
25
+ ## 4 Hal yang Kamu Perlu Tau
26
+
27
+ ### 1. AI Claude Code = "Asisten Kerja" Kamu
28
+
29
+ Bayangin kamu punya asisten yang bisa kerja 24 jam, tidak pernah ngeluh, dan ngerti coding. Itu **Claude Code**.
30
+
31
+ - Kamu **chat dia kayak WhatsApp** — ketik permintaan dalam bahasa biasa.
32
+ - Dia eksekusi (buka file, ubah teks, upload ke server).
33
+ - **Kamu yang putuskan** sebelum dia kerja: setuju, revisi, atau batal.
34
+
35
+ Contoh chat:
36
+ > *"Tolong tambahin tombol Export di halaman daftar pelanggan, hasilnya file Excel."*
37
+
38
+ Claude akan kerjain — tapi **selalu nanya kamu dulu** sebelum hal-hal berbahaya (hapus file, kirim ke server publik).
39
+
40
+ > **Aturan emas**: AI itu pintar, tapi tidak tau konteks bisnis kamu. Kamu yang tau apa yang benar buat tim — AI cuma bantu eksekusi.
41
+
42
+ ### 2. Butuh 3 Tools Aja
43
+
44
+ | Tool | Fungsi | Analogi |
45
+ |---|---|---|
46
+ | **VS Code** | Tempat buka file proyek | Microsoft Word, tapi khusus file kode |
47
+ | **Claude Code extension** | AI asisten di dalam VS Code | Kayak WhatsApp Web yang nempel di VS Code |
48
+ | **Discord** | Tempat tim ngobrol + ambil tugas | Grup WhatsApp tim, tapi lebih rapi |
49
+
50
+ Owner sudah install semua di laptop kamu pas onboarding. Kalau ada yang error, lapor di Discord channel `#help`.
51
+
52
+ ### 3. Cara Mulai Kerja Tiap Hari (6 Step)
53
+
54
+ 1. **Buka VS Code** (icon biru kotak di desktop).
55
+ 2. **Buka folder proyek** — File → Open Folder → pilih folder yang owner kasih.
56
+ 3. **Buka Claude Code** — klik icon Claude di sidebar kiri (atau tekan `Ctrl+L`).
57
+ 4. **Cek Discord channel `#tugas-hari-ini`** — lihat ada task baru yang di-pin?
58
+ 5. **Copy task dari Discord, paste ke Claude Code chat** — kasih konteks "tolong kerjakan ini, ikut aturan tim di AGENTS.md".
59
+ 6. **Review hasil Claude** — baca pelan-pelan, kalau OK klik Accept. Kalau ada yang aneh, balas chat: *"Bagian X belum sesuai, tolong revisi."*
60
+
61
+ Selesai 1 task = lapor ke Discord `#progress` dengan emoji status. Sudah, gitu aja.
62
+
63
+ ### 4. Cara Prompt yang Benar
64
+
65
+ **Prompt** = permintaan kamu ke AI. Kualitas hasil AI = kualitas prompt kamu.
66
+
67
+ #### Contoh BAGUS:
68
+ > *"Tolong buatin halaman daftar pelanggan dengan kolom: Nama, Email, No HP, Tanggal Daftar. Datanya ambil dari database tabel `customers`. Pakai komponen Table yang sudah ada di proyek. Ikut style halaman daftar produk yang sudah ada."*
69
+
70
+ Kenapa bagus: **jelas detail, kasih konteks, sebut yang sudah ada**.
71
+
72
+ #### JANGAN seperti ini:
73
+ > *"Bikin halaman pelanggan."*
74
+
75
+ Kenapa jelek: AI bingung — kolom apa? Data dari mana? Style gimana? Hasilnya pasti tidak sesuai.
76
+
77
+ #### Tips Prompt Awam:
78
+ - **Tulis kayak nulis WA ke kolega baru** — anggap dia pintar tapi belum tau proyek kamu.
79
+ - **1 chat = 1 task**. Jangan campur 5 permintaan sekaligus.
80
+ - **Kasih contoh**: *"Mirip halaman X yang sudah ada"*.
81
+ - **Sebutin "ikut aturan tim di AGENTS.md"** di awal sesi baru — biar AI re-load aturan.
82
+
83
+ ---
84
+
85
+ ## Tabel "Saat Bingung"
86
+
87
+ | Situasi | Action |
88
+ |---|---|
89
+ | AI minta konfirmasi hapus/delete file | **STOP**. Screenshot. Tanya owner di Discord dulu sebelum klik Yes. |
90
+ | Hasil AI aneh / tidak sesuai permintaan | Balas chat: *"Bagian X tidak sesuai, tolong revisi jadi Y"*. Jangan accept dulu. |
91
+ | Stuck >30 menit di 1 task | Lapor Discord `#help` — kasih screenshot + ceritain udah coba apa. |
92
+ | Tidak ngerti istilah teknis di chat AI | Buka `templates/GLOSSARY_NON_PROGRAMMER.md`. Atau tanya Claude: *"Jelasin istilah X dengan bahasa awam"*. |
93
+
94
+ ---
95
+
96
+ ## Glossary Singkat (8 Istilah Wajib)
97
+
98
+ | Istilah | Bahasa Awam |
99
+ |---|---|
100
+ | **Repo** | Folder proyek di GitHub (kayak Google Drive folder shared khusus kode). |
101
+ | **Commit** | Save point + catatan "apa yang berubah" (kayak Ctrl+S di Word + tulis 1 kalimat). |
102
+ | **Push** | Upload save-an kamu ke server tim (kayak upload Word ke Google Drive). |
103
+ | **Pull** | Download versi terbaru dari server tim (kayak download Word terbaru dari Google Drive). |
104
+ | **PR (Pull Request)** | Lapor ke atasan: *"Pak, draft saya selesai, mohon review"*. Owner approve atau minta revisi. |
105
+ | **Branch** | Copy file Word yang kamu rename jadi "draft - versi Bagus" sebelum edit. Master file aman. |
106
+ | **Staging** | Showroom prototype. Tim sudah bisa lihat hasil kamu, tapi publik belum bisa. |
107
+ | **Production** | Versi LIVE yang user beneran pakai. URL utama proyek (kayak akun Tokopedia kamu yang sudah aktif). |
108
+
109
+ > Mau lebih lengkap? Buka `templates/GLOSSARY_NON_PROGRAMMER.md` — ada 50+ istilah dengan analogi.
110
+
111
+ ---
112
+
113
+ ## FAQ
114
+
115
+ ### Q1. Saya bukan programmer, beneran bisa kerja di tim ini?
116
+ **A**: Bisa. Tim ini didesain untuk **non-programmer + AI**. Kamu tidak perlu hafal coding — yang penting kamu **paham konteks bisnis**, **bisa nulis prompt jelas**, dan **mau baca hasil AI pelan-pelan**. AI yang ngetik kode, kamu yang putuskan benar/salah.
117
+
118
+ ### Q2. Kalau saya salah prompt, bahaya tidak?
119
+ **A**: 90% aman. AI selalu nanya konfirmasi sebelum hal berbahaya (hapus file, kirim ke production, ubah database). Yang berbahaya: kamu klik "Yes" tanpa baca. **Aturan**: kalau muncul popup konfirmasi dan kamu ragu — STOP, tanya owner Discord dulu.
120
+
121
+ ### Q3. Saya stuck, tanya siapa?
122
+ **A**: Urutan:
123
+ 1. **Tanya Claude dulu**: *"Saya bingung di X, tolong jelasin dengan bahasa awam."*
124
+ 2. **Cek glossary** `templates/GLOSSARY_NON_PROGRAMMER.md`.
125
+ 3. **Discord `#help`** — sebutin task + screenshot + udah coba apa.
126
+ 4. **Owner DM** — kalau urgent dan blocker (ada deadline).
127
+
128
+ ### Q4. Berapa lama sampai saya produktif?
129
+ **A**: Realistis:
130
+ - **Hari 1-3**: orientasi — baca glossary, lihat tim kerja, kerjain task kecil (typo, copy edit).
131
+ - **Minggu 1**: bisa kerjain task low-risk sendiri (tombol UI, ubah teks halaman).
132
+ - **Minggu 2-4**: bisa kerjain task medium (fitur baru kecil, ambil data dari database).
133
+ - **Bulan 2+**: jadi co-pilot owner — bisa handle task sendiri, owner cuma review.
134
+
135
+ Tidak perlu buru-buru. Lebih baik kerja **pelan tapi hati-hati** daripada cepat tapi rusakin production.
136
+
137
+ ---
138
+
139
+ ## Selamat Bergabung
140
+
141
+ Tim ini tidak menuntut kamu jadi programmer. Tim ini butuh kamu jadi **partner mikir** yang paham konteks bisnis + bisa kerja sama AI dengan rapi.
142
+
143
+ Kalau bingung — tanya. Kalau ragu — STOP dulu. Kalau capek — istirahat, kerja besok. Tidak ada yang segera urgent sampai harus rusakin production.
144
+
145
+ Next step: baca `templates/ONBOARDING.md` (jadwal 14 hari pertama). Sampai ketemu di Discord.
@@ -0,0 +1,3 @@
1
+ # DEPRECATED (lintasAI v1.0.0 republish 2026-06-04)
2
+
3
+ -> Pakai [PROJECT_LIFECYCLE_PROMPT_v1.md](PROJECT_LIFECYCLE_PROMPT_v1.md), jump ke "Stage A: Kickoff"