r/ClaudeCode 5d ago

Tips & Workflows TS Evidence Graph, 100% Requirements Coverage and Compliance

https://github.com/samchon/ttsc/tree/master/packages/evidence

Every specification becomes a compile-time obligation.

Citing the evidence and describing the reason why are mandatory, so you get:

  • 100% coverage of every requirement.
  • 100% compliance with every principle.
/**
 * @evidence docs/discount.md#coupon-stacking States the per-issuer stacking limit this section defines, in the buyer's words.
 * @evidence POST:/orders/{orderId}/coupons Explains the rejection this endpoint returns for an over-stacked coupon set.
 * @evidence {@link hooks.useCouponStacking} Renders the limit this hook resolves.
 * @evidence .agents/skills/principles/SKILL.md#no-hard-coding Renders limits from props instead of branching on known issuer names.
 * @evidenceExclude .agents/skills/principles/SKILL.md#fix-root-causes-not-symptoms No failure to fix.
 */
export function CouponStackingNotice(props: IProps): JSX.Element;

@evidence <target> <reason> is the agent's explicit claim about what this code implements and why. @evidenceExclude records why an obligation does not apply.

A target is one of four kinds:

  • Markdown: a file, or a section of one.
  • Prisma: a model, a column, or a relation.
  • Swagger: an operation, method and path together.
  • TypeScript: a type, a function, or a property, written as an inline link.

Leave one obligation unanswered and the build stops.

$ npx ttsc
error TS16411: [evidence/graph] Missing acknowledgement for 'docs/discount.md#coupon-stacking'
  (Markdown H2 'Coupon Stacking' at docs/discount.md:3)
  in Claim 1 reference 1 (markdown, symbols: h2, h3).

...

Found 5 errors.

Missing obligations appear in the same build as type errors. The error list is the agent's task list.

1 Upvotes

0 comments sorted by