Skip to content

Traceability model

The minimal causal chain is:

Task
  -> Requirement / AcceptanceCriterion
  -> SpecificationVersion
  -> PlanVersion
  -> ImplementationAttempt
  -> AgentInvocation / ToolInvocation
  -> ChangeSet
  -> Evidence
  -> ValidationResult / Finding
  -> GateEvaluation
  -> HumanDecision
  -> Closure
  -> RetrospectiveObservation / Recommendation

Every edge records relation type, source actor, timestamp and provenance. References point to immutable IDs and digests rather than mutable filenames alone.

Mandatory relations

  • every changed path is owned by one implementation attempt;
  • every validation result names the ChangeSet digest it evaluated;
  • every finding references evidence and the evaluator identity;
  • every gate evaluation references policy, workflow and configuration digests;
  • every human decision references the exact gate evaluation and ChangeSet digest;
  • every recommendation references observations from closed runs.