One value, one source

Best practiceproofCC-BY-4.0practiced By Campaign Hub

A practice that stayed in force because a check can see it: a fact has one home, a second copy names that home, and a reader can point at the home.

When to use

Use this practice when a fact is about to be copied into a second file. The second file names the home. It does not become a rival definition.

When not to

Do not keep two editable definitions of the same fact. Do not 'fix' a drift by editing the copy and leaving the home stale. Edit the home, then point at it.

Author-attested

Original teaching specimen written for the Campaign Hub library. Not a transcript of a private run.

Community-submitted content. Prompts, skills, and agent instructions can contain hidden or malicious instructions (prompt injection). Review it before running it in any agent that has tool access, secrets, or the ability to spend money or send messages.
# One value, one source This file is a best practice: one home for a fact, with the check that a reader can point at that home. ## When to use Use this practice when you notice the same fact in two places: a definition, a threshold, a roster row, a sentence on a page. Choose the home. Make every other appearance point at that home. The practice earns its place because the check is something a stranger can do with a finger and the files. They can point at the home, or they cannot. ## When not to Do not use this practice to justify a single giant file that holds unrelated facts. One home per fact, not one home for the whole library. Do not point at a home that readers of the public shelf cannot open. A private note is not a public fact's home. If the fact is public, the home is public. ## The specimen The artifact is this practice, with its check named. ```text practice: one value, one source statement: A fact has one home. A second copy names that home. On disagreement, the home wins and the second copy is stale. check, named and runnable by a stranger: 1. Pick one fact. 2. Point at its home. One file, one field, or one specimen. 3. Find every other place the fact appears. 4. Each of those places names the home. 5. If a copy states a rival value and does not name the home, the check fails. 6. If two places both look like homes, the check fails until one of them points at the other. worked example on this shelf: fact: the four stratum sentences home: the kinds file second copy: the glossary specimen "The four strata" the glossary copy quotes the sentences and names the kinds file if they ever disagree, the kinds file wins fact: the shape of a specimen file home: the schema campaignhub.specimen/v1 second copy: the glossary entry "Specimen," which defines the word and names the schema the glossary does not become a second schema fact: the numeric line at which a safety answer blocks home: the sensor question pack the scorecard names that pack and does not keep a private copy of the number ``` The check is the reason this is a practice and not a preference. A reader either can point at the home or they cannot. "We were careful" is not the observation. ## How a stranger checks it Run the named check on the worked example. You need the kinds file and the glossary specimen "The four strata." 1. Read the four stratum sentences in the kinds file. That file is the home. 2. Read the four sentences in the glossary specimen. 3. Confirm the glossary names the kinds file as the home. 4. Compare the sentences. They match, or the glossary is stale and the kinds file wins. The practice fails in this very file if you find a second "home" for those sentences that does not point back at the kinds file. The practice fails in a product if a page reprints the sentences and, when they drift, someone edits the page instead of the kinds file.

How a stranger checks it

Related

source fact home copy

view raw view JSON