feat: establish the Target architecture as a graph before code

Design is now approved before any infrastructure code is written (ADR-0005).
A new target-architect Specialist produces one graph of Elements,
Relationships and Checks; the diagram is rendered from it, deployment
guidance must account for every Check, and validation gives a verdict per
Check. Requirements, components, products and recommendations carry ids in
data files, and a submission with a gap in the Requirements chain is refused.

Also in this commit:
- Customer cases group Executions, with an intent history per case
- lesson candidates are captured when an Execution ends
- evaluation gains chain, verdict, judged and interactive checks, and
  per-case thresholds
- Terraform providers are cached between checks
- the requirements analyst proposes defaults instead of asking
- the legacy-baseline case and the checks that only read it are removed
- ADR-0006 (Change requests) accepted; ADR-0004 and ADR-0007 proposed
- plans for iterations 4 to 7 under .agents/plans/

Unproven with a real model: no evaluation run has completed on this design.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
2026-10-07 13:59:09 +01:00
parent 7ee49ab352
commit e9246828b3
586 changed files with 5166 additions and 22432 deletions

View File

@@ -1,62 +0,0 @@
#!/usr/bin/env python3
"""Offline checks for the architecture package; no cloud calls or provisioning."""
import re
import sys
from pathlib import Path
root = Path(__file__).parents[1]
def get_file_path(filename):
search_dirs = [
root / "deliverables" / "as-is",
root / "deliverables" / "target",
root / "deliverables" / "validation",
root / "deliverables" / "guides",
root / "deliverables",
root / "docs",
root,
]
for d in search_dirs:
candidate = d / filename
if candidate.is_file():
return candidate
return root / "deliverables" / "guides" / filename
required_files = [
get_file_path("requirements.md"),
get_file_path("architecture.md"),
get_file_path("architecture.mmd"),
get_file_path("solution-architecture-guide.md"),
root / "terraform" / "main.tf",
root / "terraform" / "variables.tf",
]
missing = [str(p.relative_to(root)) for p in required_files if not p.is_file()]
guide_path = get_file_path("solution-architecture-guide.md")
if guide_path.is_file():
text = guide_path.read_text(encoding="utf-8")
checks = [
"Functional requirements",
"Selected products",
"Validation results",
"Terraform",
"Mermaid",
]
missing += [f"guide section: {x}" for x in checks if x not in text]
else:
missing.append("solution-architecture-guide.md")
mmd_path = get_file_path("architecture.mmd")
if mmd_path.is_file() and not re.search(
r"flowchart|graph", mmd_path.read_text(encoding="utf-8")
):
missing.append("Mermaid graph")
if missing:
print("FAIL: " + ", ".join(missing))
sys.exit(1)
print("PASS: required architecture artifacts and guide sections are present")