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

@@ -6,6 +6,7 @@ Agent Skills specification (https://agentskills.io/specification).
from __future__ import annotations
import hashlib
import re
from collections.abc import Iterable
from dataclasses import dataclass
@@ -123,6 +124,15 @@ def read_skill(skill_dir: Path) -> SkillMeta:
return SkillMeta(name=name, description=description, path=skill_dir)
def skill_version(skill_dir: Path) -> str:
"""A short content hash of every file in the Skill, to say which Skill was loaded."""
digest = hashlib.sha256()
for path in sorted(p for p in skill_dir.rglob("*") if p.is_file()):
digest.update(path.relative_to(skill_dir).as_posix().encode())
digest.update(path.read_bytes())
return digest.hexdigest()[:12]
def discover_skills(directories: Iterable[Path]) -> dict[str, SkillMeta]:
"""Index every Skill that is an immediate child of one of `directories`.