# 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.md` and
> `docs/agent-entrypoints.md`. If improvement-plan work is explicitly
> reactivated, use `docs/improvement-plan/PROGRESS.md` and
> `docs/improvement-plan/OPERATOR-CHECKLIST.md` as 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/`](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

```bash
# 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
```