Words
Fragments uses one word per thing, everywhere: CLI, editor, Cloud, GitHub, these docs.
The words
Word | Meaning | Where it lives | Retired synonyms |
|---|---|---|---|
| Fragment | One canonical primitive of a design system: a component the team has decided is the way to do a thing (Button, Card.Header). | libs/ui/src/components/<Name>/, fragments.manifest.json primitives[] | canonical component, root, primitive (outside code) |
| Manifest | The curated, committed contract of a repository's design system: Fragments, tokens, patterns, grammar, rules, exemplars. One file. | fragments.manifest.json | policy, contract file, vocabulary, catalog |
| Contract / FCID | The pinned identity of a manifest version: contractHash(manifest). Every verdict cites one. | packages/core/src/contract/hash.ts | contract stamp, contract version (as identity) |
| Card | The ≤60-line summary of the manifest an agent receives at session start. | fragments hook-exec --event SessionStart | agent context, vocabulary card, reminder |
| Loop | The write-path cycle: card → write → check → repair → prove. Local, zero network. | packages/loop | agent surface, hook pipeline |
| Check | An evaluation of one file or one diff against the manifest. | fragments check, check-file, hooks | scan, governance run, lint |
| Finding | One drift from the manifest, always phrased as replace <raw> with <Fragment> from <library>, with a code FUI####. | packages/core/src/rules/ | issue, violation, occurrence, diagnostic |
| Repair | The deterministic fix for a finding. | fragments fix, conform | autofix, codemod, suggestion |
| Pattern | A named composition of Fragments with an intent and an exemplar (StatStrip, DecisionDialog). | manifest patterns[] | block, recipe, composition |
| Grammar | A house rule of the design system, checkable when a rule id exists. | manifest grammar[] | design rule, guideline, DESIGN.md prose |
| Exemplar | A gold usage of a Fragment or pattern in this repository, path:line. | manifest exemplar | example, reference, usage site |
| Binding | A repository connected to Fragments Cloud through the GitHub App. | convex/bindings | project (user-facing), repo record, installation repo |
| Verdict | pass, block or indeterminate for an exact head against an exact FCID. Produced only by evaluate(). | @usefragments/core/evaluation | conclusion, status, result, clean/dirty |
| Receipt | The persisted evaluation behind a verdict, id evr_…. What a check's details link opens. | governanceReceipt.ts, /r/:evr_ | trust receipt, evaluation record, proof |
| Gate | The required GitHub check fragments/contract-compliance on a protected branch. | contract-check.ts | check run (as a product noun), status check |
| Exception | An admin-granted, expiring, reasoned waiver of a finding. Always logged. | exceptions ledger | waiver, suppression, ignore |
| Bypass | A merge that landed without a passing verdict or an exception. Recorded, never hidden. | merge ledger outcome: bypassed | override, force-merge |
| Merge ledger | One row per (binding, head) merge with its receipt and outcome. | convex/mergeLedger.ts | merge history, rollup, snapshot |
| Discover | The command that proposes a manifest from the code. A human curates; nothing is inferred at check time. | fragments discover | scan, classify, auto-detect |
The product's sentence: The agent ignored your Button. Replace <button> with Button from @acme/ui.