Mengedit prompt - AI Mentor Platform

Panduan singkat untuk developer yang ingin mengubah tone, panjang narasi, atau struktur output AI.

Peta file

Mau ubah apa	File
System prompt enricher master	`apps/api/src/generation/enrichers/ai-enricher.ts` → `SYSTEM_PROMPT`
Fokus grup per bukti	`apps/api/src/generation/document-definitions/master-definitions.ts` → `enrichmentGroups`
Prompt section trainer	`apps/api/src/generation/trainer-section-generator.service.ts` → `buildPrompt()`
Prompt Classroom bukti-5	`apps/api/src/generation/composers/master/generate-classroom-assignment-content.ts`
Branding knowledge & panduan dokumen	`apps/api/src/ai/prompts/branding-knowledge.ts`
Chat interviewer	`apps/api/src/ai/prompts/interviewer.prompt.ts`
Chat extractor	`apps/api/src/ai/prompts/extractor.prompt.ts`
Field boleh/k tidak boleh AI	`exactFieldPaths` / `enrichableFieldPaths` di definisi dokumen
Skeleton sebelum AI	`apps/api/src/generation/composers/master/compose-bukti-*.ts`
Validasi output	`apps/api/src/generation/schemas/`

Enricher menyimpan provenance:

PROMPT_VERSION = 'master-enricher-v3'
BRANDING_PROMPT_VERSION = 'branding-enricher-v1'

Naikkan versi saat mengubah system prompt agar bisa audit job lama di DB/logs.

Parameter	Nilai umum	Lokasi
Model	`deepseek-v4-flash`	`AI_MODEL` di `.env`
Temperature enricher	~0.3–0.7	`ai-enricher.ts` `callAI()`
Temperature section trainer	`0.3`	`trainer-section-generator.service.ts`
Max tokens section	`4000`	idem
Response format	`{ type: 'json_object' }`	DeepSeek native

Ganti model ke deepseek-v4-pro untuk kualitas lebih tinggi (biaya lebih).

Tes lokal

./thub env merge
./thub dev

Generate satu dokumen yang terdampak (master bukti-1, trainer full set, atau branding LinkedIn).

Unit test terkait

cd apps/api && bun test src/generation/enrichers/
cd apps/api && bun test src/generation/composers/master/

Validasi payload

Pastikan output masih lolos Zod schema — enricher fallback jika parse gagal.

Deploy

./thub secrets push   # jika hanya prompt code, cukup deploy
./thub deploy

Buat composer + schema Zod
registerDocument() di master-definitions.ts / trainer-definitions.ts / branding-definitions.ts
Tambah route renderer di apps/renderer
Jika aiMode: assist — definisikan enrichableFieldPaths + enrichmentGroups
Update frontend catalog jika perlu (biasanya auto dari API)

Jangan minta AI ubah kode unit / nama trainer

Taruh di exactFieldPaths. AI hanya narasi.

Jangan satu prompt untuk dokumen 20 halaman

Pakai enrichmentGroups seperti bukti-1 dan bukti-6.

Jangan hardcode prompt di frontend

Semua prompt server-side di apps/api.