Madhura68
4b7b1429c8
T-794: Nieuwe runbook docs/runbooks/job-model-selection.md met override-cascade, kind-default-matrix, override-voorbeelden, auditspoor en cost-attribution-formule. 107 regels. T-795: CLAUDE.md hardstop-bullet voor 'Model/mode per ClaudeJob' (verwijst naar nieuwe runbook) + patterns-quickref-rij voor job-config resolver. CLAUDE.md blijft 139 regels (≤ 150). T-796: docs:check-links groen — 108 files, geen broken links. Twee externe-repo verwijzingen (scrum4me-mcp/...) ge-de-linked tot plain text omdat de check-links script de zustertree niet traverseert; de referenties blijven leesbaar. Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
4.4 KiB
| title | status | audience | language | last_updated | when_to_read | ||
|---|---|---|---|---|---|---|---|
| Job-model-selectie per ClaudeJob-kind | active |
|
nl | 2026-05-08 | Vóór het wijzigen van model/thinking/permission-mode-keuze of bij debugging van 'verkeerd model gebruikt'-incidents. |
Job-model-selectie per ClaudeJob-kind
PBI-67. Per ClaudeJob.kind bepaalt de Scrum4Me-mcp resolver
scrum4me-mcp/src/lib/job-config.ts welk Claude-model + thinking-
budget + permission-mode + max_turns + allowed_tools de Claude Code-
worker moet gebruiken.
Dezelfde resolver staat — als één-op-één spiegel — in
lib/job-config.ts voor de enqueue-laag,
zodat we bij job-creatie het resolved resultaat al snapshotten in
ClaudeJob.requested_*.
Override-cascade
1. Task.requires_opus = true → forceer claude-opus-4-7
2. Job.requested_* → snapshot bij enqueue
3. Product.preferred_* → product-brede default
4. KIND_DEFAULTS → per kind onderstaand
Eerste match wint. max_turns en allowed_tools blijven in V1
altijd kind-default — geen product- of task-override.
Kind-default-matrix
| Kind | Model | Thinking-budget | Permission-mode | max_turns | allowed_tools |
|---|---|---|---|---|---|
IDEA_GRILL |
claude-sonnet-4-6 |
12 000 | plan |
15 | Read, Grep, Glob, WebSearch, AskUserQuestion |
IDEA_MAKE_PLAN |
claude-opus-4-7 |
24 000 | plan |
20 | Read, Grep, Glob, WebSearch, AskUserQuestion, Write |
PLAN_CHAT |
claude-sonnet-4-6 |
6 000 | plan |
5 | Read, Grep, AskUserQuestion |
TASK_IMPLEMENTATION |
claude-sonnet-4-6 |
6 000 | bypassPermissions |
50 | (alle) |
SPRINT_IMPLEMENTATION |
claude-sonnet-4-6 |
6 000 | bypassPermissions |
(geen) | (alle) |
bypassPermissions is verdedigbaar voor de implement-kinds omdat
elke run in een geïsoleerde git-worktree start (zie
branch-and-commit.md). Productie-product?
Zet Product.preferred_permission_mode = 'acceptEdits'.
Wanneer overrul je een default?
| Scenario | Wijzig op | Voorbeeld |
|---|---|---|
| Cross-file refactor of architectuurkeuze in TASK_IMPLEMENTATION | Task.requires_opus = true |
Een PBI met "rip out auth middleware" |
| Klant wil budget-control op een product | Product.preferred_model = claude-sonnet-4-6 |
Side-product met Haiku-only-budget |
| Productie-product zonder bypassPermissions | Product.preferred_permission_mode = 'acceptEdits' |
Klant-facing repo waar elke wijziging review nodig heeft |
| Ad-hoc: Opus voor één specifieke story-job | ClaudeJob.requested_model = claude-opus-4-7 (handmatige UPDATE) |
Nood-debug van prod-incident |
| Geen thinking voor een PLAN_CHAT (snelle reactie) | Product.thinking_budget_default = 0 (alle kinds in dat product) |
Demo-product |
Auditspoor
| Kolom | Wat | Wanneer ingevuld |
|---|---|---|
requested_model |
Resolved model op enqueue-tijd | actions/* enqueue-laag via lib/job-config-snapshot.ts |
requested_thinking_budget |
Resolved budget op enqueue-tijd | idem |
requested_permission_mode |
Resolved permission-mode | idem |
model_id |
Werkelijk gebruikt model | update_job_status na worker-run |
actual_thinking_tokens |
Werkelijk verbruikte thinking-tokens | idem |
Verschillen tussen requested_model en model_id zijn zichtbaar in
admin → Jobs → Kosten (rood-gemarkeerd modelveld + tooltip).
Meestal duidt dat op een worker die de CLI-flag niet doorgaf —
controleer de worker-script tegen de flag-tabel in
worker-idempotency.md.
Cost-attribution
Thinking-tokens worden bij Anthropic-billing gerekend tegen de
input-rate van het model. lib/insights/token-stats.ts en
lib/insights/token-history.ts doen hetzelfde:
COALESCE(cj.actual_thinking_tokens, 0) * mp.input_price_per_1m / 1000000.0
Voor per-kind aggregatie binnen een sprint: gebruik
getTokenStatsByKind(userId, sprintId).
Referenties
- Plan: docs/plans/job-model-selection.md
- Resolver (MCP):
scrum4me-mcp/src/lib/job-config.ts - Resolver (main):
lib/job-config.ts - Snapshot-helper:
lib/job-config-snapshot.ts - Worker-flag-mapping: worker-idempotency.md
- Schema:
prisma/schema.prisma→Product,Task,ClaudeJobvelden uit migration20260508085909_add_job_model_selection_fields