AI_STARTS_HERE

AI STARTS HERE – engineering-tools#

1. Lies README.md.
2. Lies 00-overview/README.md.
3. Lies 00-overview/TOOL_SCOPE.md, 00-overview/TOOL_LANDSCAPE.md, 00-overview/TOOL_CONTRACT_MODEL.md und 00-overview/TRACEABILITY.md.
4. Folge der nummerierten Verzeichnisreihenfolge.
5. Prüfe vor jeder Änderung den Architecture Contract und den beauftragten Scope.
6. Erfinde keine Architektur aus vorhandener Implementierung.
7. Dokumentiere Widersprüche als ⌘FindingTechnical documentation artifact. oder ADR-Vorschlag.

Artifact Manifest Validation#

Für Code-/Dokumentations-Traceability:

• 40-validation/README.md
• ◆40-validation/validate-artifact-manifests.py

Runtime-Materialisierung#

Vor Installation oder Deployment lesen: 70-deployment/INSTALLATION.md.

Bootstrap Installer#

1. 10-bootstrap/README.md
2. ◆10-bootstrap/config/engineering-installation.example.json
3. 70-deployment/INSTALLATION.md

Bootstrap Execution Contract#

1. 10-bootstrap/BOOTSTRAP-EXECUTION-CONTRACT.md
2. 10-bootstrap/KNOWN-FINDING-DATABASE-VERIFICATION.md
3. 98-tests/bootstrap-contract-test-plan.md

EP-002.0B – Engineering Execution & ⌘EvidenceTechnical documentation artifact.#

• 70-deployment/EP-002-0B-ENGINEERING-ROUNDTRIP.md
• ◆70-deployment/deploy-engineering-platform.py

Workbench & Editors#

1. 17-workbench-editors/README.md
2. 17-workbench-editors/WORKBENCH_CONTRACT.md
3. 17-workbench-editors/EDITOR_CONTRACT.md
4. 17-workbench-editors/INTEGRATION_AND_SAFETY.md
5. 17-workbench-editors/VERIFICATION.md

CLI Services#

1. 90-cli/README.md
2. 90-cli/CLI_SERVICE_ARCHITECTURE.md
3. 90-cli/COMMAND_AND_OPTION_CONTRACT.md
4. 90-cli/EXIT_OUTPUT_ERROR_CONTRACT.md
5. 90-cli/AUTOMATION_AND_EVIDENCE_CONTRACT.md
6. 90-cli/VERIFICATION.md

Generatoren#

1. 55-generators/README.md
2. 55-generators/GENERATOR_ARCHITECTURE.md
3. 55-generators/GENERATOR_CONTRACT.md
4. 55-generators/TEMPLATE_AND_MATERIALIZATION_CONTRACT.md
5. 55-generators/VERIFICATION.md

Validatoren#

1. 40-validation/README.md
2. 40-validation/VALIDATOR_ARCHITECTURE.md
3. 40-validation/FINDING_AND_SEVERITY_CONTRACT.md
4. 40-validation/VALIDATION_EXECUTION_CONTRACT.md
5. 40-validation/TOOL_CONTRACT.md
6. 40-validation/VERIFICATION.md
7. 40-validation/CANONICAL_SOURCE_VALIDATION.md
8. 40-validation/LINK_VALIDATION.md
9. 40-validation/GLOSSARY_REFERENCE_VALIDATION.md
10. 40-validation/RELATIONSHIP_TYPE_VALIDATION.md
11. 40-validation/LEARNING_NUGGET_VALIDATION.md
12. 40-validation/PRIMARY_LANGUAGE_VALIDATION.md
13. 40-validation/KNOWLEDGE_COVERAGE_MEASUREMENT.md
14. 40-validation/SEMANTIC_DUPLICATE_CANDIDATES.md
15. 40-validation/CONTEXT_IMPACT_VALIDATION.md

Documentation Tooling#

1. 97-documentation/README.md
2. 97-documentation/DOCUMENTATION_TOOLING_ARCHITECTURE.md
3. 97-documentation/PUBLISHER_CONTRACT.md
4. 97-documentation/NAVIGATION_AND_LINK_CONTRACT.md
5. 97-documentation/REPORT_AND_EVIDENCE_CONTRACT.md
6. 97-documentation/VERIFICATION.md

Repository-Klassifikation#

Dieses Repository ist ein Engineering Repository. Der AI-Einstieg ist Bestandteil des verbindlichen Root-Vertrags.

Vor jeder Änderung sind zu prüfen:

1. Identität, Version und repositoryClass in ◆manifest.json,
2. der Verantwortungsrahmen in README.md,
3. der beauftragte Scope,
4. der repositoryeigene Validierungseinstieg 40-validation/README.md.

Repository Boundaries#

Für Ownership und Übergänge zusätzlich lesen:

1. 00-overview/TOOL_SCOPE.md
2. 00-overview/REPOSITORY_BOUNDARIES.md
3. enterprise-architecture:00-overview/cross-repository-responsibility-model.md

Build Contract Validation#

1. 40-validation/BUILD_CONTRACT_VALIDATION.md
2. ◆40-validation/validate-build-contract.py

Deployment Contract Validation#

1. 40-validation/DEPLOYMENT_CONTRACT_VALIDATION.md
2. ◆40-validation/validate-deployment-contract.py

Workspace Contract Validation#

1. 40-validation/WORKSPACE_CONTRACT_VALIDATION.md
2. ◆40-validation/validate-workspace-contract.py

KT-0016 Validation Contract#

Verbindliche Referenz: 40-validation/VALIDATION_CONTRACT_VALIDATION.md

KT-0017 Contract Coverage Review#

1. 40-validation/CONTRACT_COVERAGE_GAP_REVIEW.md
2. ◆40-validation/validate-contract-coverage.py

KT-0018 Automated Roadmap Progress Validation#

1. 40-validation/ROADMAP_PROGRESS_VALIDATION.md
2. ◆40-validation/validate-roadmap-progress.py

KT-0019 Work Item Admission and Change Control#

1. 40-validation/WORK_ITEM_ADMISSION_CHANGE_CONTROL.md
2. ◆40-validation/validate-work-item-admission.py

KT-0020 Repeatable Bundle ⌘IntakeTechnical documentation artifact. Validation#

1. 40-validation/BUNDLE_INTAKE_VALIDATION.md
2. ◆40-validation/validate-bundle-intake.py

KT-0021 Operational Runbook and Recovery#

1. 40-validation/OPERATIONAL_RUNBOOK_RECOVERY.md
2. ◆40-validation/validate-operational-recovery.py

KT-0022 Mandatory ⌘DiscoveryTechnical documentation artifact. Closure Review#

1. 40-validation/MANDATORY_DISCOVERY_CLOSURE_REVIEW.md
2. ◆40-validation/validate-mandatory-discovery-closure.py

KT-0023 Full Repository Landscape Validation#

KT-0023 Full Repository Landscape Validation#

1. 40-validation/FULL_REPOSITORY_LANDSCAPE_VALIDATION.md
2. ◆40-validation/validate-repository-landscape.py

KT-0024 GAP MVP Completion and Maintenance Handover#

1. 40-validation/GAP_MVP_COMPLETION_MAINTENANCE_HANDOVER.md
2. ◆40-validation/validate-gap-mvp-completion.py