Możliwość

Nadzoruj każdą decyzję architektoniczną na etapie projektowania, z dołączonymi dowodami.

Każdy model ma warstwę nadzoru: ADR, zapisy decyzji biznesowych, motywację, strumienie wartości, evidence_refs. Ścieżka audytu jest podstawą, a nie dodatkiem.

Na czym polega

Nadzór na etapie projektowania oznacza, że decyzje są typowanymi encjami zamiast plików Markdown, które tracą zgodność ze stanem systemu. Warstwa nadzoru Archally przechowuje zapisy decyzji architektonicznych D### i zapisy decyzji biznesowych obok bounded contextów, na które wpływają, strumieni wartości, którym służą, i dowodów (EVD###), które je wspierają. Analiza wpływu zmian śledzi, czego dotyczy proponowana zmiana modelu w złożonych kontekstach i dziedzinach, zanim trafi do wydania, zamykając lukę, której nie wypełniają tradycyjne narzędzia dokumentacji.

Podstawy

  • Encja ADR D### z polami status / kontekst / decyzja / konsekwencja
  • Zapis decyzji biznesowej w zakresie bounded contextów
  • Odnośniki evidence_refs we wszystkich warstwach
  • Zapis migracji dla każdej dziedziny z wpływem na semver i uzasadnieniem
  • modelDiff i MCP impact-report do śledzenia wpływu między dziedzinami

Jak to działa

Zapisz ADR lub zapis decyzji biznesowej jako encję YAML w .blueprint/v{N}/governance/. Powiąż ją z bounded contextami, których dotyczy (bounded_context_ref), dowodami evidence_refs, na których się opiera, i strumieniem wartości, któremu służy. Uruchom query GraphQL modelDiff lub narzędzie MCP impact-report dla dowolnej zmiany. System zwraca zbiór elementów objętych wpływem między dziedzinami: konteksty, decyzje i migracje, wraz z historią zmian uwzględniającą uzasadnienia.

Choć ADR nie są obowiązkowe przy codziennych decyzjach zespołu, będą wymagane dla wszystkiego, co trafia do Technical Design Council.
- UK Government Technology Blog, „The Architecture Decision Record (ADR) Framework” (grudzień 2025)