proving-claims

Map claims to evidence rows with statuses and release posture.

33|Updated May 24, 2026
One-click install
npx skills add https://github.com/FlyFission/nuclear-grade-context-engineering --skill proving-claims
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: proving-claims
Source: https://github.com/FlyFission/nuclear-grade-context-engineering/tree/main/skills/proving-claims
Command: npx skills add https://github.com/FlyFission/nuclear-grade-context-engineering --skill proving-claims

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Maps claims to evidence, statuses, gaps, tests, evals, reviews, and traces to ensure every important claim can be traced and any unsupported claims are made explicit. The skill turns each claim into a traceable proof and keeps six things apart: a fact, an assumption, an unknown, a source claim, local proof, and decision authority. The approach supports disciplined decision-making by linking claims to artifacts and clarifying release implications.

Core Features & Use Cases

  • Converts each material claim into a traceable claim-to-evidence row that records its basis, control or design feature, and the evidence type.
  • Distinguishes between fact, assumption, unknown, source claim, local proof, and decision authority to keep evidence organized.
  • Enables release posture decisions by recording evidence statuses (pass, fail, gap, deferred, not applicable) and explicit residual risks.
  • Supports outputs that connect claims to basis, evidence, and artifacts in trace.md and verification.md, with clear links to tests, reviews, and logs.

Quick Start

Provide a packet and its list of claims, and run the mapping to produce claim-to-evidence rows with statuses and an explicit release posture.

Frequently Asked Questions about proving-claims

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I trace claims to evidence for audit readiness in a release packet?

Mapping claims to evidence requires inputs like basis.md, trace.md, and verification.md. The process converts each claim into a traceable row recording its basis, evidence type, and status, distinguishing between facts, assumptions, and unknowns to produce an explicit release posture.

Can I use passing CI tests as proof for release claims?

No, you cannot use passing CI as sole proof for release claims. The approach cautions against treating green CI as proof and requires mapping claims to specific evidence, distinguishing between local proof, source claims, and decision authority to ensure genuine audit readiness.

What is the best way to document unsupported claims before a software release?

To document unsupported claims before a release, map each claim to its evidence and assign statuses such as gap or deferred. This separates facts from assumptions and unknowns, ensuring unsupported claims are explicit and residual risks are recorded for disciplined decision-making.

Does claim-to-evidence traceability work for code changes and release packets?

Yes, claim-to-evidence traceability applies to code changes, release packets, or any claim requiring independent verification. It maps claims to artifacts in trace.md and verification.md, ensuring every important claim can be traced and unsupported claims are made explicit for audit readiness.

What artifacts do I need to generate a release posture from claim verification?

You need basis.md, trace.md, verification.md, and ship.md as inputs to generate a release posture from claim verification. These artifacts enable the mapping of claims to evidence types and statuses, resulting in a recommended ship posture with explicit residual risks.

When should I avoid using automated claim mapping for release decisions?

Avoid using automated claim mapping when it leads to fabricating evidence or treating green CI as proof. The approach requires distinguishing between facts, assumptions, and unknowns, and mandates independent verification to ensure unsupported claims are explicit and audit-ready.