66 lines
4.2 KiB
Markdown
66 lines
4.2 KiB
Markdown
# 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
|
||
```
|