Toolctrl-Boilerplate Improvement-Plan
Historical plan archive: this directory records the original long-running improvement program and past execution context. Do not treat the files here as live autonomous-agent instructions unless a current operator explicitly reactivates a specific task. Current repo entrypoints are
AGENTS.mdanddocs/agent-entrypoints.md. If improvement-plan work is explicitly reactivated, usedocs/improvement-plan/PROGRESS.mdanddocs/improvement-plan/OPERATOR-CHECKLIST.mdas reconciled plan context.
Ziel: Boilerplate von aktuell 8.0/10 auf 10/10 bringen. Dauer: ~12-15 Monate Vollzeit-Äquivalent (parallel-arbeitend kürzbar). Vorgehensweise: historischer, agentisch ausführbarer Plan; heute nur noch als Referenz oder explizit beauftragter Backlog-Kontext nutzen.
Was hier drinsteht
AGENT-INSTRUCTIONS.md— historische Ausführungsregeln; nur nach expliziter Reaktivierung eines Improvement-Plan-Tasks anwenden.00-execution-order.md— topologische Phasen-Reihenfolge mit Dependency-Graph.CURRENT-STATUS.md— map of canonical current status sources; read this before using old phase notes as evidence.PROGRESS.md— reconciled historical plan tracker; not a substitute for current deploy, worker, or architecture docs.01-tech-debt-foundation/…11-backlog/— eine Phase pro Verzeichnis, mit README + Detail-MDs pro Task.
Handoff-Dateien
Historische HANDOFF-2026-*.md Snapshots aus früheren Agentenläufen liegen in
archive/handoffs/. Sie bleiben als Audit-/Kontextmaterial
erhalten, enthalten aber teilweise zeitgebundene Arbeitsanweisungen wie Push-,
Deploy- oder Nonstop-Aufträge. Für aktuelle Entscheidungen zuerst
CURRENT-STATUS.md lesen und dann den dort benannten kanonischen Docs folgen;
PROGRESS.md und OPERATOR-CHECKLIST.md sind nur in der dort beschriebenen
Rolle zu verwenden.
Phasen-Übersicht (Reihenfolge ist Pflicht, sonst gibt's Dependency-Fehler)
| # | Phase | Dauer | Tasks | Ziel |
|---|---|---|---|---|
| 01 | Tech-Debt-Foundation | 2-4 Wochen | 9 | Quick-Wins, Supabase weg, Deps aktuell, Konsolidierungen |
| 02 | Observability | 1-2 Wochen | 7 | Sentry+OTel+Logging+Metrics live |
| 03 | Skalierungs-Infrastruktur | 4-5 Wochen | 10 | Redis-Shared-Store, DB-Hardening, Worker-Trennung, Backup |
| 04 | Search + RAG | 3.5 Wochen | 3 | Meilisearch + pgvector/Qdrant + Embedding-Pipeline |
| 05 | Business-Features | 5+ Wochen | 7 | Feature-Flags, AI-Cost, Forms, Realtime, Marketing-Funnel |
| 06 | Plugin-System | 10-13 Wochen | 3 | WASM-Sandbox + Hooks + Lifecycle + Docs |
| 07 | Chatbot | 4-6 Wochen | 3 | MVP → V1 (alle Capabilities) → V2 (RAG + Cost) |
| 08 | Mobile + CLI + Storybook + SDK | 10+ Wochen | 5 | DX-Sprung |
| 09 | Authentik + Admin-SSO | 1.5 Wochen | 2 | Eigene IdP, OIDC fürs Admin-Board |
| 10 | Compliance + Polish | 8-9 Wochen | 9 | DSGVO, Audit, Lighthouse, WCAG, Email, Coverage |
| 11 | Backlog | – | 7+ | Spätere Features, nicht jetzt |
Historical Quick-Start
# 1. Lies die historischen Instructions, wenn ein Operator diese Planarbeit explizit reaktiviert hat
cat docs/improvement-plan/AGENT-INSTRUCTIONS.md
# 2. Schau die Reihenfolge an
cat docs/improvement-plan/00-execution-order.md
# 3. Schau den aktuellen Stand
cat docs/improvement-plan/PROGRESS.md
# 4. Wähle das nächste Item das nicht "blocked" und nicht "completed" ist
# 5. Öffne dessen Detail-MD und arbeite ab
# 6. Update PROGRESS.md + Detail-MD-Progress-Log, wenn du wirklich in diesem Plan arbeitest
# 7. Für aktuelle Repo-Arbeit gelten AGENTS.md und docs/agent-entrypoints.md vor diesen historischen Notizen