ADR-002-IMPLEMENTATION-ARTIFACT-MANIFESTS

ADR-002 – Implementierungsblöcke verwenden Artifact-Manifeste#

Status#

Accepted for MVP-001.

Kontext#

Dokumentation und ⌘CodeCode ist eine ausführbare oder interpretierbare technische Realisierung, die durch Tests und Runtime-Evidence überprüfbar bleibt. müssen auf einer stabilen Granularität verbunden werden. Kommentare pro ⌘FunktionEin Feature ist eine abgegrenzte, nutzbare und lieferbare Ausprägung einer Lösung. wären zu fein, redundant und schnell veraltet. Reine Pfadkonventionen reichen für eine belastbare Traceability nicht aus.

Entscheidung#

Größere Implementierungsblöcke besitzen ein maschinenlesbares artifact-manifest.json am Modulroot.

Das Manifest beschreibt fachliche ⌘HerkunftProvenienz beschreibt die nachvollziehbare Herkunft eines Wissenselements, einer Aussage oder einer abgeleiteten Darstellung., Verantwortlichkeit, öffentliche Verträge, Dokumentationsquellen, Tests und Runtime-Materialisierung.

Konsequenzen#

• Code kann bis zu ⌘CapabilityEine Capability beschreibt ein dauerhaft benötigtes fachliches Leistungsvermögen, nicht dessen technische Umsetzung. und ⌘VisionEine Vision beschreibt eine langfristig gewünschte Wirkung und gibt der Weiterentwicklung eine gemeinsame Richtung. zurückverfolgt werden.
• Engineering Tools können Konsistenz und fehlende Referenzen prüfen.
• Die Workbench kann Code-Strukturen später als Artefakte und Beziehungen darstellen.
• Funktions- und Dateiebene bleiben frei von übermäßigen Traceability-Kommentaren.
• Manifeste müssen bei semantischen Scope-Änderungen gepflegt werden.

Beziehungen#

• ◆Artifact-ManifestmodellTechnical documentation artifact. — constrains