Skip to content

JasonColapietro/suede-creator-skills / skills/suede-parity-contract

suede-parity-contract

Verified

Suede Parity Contract Skills. cross-surface parity contracts generated from live reference constants and asserted through follower behavior. Use when asked "these app and web thresholds disagree" or when rules are copied across web, mobile, docs, or services. NOT FOR: choosing the correct shipped value, diff review (suede-code), merge-gate setup (suede-ci-gate), or search audits (suede-seo-audit).

FileKindSize
CARD.mdmarkdown4.3 KB
SKILL.mdskill md7.8 KB
agents/openai.yamlconfig1.1 KB
references/worked-contract.mdmarkdown2.3 KB

references/worked-contract.md

View on GitHub
# Suede Parity Contract Skills: Worked Contract

This is a synthetic application scenario, not a client result or a required output filename. Adapt the values to the supplied evidence. The skill's existing output format and authority boundaries apply.

## Input

Web and mobile both expose a free-plan seat limit. The product owner names web as the reference. Web exports the live constant; mobile has a copied value and its public upgrade behavior can be tested.

## Expected output

Generate a deterministic contract from the web export, commit the reference staleness test, vendor identical bytes into mobile, and test the public boundary at limit minus one, limit, and limit plus one. Return hashes, test output, reference choice, and any exact known-divergence set.

## Missing input and recovery

If the two shipped values already differ and the owner has not chosen which is right, preserve both and present the divergence options from Step 6. If a follower repository is unavailable, report that follower incomplete; passing reference tests alone do not establish cross-surface parity.

## Validation

Change the reference constant and show its staleness test failing with the key name; restore and pass. Separately corrupt the follower copy, show its assertion failing, restore, and hash-compare the copies. A missing/empty contract must fail loading before value assertions.

## Detailed scope and routing

Suede cross-surface canon discipline: hold one canonical answer across every surface that states it (web, iOS, Android, docs, a second service) by generating a contract from the reference surface and making the others assert against it, so a divergence fails a test instead of reaching a user or an answer engine. Consistent canon is what makes a product citable: generative search quotes sources that do not contradict themselves, and a number that differs between your site and your app is a contradiction a model can see. Use when the same rule, threshold, ladder, or stated fact lives on two or more surfaces; when values are copied by hand out of a handoff; when two surfaces already disagree; or when auditing where they drifted. NOT FOR: deciding which surface is correct (a product call this skill records rather than makes); reviewing a diff (use suede-code); wiring merge gates (use suede-ci-gate); a generative-search audit of a page (use suede-seo-audit).
rea-analysis-optimizationmorluto/reaOptimize REA providers and shared analysis workflows for agent context, latency, CPU, and memory while preserving correctness and Evidence. Use for analysis bottlenecks and cache or query design; CI/test-suite optimization belongs to rea-ci-tests-audit.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-ci-tests-auditmorluto/reaAudit REA CI and test suites for correctness, fixture drift, false passes, and measured performance; use for suite or workflow investigations and efficiency changes, rather than ordinary feature testing or a single test failure.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
rea-tool-designmorluto/reaAudit, investigate, design, or change REA investigation tools, CLI/MCP contracts, provider capabilities, and Evidence semantics.Stars: 472kUpdated Claude CodeCodexVerifiedInstall
ponytail-auditDietrichGebert/ponytailQuality audit of the whole repo: bugs, security, real load, missing tests, speed, and what to delete. Most important first.Stars: 194kUpdated Claude CodeCodexVerifiedInstall