@ojokesusu/lintasai 1.1.2

package/SPLIT_REPO_MIGRATION_PROMPT_v1.md

@@ -0,0 +1,485 @@
+# Split Repo Migration Prompt - lintasAI v1.0.0
+
+> **Paste ke Claude Code di project monolithic kamu** untuk migrate jadi 3 repo split (frontend + backend + shared).
+> Goal: TRUE READ isolation untuk business logic, foundation untuk scale 3-30+ staff.
+> Effort: 4-6 minggu owner (otomatis dengan AI).
+>
+> **Note:** akses-tools sebagai repo terpisah cuma kalau team grow >20 staff atau compliance audit. Default: scripts di backend/scripts/.
+
+---
+
+## Yang akan saya (AI) lakukan setelah kamu paste prompt ini
+
+1. **Analyze project structure** kamu sekarang:
+   - Detect: Next.js (full-stack monolith)? Other stack?
+   - Inventory: berapa lib file, API route, component, prisma model
+   - Identify: which file = UI (frontend), which = business logic (backend), which = types (shared); ops scripts default ke backend/scripts/
+   - Estimate: total LOC per kategori, complexity score, dependency graph
+
+2. **Propose detailed migration plan**:
+   - 3 repo target name + content map per repo
+   - Migration timeline (minggu 1-6)
+   - Risk + rollback strategy
+   - Tools yang perlu di-setup (Swagger, Storybook, dst)
+   - Cost impact (Vercel, GitHub Package, dst)
+
+3. **Wait konfirmasi owner** sebelum eksekusi (3-option Y/N/customize)
+   - YES: lanjut full execution
+   - NO: stop, save plan ke docs/migration-plan-draft.md
+   - CUSTOMIZE: owner adjust mapping atau timeline dulu
+
+4. **Execute migration step-by-step**:
+   - Create 3 GitHub repo (panduan manual + verify)
+   - Extract code ke repo masing-masing
+   - Setup @akses/shared package
+   - Setup Swagger di backend
+   - Setup AGENTS.md per repo (template dari lintasAI)
+   - Setup deployment pipeline (Vercel x2 + GitHub Package npm)
+   - Verify dengan smoke test
+   - Update CODEOWNERS + tier mapping
+
+5. **Generate transition doc untuk staff**:
+   - Cheatsheet prompt non-programmer
+   - Owner playbook ongoing
+   - Cross-team coordination guide
+
+---
+
+## Pre-requisite (Yang Owner Siapkan Sebelum Paste)
+
+- [ ] Project mature (sudah ada code real, bukan boilerplate fresh Next.js)
+- [ ] Sudah pakai lintasAI v1.0.0+ (cek .claude-kit/CHANGELOG.md)
+- [ ] Sudah hire 3+ staff (atau planning untuk hire)
+- [ ] Mau invest 4-6 minggu time
+- [ ] Backup repo current (git tag pre-split-backup)
+- [ ] Punya akses owner ke GitHub org (untuk bikin 3 repo private)
+- [ ] Punya akses Vercel (atau platform deploy lain) dengan slot project minimal 2
+- [ ] CI/CD current di-pause atau di-freeze selama migration
+
+---
+
+## Yang Saya Butuhkan Sebelum Mulai
+
+Sebelum jalankan migration, saya akan tanya:
+
+1. Nama project kamu apa? (untuk naming convention: <project>-frontend, dst)
+2. GitHub username owner: ojokesusu atau lain?
+3. Berapa staff total saat ini? Berapa Backend Staff (yang punya akses backend)?
+4. Stack saat ini: Next.js? Atau lain?
+5. Frontend baru pakai apa? (Next.js SPA mode / React Vite / lain)
+6. Backend baru pakai apa? (Next.js API mode / Hono / Express / lain)
+7. Database: Supabase, atau lain?
+8. Tools yang mau di-setup: pilih dari list (Swagger, Storybook, Playwright, webhooks, Sentry, dst)
+
+Tambahan opsional yang membantu (boleh skip kalau belum tahu):
+- Apakah ada secrets/env yang TIDAK boleh leak ke frontend repo? (list keyword)
+- Apakah ada module legacy yang TIDAK akan di-migrate (deprecated)?
+- Target deploy date (untuk reverse-plan timeline)?
+
+---
+
+## Workflow Migration (Yang Saya Eksekusi)
+
+### Week 1 — Setup Repo + Tools
+
+**Day 1: Backup + Plan**
+- `git tag pre-split-backup-<date>` di repo current
+- Push tag ke origin
+- Bikin doc PLAN.md di repo current (timeline + responsible)
+- Snapshot DB Supabase (kalau pakai) sebagai safety net
+
+**Day 2-3: Create 3 GitHub repo**
+- Owner: bikin `<project>-frontend` (Private, invite Frontend Staff)
+- Owner: bikin `<project>-backend` (Private, invite Backend Staff ONLY)
+- Owner: bikin `<project>-shared` (Private, semua staff read)
+- Setup branch protection: main = require PR + review
+- Setup CODEOWNERS per repo (backend/scripts/ → owner-only via CODEOWNERS rule)
+
+**Day 4-5: Setup tools per repo**
+- `<project>-backend`: install Hono/Express ATAU setup Next.js API mode
+- `<project>-backend`: install `next-swagger-doc` untuk auto-Swagger UI
+- `<project>-shared`: setup TypeScript + tsup build
+- `<project>-frontend`: clean up old API routes (move ke backend)
+- Install `.claude-kit` lintasAI di tiap repo
+- Bikin `AGENTS.md` per repo (template berbeda untuk frontend vs backend)
+
+### Week 2-3 — Extract Code
+
+**Identify per file:**
+
+| Source path (monolith) | Target repo |
+|---|---|
+| `src/lib/auth`, `billing`, `security`, `encryption`, `*-crypto` | `<project>-backend` |
+| `src/lib/format`, `useDebounce`, `hooks` (UI) | STAY at frontend |
+| `prisma/` | `<project>-backend` |
+| `src/app/api/` | `<project>-backend` (refactor as Hono route atau Next.js API) |
+| `src/app/(public)/`, `dashboard/` UI | `<project>-frontend` |
+| `src/components/` | `<project>-frontend` |
+| TypeScript types shared | `<project>-shared` |
+| Scripts ops (`scripts/*.ts` audit, migration, cron) | `<project>-backend/scripts/` (owner-only via CODEOWNERS) |
+| `.github/workflows/*` | Split per repo |
+
+**Refactor imports:**
+
+```ts
+// SEBELUM (monolith)
+import { OrderType } from '@/lib/types'
+import { db } from '@/lib/db'
+
+// SESUDAH frontend
+import { OrderType } from '@<project>/shared'
+const data = await fetch(`${process.env.NEXT_PUBLIC_API_URL}/api/orders`)
+
+// SESUDAH backend
+import { OrderType } from '@<project>/shared'
+import { db } from './db'
+```
+
+**API Route Pattern (Decision Point):**
+
+```
+DEFAULT (RECOMMENDED): Option B - Frontend Shell Wrapper
+
+Frontend keep app/api/ sebagai shell 3-baris yang forward ke backend:
+  // frontend/src/app/api/orders/route.ts
+  import { handleOrdersList, handleOrdersCreate } from '@<project>/backend-client'
+  export const GET = handleOrdersList
+  export const POST = handleOrdersCreate
+
+Pros:
+- Keep Next.js Server Action benefit (velocity 2x faster)
+- Privacy preserved: logic di @<project>/backend-client (compiled JS), bukan TS source
+- TypeScript types auto-inferred
+- Standard pattern SaaS (Linear, Notion)
+
+Cons:
+- Slight duplication (route defined di 2 tempat)
+
+---
+
+ALTERNATIVE: Option A - Pure SPA
+
+Frontend tidak punya app/api/ at all. Semua API call ke backend external URL via fetch.
+
+Pros:
+- TRUE total separation
+- No duplicate route definition
+
+Cons:
+- Lose Next.js Server Action benefit
+- Need CORS setup
+- Slower develop cycle
+
+---
+
+DEFAULT pilih: B (RECOMMENDED). Pilih A cuma kalau spesifik mau full SPA architecture.
+```
+
+**Update package.json:**
+- Frontend: tambah `@<project>/shared` as dep
+- Backend: tambah `@<project>/shared` as dep
+- Backend: tambah `next-swagger-doc` atau equivalent
+- Backend scripts (di `backend/scripts/`): minimal deps (tsx, zod, supabase client) — share package.json backend
+
+### Week 4 — Deploy Pipeline
+
+- Vercel project baru untuk frontend (`<project>-frontend`)
+- Vercel project baru untuk backend (`<project>-backend`) — atau Railway/Render kalau Hono
+- GitHub Package untuk `@<project>/shared` (atau private npm)
+- Environment vars:
+  - Frontend: `NEXT_PUBLIC_API_URL`, `NEXT_PUBLIC_*` only
+  - Backend: `DATABASE_URL`, `SUPABASE_SERVICE_ROLE_KEY`, secrets, dst
+  - Shared: TIDAK ada env
+- Setup CI/CD per repo (GitHub Actions: lint, typecheck, test, deploy)
+- Setup preview deployment per PR
+
+### Week 5 — Onboard Staff
+
+- Brief staff dengan cheatsheet (deploy `SPLIT_REPO_NON_PROGRAMMER_PROMPTS.md`)
+- Migrate `.staff-profile.md` per laptop:
+  - Frontend Staff: clone `<project>-frontend` + `<project>-shared`
+  - Backend Staff: clone `<project>-backend` + `<project>-shared`
+- Test workflow: backend tim build API endpoint baru, frontend tim consume via Swagger doc
+- Setup Slack/chat channel cross-repo coordination
+- Train staff hit endpoint backend dengan `curl` atau Postman
+
+### Week 6 — Smoke Test + Cutover
+
+- E2E test full flow (login → action → DB write → read)
+- Switch DNS/Vercel ke split deployment
+- Monitor 1 minggu: error rate, latency, build success rate
+- Decommission monolithic repo (archive di GitHub, BUKAN delete)
+- Update dokumentasi external (README publik, status page, dst)
+
+---
+
+## Workflow Auto-Push 3 Repo dari Monolith
+
+### Pre-Migration (Owner Manual)
+
+Owner pre-buat 3 repo di GitHub (5 menit):
+
+1. github.com/new → Create:
+   - Name: <project>-frontend
+   - Visibility: Private
+   - DO NOT add README, .gitignore, atau license (truly empty)
+2. Repeat untuk <project>-backend dan <project>-shared
+
+Invite collaborator sesuai role:
+- frontend: 4 Frontend Staff + 2 Backend Staff + owner
+- backend: 2 Backend Staff + owner
+- shared: 4 staff (read) + owner (write)
+
+### Migration Execution (AI Auto-Push)
+
+User paste prompt ke Claude Code:
+
+```
+Migrate <project> ke split repo. Repo URL:
+- Frontend: https://github.com/<owner>/<project>-frontend
+- Backend: https://github.com/<owner>/<project>-backend
+- Shared: https://github.com/<owner>/<project>-shared
+```
+
+AI execute (otomatis, tanpa konfirmasi step-by-step):
+
+1. Analyze project current (auto-detect via STACK_DETECTION_PATTERN.md)
+
+2. Generate file mapping (berdasarkan role system):
+   - File Backend grade → backend
+   - File Frontend UI → frontend
+   - Types → shared
+
+3. Create 3 temp folder lokal:
+   - C:\temp\<project>-split\<project>-frontend\
+   - C:\temp\<project>-split\<project>-backend\
+   - C:\temp\<project>-split\<project>-shared\
+
+4. Per temp folder:
+   - Copy files berdasarkan mapping
+   - Generate package.json, tsconfig.json, AGENTS.md per repo (dari template split-agents/)
+   - Generate .gitignore standard
+   - git init
+   - git branch -M main
+   - git add .
+   - git commit -m "initial commit from <project> monolith split"
+   - git remote add origin <URL>
+   - git push -u origin main
+
+5. Output report:
+   ```
+   Migration complete. 3 repo pushed:
+   - https://github.com/<owner>/<project>-frontend (95 files)
+   - https://github.com/<owner>/<project>-backend (28 files)
+   - https://github.com/<owner>/<project>-shared (13 files)
+
+   Next steps:
+   1. Setup Vercel deploy untuk frontend + backend (panduan di SPLIT_REPO_TOOLS_SETUP.md)
+   2. Verify staff invite di masing-masing repo
+   3. Brief staff dengan SPLIT_REPO_NON_PROGRAMMER_PROMPTS.md
+   ```
+
+6. Ask: "Mau pertahankan temp folder C:\temp\<project>-split\ untuk backup? (Y/N)"
+   - Y: keep folder, archive original akses repo
+   - N: delete temp folder
+
+### Pre-Requisite Checks
+
+AI verify sebelum mulai:
+- [ ] 3 repo URLs accessible (HTTP 200 ke API GitHub)
+- [ ] Owner punya write permission di 3 repo
+- [ ] 3 repo TRULY empty (no commits)
+- [ ] Local Git installed
+- [ ] GitHub credentials setup (gh auth status)
+- [ ] Working tree clean (no uncommitted changes)
+
+Kalau ada gagal, AI lapor + minta owner fix dulu.
+
+### Rollback Plan
+
+Kalau migration error di tengah:
+1. Temp folders preserve (tidak auto-delete saat error)
+2. Original monolith repo TIDAK ke-modify
+3. 3 repo baru bisa di-reset:
+   - github.com/<owner>/<repo>/settings → Delete repository
+   - Atau: bikin ulang dari scratch
+4. Owner cuma kehilangan 4-6 jam effort, no data loss
+
+### Estimasi Effort
+
+| Step | Effort |
+|---|---|
+| Owner pre-buat 3 repo | 5 menit |
+| Owner paste prompt | 30 detik |
+| AI execute (file copy + push) | 30-60 menit |
+| Owner review + verify | 15 menit |
+| **Total** | **~1.5 jam** |
+
+---
+
+## Penting: Reversibility
+
+Kalau setelah migration berasa tidak suit:
+- 3 repo masih ada di GitHub (private, bisa di-restore)
+- Repo lama (monolith) di-archive, BUKAN dihapus (cuma archive)
+- Bisa re-merge balik ke monolith dalam 1-2 minggu kalau perlu
+- DB tetap sama (Supabase shared), tidak ada data loss risk
+- Vercel project lama bisa di-pause (tidak hapus), revert dengan rebuild
+
+**Rollback procedure (kalau Week 5-6 fail):**
+1. Pause Vercel project frontend + backend baru
+2. Re-deploy Vercel project monolith dari tag `pre-split-backup-<date>`
+3. Update DNS balik ke monolith
+4. Brief staff: "kembali ke workflow lama, debrief root cause minggu depan"
+5. 3 repo split tetap di GitHub (jangan hapus) untuk forensic + retry
+
+---
+
+## Cara Pakai Prompt Ini
+
+1. Pastikan kamu di project root (yang sudah pakai lintasAI v1.0.0+)
+2. Verify `git status` clean (commit semua WIP dulu)
+3. Copy SEMUA isi file ini dari header sampai akhir
+4. Paste ke chat Claude Code
+5. AI akan analyze project + tanya 8 pertanyaan kamu
+6. Jawab pertanyaan, AI generate plan + minta konfirmasi
+7. Confirm (YES/NO/CUSTOMIZE), AI execute step-by-step
+8. Owner review + verify per minggu (cek doc weekly-checkpoint.md yang saya generate)
+
+---
+
+## FAQ
+
+**Q: Skala project saya kecil (cuma 2 staff), perlu split?**
+A: Tidak. Pakai monorepo + CODEOWNERS sudah cukup. Split repo make sense untuk 3+ staff + mau privacy code business logic.
+
+**Q: Bisakah skip beberapa step?**
+A: Migration tools (Swagger, Storybook) bisa skip awal, tambah belakangan. Tapi 3 repo setup wajib (frontend + backend + shared). Tools/scripts ops default ke `backend/scripts/` — naik ke repo terpisah cuma kalau team >20 staff atau compliance audit.
+
+**Q: Apa kalau gagal di tengah?**
+A: Tag `pre-split-backup` masih ada. Rollback dengan `git reset` + delete 3 repo baru (atau archive). Tidak ada damage permanent ke production karena DB shared.
+
+**Q: Vercel cost naik?**
+A: Free tier support multiple project. Pro $20/bln cukup untuk 2-3 project. Cost increment kecil (< $20/bln tambahan).
+
+**Q: Staff tim langsung paham?**
+A: Tidak. Butuh brief 1 hari pakai `SPLIT_REPO_NON_PROGRAMMER_PROMPTS.md` cheatsheet. Setelah 1 minggu adoption, mereka familiar.
+
+**Q: Bagaimana kalau Frontend Staff iseng curi-curi clone backend repo?**
+A: GitHub repo private = Frontend Staff TIDAK ada akses (403 saat clone). Ini real READ isolation, bukan sekedar `.gitignore`.
+
+**Q: API contract berubah, frontend break?**
+A: Itu manfaat Swagger. Backend update OpenAPI spec → frontend regenerate types dari spec → TypeScript compile error muncul di frontend = early signal. Tidak perlu wait runtime error.
+
+**Q: Shared package update, harus rebuild semua repo?**
+A: Iya, tapi auto. Setup GitHub Action: shared push → trigger frontend + backend rebuild + redeploy. Atau pakai workflow_dispatch manual kalau mau lebih hati-hati.
+
+**Q: Database migration jadi gimana?**
+A: Pindah ke `<project>-backend` (yang punya akses Prisma). Frontend tidak punya Prisma sama sekali. Migration dijalankan dari backend CI/CD.
+
+**Q: Apa kalau owner solo (tidak ada Backend Staff)?**
+A: Owner pegang semua 3 repo. Split tetap berguna untuk: (1) discipline arsitektur, (2) onboarding staff masa depan, (3) ready-state untuk hire Backend Staff.
+
+**Q: Berapa lama break-even effort 4-6 minggu ini?**
+A: Tipikal: 3 bulan setelah migration, owner save 5-10 jam/minggu karena (1) staff onboarding faster, (2) review PR scope smaller, (3) build time per repo lebih cepat. Total ROI ~6 bulan.
+
+**Q: Kalau project saya non-Next.js (misal SvelteKit, Nuxt, Remix)?**
+A: AI saya akan adapt plan ke stack kamu. Konsep 3 repo + shared package + Swagger contract sama, cuma implementasi berbeda. Tanya saat pre-flight pertanyaan ke-4.
+
+**Q: Bagaimana dengan auth (NextAuth, Clerk, Auth0)?**
+A: Auth provider biasanya stay di backend (token issued by backend, frontend hanya consume session). NextAuth → migrate ke backend, frontend pakai `next-auth/react` client-side only. Clerk/Auth0 → both side perlu key (publishable di frontend, secret di backend).
+
+---
+
+## Risk Catalog (Yang Saya Mitigasi)
+
+| Risk | Likelihood | Impact | Mitigation |
+|---|---|---|---|
+| Build break karena import path salah | High | Medium | TypeScript strict + CI typecheck per PR |
+| Staff bingung workflow baru | High | Medium | Cheatsheet + brief 1 hari + Slack channel |
+| Swagger doc out-of-sync dengan implementasi | Medium | High | Auto-generate dari decorator/annotation, CI validate |
+| Shared package version drift | Medium | Medium | Lockfile + auto-bump via Renovate/Dependabot |
+| Vercel build longer karena 2 project | Low | Low | Build paralel, total time tetap sama |
+| Secrets leak ke frontend repo accidentally | Low | Critical | Pre-commit hook scan `.env*` + GitHub secret scanning |
+| Owner kelelahan 4-6 minggu | Medium | High | Weekly checkpoint, skip-able tools, rollback option |
+
+---
+
+## Output Artifacts (Yang Saya Generate)
+
+Setelah migration selesai, kamu akan punya:
+
+1. **3 GitHub repo** dengan AGENTS.md per repo
+2. **PLAN.md** di tiap repo (timeline + decisions)
+3. **CODEOWNERS** per repo
+4. **`.claude-kit/`** terinstall di tiap repo (lintasAI v1.0.0+)
+5. **Swagger UI** di `<project>-backend/api/docs`
+6. **Storybook** di `<project>-frontend/storybook` (opsional)
+7. **`SPLIT_REPO_NON_PROGRAMMER_PROMPTS.md`** untuk brief staff
+8. **`OWNER_PLAYBOOK.md`** untuk ongoing maintenance
+9. **`CROSS_TEAM_COORDINATION.md`** untuk komunikasi frontend-backend
+10. **Weekly checkpoint doc** (`docs/migration-week-N.md`) untuk audit trail
+
+---
+
+## Checkpoint Verifikasi (Per Minggu)
+
+**End of Week 1:** 3 repo created, tools installed, AGENTS.md committed. Verify: `gh repo view <project>-frontend`, dst.
+
+**End of Week 2-3:** Code extracted, imports refactored, build pass per repo. Verify: `pnpm build` di tiap repo.
+
+**End of Week 4:** Deploy preview live di Vercel, Swagger UI accessible, smoke test endpoint OK. Verify: hit `<backend-url>/api/health`.
+
+**End of Week 5:** Staff onboarded, first PR dari staff di split repo merge. Verify: cek GitHub activity per staff.
+
+**End of Week 6:** Production switch, monitoring 7 hari clean. Verify: error rate < baseline, latency stabil.
+
+---
+
+## Penting: Komunikasi Staff
+
+Setelah Day 1 (`pre-split-backup` tag), AI saya akan generate **announcement template** untuk kamu kirim ke staff:
+
+```
+Hi tim,
+
+Mulai minggu depan, kita migrasi project ke arsitektur 3 repo:
+- <project>-frontend (UI)
+- <project>-backend (API + DB + ops scripts)
+- <project>-shared (types)
+
+Selama 6 minggu transisi:
+- Repo lama TETAP active untuk hotfix
+- Repo baru di-setup paralel
+- Brief detail tanggal X
+
+Tidak ada perubahan akses kalian sekarang. Akses baru setelah Week 5 brief.
+
+Tanya kalau ada concern.
+
+-- Owner
+```
+
+Awareness-first, bukan mendadak. Sesuai feedback policy proyek.
+
+---
+
+[MULAI EKSEKUSI: PASTE PROMPT INI KE CLAUDE CODE]
+
+---
+
+Setelah saya analyze project kamu, saya akan present plan dengan format:
+- Inventory project current (berapa file, where business logic, where UI)
+- Mapping target (file mana ke repo mana)
+- Tools recommended berdasarkan stack
+- Timeline + effort estimate
+- Risks + mitigations
+
+Tanya saja kalau ada konteks tambahan owner mau saya tahu (misal: ada module legacy, ada constraint compliance, ada deadline rilis fitur, dst).
+
+---
+
+**Versi prompt:** v1 (sync dengan lintasAI v1.0.0)
+**Audience:** Owner project, NOT staff
+**Estimated AI execution time:** 4-6 minggu (paralel dengan owner kerja normal)
+**Reversibility:** Full rollback support sampai Week 5

package/TEAM_ROLLOUT_GUIDE_v1.md

@@ -0,0 +1,172 @@
+# TEAM_ROLLOUT_GUIDE_v1.md — Cara Bikin Kit Ini Jadi Standar Tim
+> v1 · 2026-05-30 · untuk pemimpin tim IT (3-10 orang)
+
+## Tujuan & Filosofi
+Kit aturan AI ini jadi **sumber kebenaran tunggal** untuk gaya kerja AI-assisted di tim. Tujuan: konsisten lintas-anggota & lintas-proyek, perbaikan bertahap (bukan paksa rewrite), fokus pada workflow yang AI bisa enforce sendiri (DoD, docs, naming, commit). Standar ini **bukan alat control**, tapi **alat hemat energi** — biar tim gak debat ulang aturan yang sama tiap proyek.
+
+## Prasyarat tim
+- Semua anggota punya **Claude Code** ter-install dan login Anthropic.
+- Semua anggota pakai **Windows** (kit ini Windows-only).
+- Satu **bahasa kerja** disepakati: **Bahasa Indonesia** (default kit ini).
+- Ada **channel komunikasi** aktif (Slack/Discord/WhatsApp group `#it-standard` atau sejenisnya).
+- Ada **1 owner standar** (mis. kamu) yang approve perubahan aturan.
+
+---
+
+## Step 1: Setup sumber kebenaran tunggal
+**Rekomendasi:** Git repo private di GitHub/GitLab dengan tag versi. Contoh nama: `<orgmu>/claude-team-standard`.
+
+Struktur folder repo:
+```
+claude-team-standard/
+├── README.md                              ← onboarding teman/staff
+├── CLAUDE_universal_v1.md                 ← aturan utama
+├── PROJECT_LIFECYCLE_PROMPT_v1.md         ← unified: Stage A Kickoff / B Bootstrap / C Update / D Migration
+├── TEAM_ROLLOUT_GUIDE_v1.md               ← file ini, baca owner standar
+├── install-windows.ps1
+├── templates/
+│   ├── architecture.md
+│   └── glossary.md
+├── exceptions.md                          ← lihat "Exception management" di bawah
+└── CHANGELOG.md                           ← log perubahan per versi
+```
+
+Tag rilis: `v1`, `v1.1`, `v2`. Anggota tim clone/download per tag.
+
+**JANGAN simpan di Google Drive folder bebas** — versi gampang nyasar, anggota gak tahu mana yang terbaru.
+
+## Step 2: Rilis v1 ke tim
+Checklist owner standar:
+1. **Upload kit ke repo internal** + tag `v1.1` (atau versi saat ini).
+2. **Jadwalkan "install party" 30 menit** (live di Meet/Zoom): semua anggota install bareng, biar bisa tanya langsung kalau stuck.
+3. **Tiap anggota verifikasi** dengan brief Claude: *"Halo, aku staff baru. Tolong cek install kit + briefing aturan dasar."* AI auto-apply Guided Step-by-Step Workflow (CLAUDE_universal_v1.md section 4.3). Screenshot hasil verifikasi, share ke channel.
+4. **Owner cek-list** di channel: semua anggota ✅ → rollout sukses.
+5. **Update `CHANGELOG.md`** di repo: tanggal rilis, ringkasan apa yang baru.
+
+## Step 3: Adopsi per-proyek
+Tiap proyek pilih 1 dari 3 jalur:
+
+| Kondisi proyek | Pakai prompt |
+|---|---|
+| Proyek **BARU** dari nol | `PROJECT_LIFECYCLE_PROMPT_v1.md` (Stage A: Kickoff) — AI bikin struktur sesuai standar dari awal |
+| Proyek **LAMA** tanpa `docs/` sama sekali | `PROJECT_LIFECYCLE_PROMPT_v1.md` (Stage B: Bootstrap Docs) — AI auto-fill docs/ dari codebase |
+| Proyek **SETENGAH JADI** (ada code + mungkin docs + konvensi sendiri) | `PROJECT_LIFECYCLE_PROMPT_v1.md` (Stage D: Migration) — AI audit gap, bikin plan bertahap |
+
+Filosofi adopsi di proyek setengah jadi: **bentrok OK, perbaikan bertahap**. Lihat detail di `PROJECT_LIFECYCLE_PROMPT_v1.md` (Stage D: Migration).
+
+## Step 4: Governance ringan
+5 keputusan owner standar:
+
+1. **Owner = kamu** (atau orang yang ditunjuk). Owner satu-satunya yang merge ke `main` di repo standar.
+2. **Versioning:**
+   - **Patch** (mis. `v1.1`): perubahan kecil non-breaking (typo fix, klarifikasi, tambah aturan opsional).
+   - **Minor** (mis. `v1.2`): tambah file/prompt baru, tambah seksi.
+   - **Major** (mis. `v2`): breaking — aturan lama ganti, struktur folder ubah. Wajib announce 1 minggu sebelum rilis.
+3. **Channel diskusi:** `#it-standard` (atau sejenisnya). Semua usulan + announce update lewat sini.
+4. **Format usulan perubahan aturan** (template di bawah). Anggota tim buka issue di repo, owner review + approve.
+5. **Cadence review:** akhir bulan — owner review usulan & exception, rilis update kalau ada.
+
+### Template usulan perubahan aturan
+File baru di repo: `proposals/<tanggal>-<judul-singkat>.md`
+```markdown
+# Usulan: <judul>
+> Pengusul: <nama> · Tanggal: <YYYY-MM-DD>
+
+## Aturan yang diusulkan
+<1-2 kalimat aturan baru atau perubahan>
+
+## Alasan
+<kenapa perlu, masalah apa yang diselesaikan>
+
+## Dampak
+- Proyek yang terdampak: <semua/sebagian/spesifik>
+- Effort migrasi: <ringan/sedang/besar>
+- Breaking? <ya/tidak — kalau ya, tier P0/P1/P2>
+
+## Alternatif yang dipertimbangkan
+<alternatif yang ditolak + alasan>
+```
+
+## Step 5: Distribusi update
+Saat owner rilis `v1.2`:
+1. **Tag rilis** di repo dengan changelog detail.
+2. **Announce di channel** — 1 paragraf: apa yang baru, dampak ke proyek existing, kapan deadline anggota update.
+3. **Anggota update** — `git pull` atau download zip, jalanin `install-windows.ps1` lagi (backup otomatis).
+4. **Ceklis di channel** — anggota react ✅ di pesan announce kalau sudah update.
+5. **Owner follow-up** anggota yang belum update setelah deadline.
+
+## Step 6: Tracking progres tim (metric ringan, BUKAN dashboard)
+Update manual di Google Sheet `it-standard-progress`:
+
+| Proyek | Owner | docs/architecture | docs/glossary | Conv Commits % | Quick Wins selesai |
+|---|---|---|---|---|---|
+| project-alpha | dev-1 | ✅ | ✅ | 90% | 4/4 |
+| inventory-app | dev-2 | ✅ | ⚠️ | 60% | 2/4 |
+| landing-page | dev-3 | ❌ | ❌ | 30% | 0/4 |
+
+Target tim:
+- **3 bulan:** 100% proyek punya `docs/architecture.md`.
+- **2 bulan:** 80% PR ikut Conventional Commits.
+- **Per quarter:** review proyek yang masih banyak gap, alokasi sprint khusus migrasi.
+
+Review metric tiap akhir bulan (10 menit di standup).
+
+---
+
+## Exception management
+Beberapa proyek pasti punya alasan kuat opt-out dari aturan tertentu. **Catat di `exceptions.md`** supaya gak jadi "norma diam-diam".
+
+### Template exception
+File: `exceptions.md` di repo standar.
+```markdown
+# Exception Log — Standar Tim IT
+
+| Proyek | Aturan di-skip | Alasan | Sunset date | Pemberi izin | Reviewer |
+|---|---|---|---|---|---|
+| client-x-portal | Bahasa docs ID → EN | Klien minta EN | 2026-12-31 | owner | jane |
+| legacy-erp | Conv Commits | Repo sudah 5 tahun pakai format bebas, migrasi P2 | TBD | owner | bob |
+```
+
+Review tiap bulan: sunset date sudah lewat? Reviewer ganti? Alasan masih valid?
+
+---
+
+## Anti-pattern tim yang dihindari
+- **Owner standar pegang semua, jadi bottleneck.** Tunjuk 1 deputy yang bisa approve usulan kecil.
+- **Rilis update tanpa announce → ada yang tertinggal.** Selalu lewat channel + cek-list eksplisit.
+- **Exception jadi norma karena gak pernah di-review.** Kalender bulanan untuk review `exceptions.md`.
+- **Junior takut bertanya jadi pura-pura paham.** Owner: tanyain langsung di standup, biasakan budaya "gak paham itu wajar".
+- **Standar dipakai jadi alat blame senior ke junior.** Owner tegur: kit ini untuk hemat energi, bukan untuk nyalahin. Code review fokus pada code, bukan ke orangnya.
+- **"Senior gak ikut standar, jadi junior gak perlu juga."** Owner enforce di code review — pelanggaran standar di PR baru = revisi.
+
+---
+
+## FAQ tim
+
+**Q: Aku gak setuju aturan X, gimana?**
+A: Buka usulan di repo (template di Step 4). Owner review di akhir bulan. Sementara itu, tetap ikut aturan existing — debat di channel `#it-standard`, jangan diam-diam langgar.
+
+**Q: Klien minta pakai standar mereka, harus gimana?**
+A: Catat di `exceptions.md` dengan sunset date. Standar tim cuma berlaku untuk proyek internal/tim sendiri. Klien external = aturan klien menang.
+
+**Q: Senior di proyek X gak ikut standar, aku junior bingung mau ikut yang mana.**
+A: Lapor ke owner standar (kamu/atau channel). Owner yang tegur ke senior. Junior: tetap ikut standar, jangan ikut kebiasaan jelek.
+
+**Q: Standar update v1.2 tapi proyek aku sudah running 6 bulan dengan v1, pusing harus migrasi semua?**
+A: TIDAK perlu migrasi semua. Cuma item P0 (Quick Wins) yang wajib dalam 1 minggu. P1/P2 = bertahap. Detail di `PROJECT_LIFECYCLE_PROMPT_v1.md` (Stage D: Migration).
+
+**Q: Aku onboard freelance/kontrak cuma 2 minggu, perlu install kit?**
+A: Tergantung. Kalau cuma utak-atik 1-2 file, gak perlu — cukup brief verbal. Kalau full bagian tim 2+ minggu, install supaya output konsisten.
+
+**Q: Aturan global vs aturan proyek (`./AGENTS.md`) — yang mana baca duluan?**
+A: Dua-duanya. Aturan proyek **menimpa sebagian** aturan global untuk proyek itu. Mis. global bilang "format commit Conventional Commits", proyek bilang "kami pakai format bebas karena legacy" → di proyek itu, format bebas menang.
+
+**Q: Aturan tim ini akan diapain kalau aku resign / pindah role?**
+A: Owner harus tunjuk pengganti minimal 1 bulan sebelum keluar. Knowledge transfer: walk-through `TEAM_ROLLOUT_GUIDE_v1.md` + serah-terima approval di repo standar.
+
+---
+
+## Penutup
+Standar bukan untuk control, tapi untuk **hemat energi tim** & **cegah salah-paham**. Anggota tim yang patuh standar → AI mereka konsisten → output proyek konsisten → onboarding anggota baru lebih cepat. Itu untungnya.
+
+Kalau ada pertanyaan, ke channel `#it-standard`. Selamat ngeshipping bareng tim yang patuh standar!

package/UPDATE_DOCS_PROMPT_v1.md

@@ -0,0 +1,3 @@
+# DEPRECATED (lintasAI v1.0.0 republish 2026-06-04)
+
+-> Pakai [PROJECT_LIFECYCLE_PROMPT_v1.md](PROJECT_LIFECYCLE_PROMPT_v1.md), jump ke "Stage C: Update Docs"