Skip to content

Commit e38b860

Browse files
authored
docs: refine source and Home Runtime intake contract (#178)
* docs: refine source and home runtime intakes * docs: render project statistics
1 parent 77bff70 commit e38b860

56 files changed

Lines changed: 3613 additions & 372 deletions

File tree

Some content is hidden

Large Commits have some content hidden by default. Use the searchbox below for content that may be hidden.

Lastenheft_Abarbeitungsreihenfolge.md

Lines changed: 34 additions & 4 deletions
Original file line numberDiff line numberDiff line change
@@ -110,10 +110,10 @@ run.*
110110

111111
| Reihenfolge / Order | Lastenheft | Zweck / Purpose |
112112
|---:|---|---|
113-
| D4 | `Lastenheft_Dokumentations-Informationsarchitektur-und-Lernpfad-Audit.md` | Prüft nach der abgeschlossenen Position 4 die gesamte Git-getrackte Level-0-Dokumentation read-only auf Informationsarchitektur, Leserpfade, Sprachstrategie und gestufte Tiefe. Die aktualisierte Baseline bindet die gemergten Plattform-, Remote-/Worktree- und Wartungs-TUI-Nachweise aus Features 015 bis 018. D4 ist der einzige deklarierte `Eligible`-Kandidat. / Audits all Git-tracked Level 0 documentation after completed item 4 for information architecture, reader paths, language strategy, and progressive depth without remediation. The refreshed baseline binds the merged platform, remote/worktree, and maintenance-TUI evidence from Features 015 through 018. D4 is the sole declared `Eligible` candidate. |
114-
| D5 | `Lastenheft_Level-0-Dokumentationsarchitektur-und-Sprachtrennung.md` | Setzt ausschließlich bestätigte D4-Findings um und verankert Einstiegspunkte, Sprachpartner und den dauerhaften Dokumentationsarchitektur-Vertrag. / Implements only accepted D4 findings and establishes entry pages, language pairs, and the durable documentation-architecture contract. |
115-
| D6 | `Lastenheft_Agentic-Workspace-und-Ein-Kommando-Wartung-Effizienzleitfaden.md` | Dokumentiert das nach Position 4 stabile Wartungsverhalten für Lernende, Nutzende, Maintainer/KI-Agenten und Audit, ohne Skriptverhalten zu ändern. / Documents the stable post-item-4 maintenance behavior for learners, operators, maintainers/AI agents, and audit without changing script behavior. |
116-
| D7 | `Lastenheft_Registrierte-Level-1-2-Dokumentationsarchitektur-Adoption.md` | Übernimmt nur belegte portable Regeln repository-spezifisch in die registrierte Level-1-/Level-2-Flotte; unveränderte Repositories erhalten keinen Leer-PR. / Adopts only proven portable rules per repository across the registered Level 1/2 fleet; unchanged repositories receive no empty pull request. |
113+
| D4 | `Lastenheft_Dokumentations-Informationsarchitektur-und-Lernpfad-Audit.md` | Prüft nach der abgeschlossenen Position 4 die gesamte Git-getrackte Level-0-Dokumentation read-only auf Informationsarchitektur, Leserpfade, Sprachstrategie, gestufte Tiefe und die Grenze zwischen versionierter Level-0-Quelle, manifestgesteuerter Home-Baseline Runtime und maschinenlokalem Zustand. Die aktualisierte Baseline bindet die gemergten Plattform-, Remote-/Worktree- und Wartungs-TUI-Nachweise aus Features 015 bis 018. D4 ist der einzige deklarierte `Eligible`-Kandidat. / Audits all Git-tracked Level 0 documentation after completed item 4 for information architecture, reader paths, language strategy, progressive depth, and the boundary between the versioned Level 0 source, manifest-managed Home Baseline Runtime, and machine-local state without remediation. The refreshed baseline binds the merged platform, remote/worktree, and maintenance-TUI evidence from Features 015 through 018. D4 is the sole declared `Eligible` candidate. |
114+
| D5 | `Lastenheft_Level-0-Dokumentationsarchitektur-und-Sprachtrennung.md` | Setzt ausschließlich bestätigte D4-Findings um und verankert Einstiegspunkte, Sprachpartner, Distributionsklassen sowie den dauerhaften Source-/Home-Runtime- und Dokumentationsarchitektur-Vertrag. / Implements only accepted D4 findings and establishes entry pages, language pairs, distribution classes, and the durable source/Home Runtime and documentation-architecture contract. |
115+
| D6 | `Lastenheft_Agentic-Workspace-und-Ein-Kommando-Wartung-Effizienzleitfaden.md` | Dokumentiert das nach Position 4 stabile Wartungsverhalten und erklärt Inhalt, Vorteile, Einweg-Sync, Änderungsort und Autoritätsgrenzen von Level-0-Quelle, Home Runtime und maschinenlokalem Zustand für Lernende, Nutzende, Maintainer/KI-Agenten und Audit, ohne Skriptverhalten zu ändern. / Documents the stable post-item-4 maintenance behavior and explains the contents, benefits, one-way sync, edit location, and authority boundaries of the Level 0 source, Home Runtime, and machine-local state for learners, operators, maintainers/AI agents, and audit without changing script behavior. |
116+
| D7 | `Lastenheft_Registrierte-Level-1-2-Dokumentationsarchitektur-Adoption.md` | Übernimmt nur belegte portable Regeln repository-spezifisch in die registrierte Level-1-/Level-2-Flotte, ohne Level-0-Pfade oder die Home-Runtime-Zielmenge pauschal zu kopieren; unveränderte Repositories erhalten keinen Leer-PR. / Adopts only proven portable rules per repository across the registered Level 1/2 fleet without copying Level 0 paths or the Home Runtime target set wholesale; unchanged repositories receive no empty pull request. |
117117
| 5 | `Lastenheft_Mitgeltende-Dokumente-Spec-Kit-Verzahnung.md` | Verzahnt Richtlinie, Checklisten, Sammelband, mitgeltende Dokumente und Governance-Presets, damit spaetere Spec-Kit-Laeufe dieselbe Bewertungslogik nutzen. / Aligns guideline, checklists, compendium, related documents, and governance presets so later Spec Kit runs use the same assessment logic. |
118118
| 6 | `Lastenheft_RL-SE-Checklist-Selbstpruefung.md` | Verankert eine generische Selbstpruefung gegen Richtlinie Sichere Entwicklung, CL_01 bis CL_12, Sammelband, mitgeltende Dokumente und Presets vor spaeteren Haertungen. / Anchors a generic self-assessment against secure-development guideline, CL_01 through CL_12, compendium, related documents, and presets before later hardening. |
119119
| 7 | `Lastenheft_Secure-Development-Container-Hardening.md` | Leitet Anforderungen fuer einen sicheren Entwicklungscontainer aus Richtlinie, Checklisten, mitgeltenden Dokumenten und Presets ab. / Derives requirements for a secure development container from the guideline, checklists, related documents, and presets. |
@@ -148,6 +148,20 @@ run.*
148148
| 36 | `Lastenheft_Learning-Series-Governance-IHK-Pilot.md` | Validiert das neue Preset an sieben bestehenden IT-Ausbildungsprofilen und zwei begrenzten synthetischen Nicht-IT-Profilen, ohne Lernmaterial automatisch zu verändern. / Validates the new preset against seven existing IT training profiles and two bounded synthetic non-IT profiles without automatically changing learning content. |
149149
| 37 | `Lastenheft_Lernreihen-Gesamtkonsistenz-Closure.md` | Prüft abschließend jede Reihe in sich, gegen ihre normativen Quellen und alle Reihen gemeinsam auf konsistente Lernziele, Evidence, KI-Kompetenz und Sicherheitsgrenzen. / Finally checks every series internally, against its normative sources, and across all series for consistent learning goals, evidence, AI competence, and safety boundaries. |
150150

151+
`Eligible` beschreibt hier ausschließlich den Graphzustand. Die
152+
Source-/Home-Runtime-Verfeinerung hat die früheren Einzelreviews D4 bis D7 und
153+
den früheren Series-Review hashbedingt archiviert. Vor einem D4-Start werden
154+
zuerst `$speckit-intake-series-status` und danach der im D4-Receipt benannte
155+
`$speckit-intake-review` ausgeführt. D5 bis D7 erhalten ihren neuen
156+
Einzelreview jeweils vor dem eigenen späteren Lauf.
157+
158+
*`Eligible` describes the graph state only. The source/Home Runtime refinement
159+
archived the former D4-D7 individual reviews and the former Series review
160+
because their hashes changed. Before D4 starts, run
161+
`$speckit-intake-series-status` and then the `$speckit-intake-review` named by
162+
the D4 receipt. D5 through D7 receive fresh individual reviews before their own
163+
later runs.*
164+
151165
## Verbindliche Abhaengigkeiten / Binding Dependencies
152166

153167
Die folgende Textmatrix ist der maschinenpruefbaren Series-Evidence
@@ -289,12 +303,28 @@ liefert zusätzlich eine bindende Oberfläche für Position 11. D7 übernimmt nu
289303
portable Regeln in die registrierte Flotte und gibt danach Position 5 frei.
290304
Keiner dieser Läufe startet seinen Nachfolger automatisch.
291305

306+
Die Kette behandelt die Workspace-Grenze ausdrücklich kausal: D4 inventarisiert
307+
und bewertet die bestehende Trennung von `~/home-baseline-source`,
308+
manifestgesteuerter Home-Baseline Runtime und `machineLocal`-Zustand; D5
309+
verankert nur akzeptierte Findings in Navigation und Dokumentationsvertrag; D6
310+
erklärt Inhalt, Vorteile, Änderungsort, Einweg-Sync und Authority für den
311+
täglichen Betrieb; D7 übernimmt nur portable Entscheidungsregeln und erweitert
312+
weder Level-0-Pfade noch die technische Propagationszielmenge stillschweigend.
313+
292314
*D4 through D7 form a new binding documentation-architecture track after item
293315
4. D4 audits without remediation, D5 implements accepted Level 0 findings, D6
294316
documents the stable operating surface and also feeds item 11, and D7 adopts
295317
portable rules across the registered fleet before releasing item 5. No run
296318
starts its successor automatically.*
297319

320+
*The chain treats the workspace boundary causally: D4 inventories and evaluates
321+
the existing separation between `~/home-baseline-source`, the manifest-managed
322+
Home Baseline Runtime, and `machineLocal` state; D5 anchors only accepted
323+
findings in navigation and the documentation contract; D6 explains contents,
324+
benefits, edit location, one-way sync, and authority for daily operation; and
325+
D7 adopts only portable decision rules without silently expanding Level 0
326+
paths or the technical propagation target set.*
327+
298328
*Item 4 was a hard dependency rather than an ordering recommendation and is
299329
now completed as Feature 018. The renewed schema-1.1 review removes its
300330
archived node and outgoing edge, then declares D4 the single preferred

0 commit comments

Comments
 (0)