System Doku Landkarte
Diese Seite gibt den menschlichen Ueberblick: welche Generatoren laufen, welche Artefakte entstehen, wie manual und public getrennt sind, und wie Seed und Node zusammenhaengen.
Seed/Node Boundary Manual/Public Boundary Generator WiringGenerator Ketten
| Kette | Start | Output | Sichtbar in |
|---|---|---|---|
| Seed Full Stack -> Seed HITL | iio/specs/scripts/run-full-stack-audit.sh dann generate-seed-hitl-representations.sh |
iio/specs/transformation/evidence/*, iio/manual/SEED-HITL-OPERATOR-MANUAL.*, iio/public/revisions/seed-hitl-operator-brief.*, iio/public/data/seed-hitl-operator-status.js |
IIO Manual, IIO Public |
| Node Deep Round -> Node HITL | intelego/specs/scripts/generate-hitl-operator-package.sh |
intelego/specs/agent/evidence/*, intelego/manual/hitl-operator-manual.html, intelego/public/revisions/hitl-operator-brief.*, intelego/public/data/hitl-operator-status.js |
Intelego Manual, Intelego Public |
| Runtime Data Generators | iio/specs/scripts/generate-*-runtime-*.sh |
iio/public/data/*.js und Evidenz/Intake-Artefakte |
Script Console, IIO Public |
Priorisierte Critical Round
Manual/Public sind als top-kritische Prozesse priorisiert. Dafuer gibt es eine feste, fail-closed Runde mit harter Reihenfolge:
1. Full stack audit (Evidenzbasis) - 2. Seed Manual/Public - 3. Node Manual/Public - 4. Validator + Traceability Checks
Command: bash iio/specs/scripts/run-docs-critical-round.sh /home/zolo/space /home/zolo/space/iio /home/zolo/space/intelego
Evidence: iio/specs/transformation/evidence/docs-critical-round-<ts>.md
Fix vs Scheinfix
| Klasse | Bedeutung | Freigabe |
|---|---|---|
| REAL_FIX | Validatoren erfolgreich und Status-Referenzen zeigen auf vorhandene Evidenzdateien. | Kann als belastbare Doku-Aktualisierung gelten. |
| SCHEINFIX | Oberflaeche wurde geaendert, aber Validator oder Traceability ist unvollstaendig. | Nicht release-faehig, Nacharbeit erforderlich. |
Boundary Matrix
| Ebene | Manual | Public |
|---|---|---|
| IIO Seed | Universelle Regeln, Layer, Referenzprozesse | Seed-Status und evidenzbasierte, reduzierte Darstellung |
| Intelego Node | Konkrete Tenant-Ausfuehrung, lokale Ops-Runden, Migration | Node-Status fuer Stakeholder, revisionsorientiert |
Doku-Abdeckung (Coverage)
Verwende diese Tiefenstufen fuer jedes Kernmodul:
L0 Datei vorhanden | L1 Zweck beschrieben | L2 Input/Output + Owner | L3 Beispiele + Fehlerbild + Next Action
Policy:
1. Kritische Generator-Ketten muessen L3 haben.
2. Jeder Public-Status muss auf Generator + Evidenz rueckverfolgbar sein.
3. Seed/Node-Boundary muss pro Seite sichtbar sein.
4. Letzte Critical Round darf nur mit REAL_FIX als abgeschlossen gelten.