Skip to content

docs: design SpecSafe evidence chain - #71

Merged
LaloLalo1999 merged 2 commits into
mainfrom
cx/evidence-chain-design
Sep 8, 2026
Merged

LaloLalo1999 merged 2 commits into
mainfrom
cx/evidence-chain-design

Conversation

@LaloLalo1999

@LaloLalo1999 LaloLalo1999 commented Aug 24, 2026 •

Copy link
Copy Markdown
Contributor

Summary

  • propose a repo-local assurance kernel for versioned design packages, parametrizable DoD gates, and a traceable JRN/US/FR/SPEC/REQ/SCN/TST/CODE/EVD/DEC evidence graph
  • specify complete actor, instruction, requested/resolved model, fallback, effort, context, decision, test, and evidence provenance
  • define RED → minimal implementation → GREEN → refactor, minimum-context judging, governed learning proposals, and integration seams for Telar, Ultimate Harness, and execution adapters

Validation

  • documentation-only diff checked for whitespace and Markdown fence balance
  • design reconciled against docs/SPECSAFE-CANONICAL-WORKFLOW.md and canonical readiness/spec/test/code/verify/QA workflows
  • no runtime, dependency, generated adapter, or release behavior changed

@mergify

mergify Bot commented Aug 24, 2026

Copy link
Copy Markdown
Contributor

Tick the box to add this pull request to the merge queue (same as @mergifyio queue).

  • Queue this pull request

Extend the SpecSafe evidence chain design with its place in the wider
delivery architecture, and link it from the README so readers arrive at
the assurance seam from the entry point rather than only from the docs
index.

Why: SpecSafe needs an explicit boundary statement now that Telar owns
business intent, policy, identity, human authority and the normalized
ledger, Ultimate Harness is the sole Run Control, and OMP Pantheon is the
OMP Execution Adapter. Without it, SpecSafe's scope (repo-local
assurance) is easy to misread as overlapping those systems.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_01JU5UgXYpSHcemNhVnigLT4
@LaloLalo1999

Copy link
Copy Markdown
Contributor Author

Appended commit d31b8fd to this PR branch.

Files added in that commit:

  • README.md
  • docs/SPECSAFE-EVIDENCE-CHAIN-DESIGN.md

No other files were staged.

@LaloLalo1999
LaloLalo1999 merged commit 9255ed8 into main Sep 8, 2026
6 of 7 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant