Ga naar inhoud

Sprint C — Claude Desktop Finetune

Doel

Elimineer handmatige sessie-initiatie door de juiste config-bestanden aan te maken. Na deze sprint start elke Claude Desktop / Claude Code sessie automatisch met volledige projectcontext, correcte rol, actieve sprint en drie assistentmodi.

Status

✅ Gereed — 14 maart 2026

Aanleiding

Huidige sessie-instructie in PROJECT.md:

"Begin elke Claude Desktop sessie met: 'Lees docs/ai/SPRINT.md en hervat als projectleider'"

Dit is handmatig, foutgevoelig en vergeetbaar. Sprint C vervangt dit door infrastructuur.

Taken

  • [x] C-1 CLAUDE.md aanmaken in repo-root
  • Projectcontext, rolverdeling, sprint status, architectuurprincipes, AI Constitution kern
  • 3 assistentmodi met trigger-woorden (kennisbeheer / dev / auto)
  • MCP server info en openstaande beslissingen
  • [x] C-2 .mcp.json aanmaken in repo-root
  • Verbindt buurts MCP server (sprint 10) automatisch met Claude Desktop/Code
  • Config stond al als commentaar in mcp_server/server.py
  • [x] C-3 .claude/settings.json aanmaken
  • Allowlist voor pytest, uvicorn, mcp server, basis git commando's
  • Geen auto-allow voor destructieve operaties (git push, reset)
  • [x] C-4 .gitignore uitgebreid
  • Toegevoegd: __pycache__/, *.pyc, *.pyo, buurts-env/, .pytest_cache/
  • Was: 59 bytes / 6 regels → Nu: 155 bytes / 16 regels

Definitie of Done

  • [x] Nieuwe Claude Code sessie in repo-root laadt automatisch projectcontext
  • [x] buurts_knowledge_search en buurts_knowledge_ask beschikbaar zonder setup
  • [x] pytest en uvicorn aanroepbaar zonder bevestigingspopup
  • [x] __pycache__ mappen worden niet meer getrackt

Resultaat

Voor Sprint C: 

Sessie start → "Lees docs/ai/SPRINT.md en hervat als projectleider" → wachten → context

Na Sprint C: 

Sessie start → direct projectleider met volledige context ✅

Buiten scope

  • sync_project_to_claude.py automatisering (over-engineering voor solo project)
  • CONFIG.md (redundant met bestaande config.py)
  • Globale CLAUDE.md op ~/.claude/ (aanbevolen als post-C actie)

Post-Sprint C aanbevelingen

  1. Globale ~/.claude/CLAUDE.md aanmaken met persoonlijke voorkeuren (Nederlands, naam Niels, communicatiestijl)
  2. Sprint B pas starten na formalisering van beslissing #1 en #2
  3. Buurts Cowork Skill overwegen voor kennisbank-rapport generatie

Vorige sprint (Sprint A)

Afgerond: UDS V2, SmartChunker, ZonedVectorStore (zones RED/YELLOW/GREEN), migratiescript, 39 nieuwe tests. Totaal 321/321 tests groen. PR #3 gemerged naar main.