Skip to content

Core concepts

Versions and history ​

A rule starts at version 1 and gains a version each time its wording changes: when a one-line rule is rewritten, or when a document rule's document changes. Old versions are kept, never deleted.

What makes a new version ​

What happenedResult
You rewrote a one-line ruleNew version, in force from that moment. The row shows Version 2 and so on
You edited the document's wordingNew version. The rule shows v2, v3 and so on
You renamed or moved the fileNothing. Vythos notes it looked, and moves on
You re-saved the file without changing a wordNothing. Same text, same version
You uploaded the same file again, changedNew version
You added a different file that replaces this ruleThis rule is retired; the new document's rule starts its own history
You retired the rule and later added the document againThe history carries on — a retired v3 is followed by v4, not a second v1

For a document, the test is the words, not the timestamp. Vythos checks each rule's document about every ten minutes, and an untouched file costs nothing. A file that was touched but still says the same thing changes nothing either.

What's kept ​

Every past version keeps its own text, its values, and the moment it stopped governing. That matters for more than tidiness:

  • A draft is checked against the version its author was given. When an AI tool asks for context, Vythos records exactly which rules and which versions it handed over. If the rule changes while the work is in progress, the check still judges the draft against what the writer actually had. A checker that cried wolf about a rule nobody had seen would be ignored within a week.
  • You can reconstruct the past. What did our terms say in March? The Playbook can answer that, because nothing was overwritten.

Going back to an earlier version ​

On a rule with more than one version, press Version on its row, then Restore next to the wording you want. The old wording comes back as the next version, so version 3 can say what version 1 said, and nothing in between is erased. Restoring needs the same access as writing the rule.

If someone changed the rule since you opened the page, Vythos refuses and asks you to look again, so you can't undo their change by accident.

A rule from a document can't be restored here. Change the document, and the rule follows.

Taking your Playbook with you ​

Export on the Playbook page downloads the rules you can read as one markdown file, grouped by Everyone and by client. It's plain text, so it works without Vythos. Client facts and memory aren't in this file.

Dates on a rule ​

A one-line rule shows Since the day it was added, and Until its end date if it has one. A document rule's row shows the document's own date where it has one — "effective 1 July 2025", taken from the document's text — and otherwise the date the rule was added. The document's date is the more useful of the two: it's the date your team would quote, not the day someone got round to adding it.

Replacing one document with another ​

Editing a document updates its rule. A new document is a new rule, and Vythos will not silently transfer governance from one file to another.

So when you save this year's rate card as a new file:

  1. Add the new file with Add from a document.
  2. Where the card asks, tick replaces against the old rate card.

The old rule is retired with its history, the new one takes over, and nothing in between is ambiguous. If you don't tick it, both stay in force — and Vythos tells your tools they disagree rather than picking one. See Update a rule.

Same title, different file

If you add a document whose rule would have the same name and category as one already in force, Vythos stops and asks whether this replaces it. A same-named takeover is the one case where silently following the newest file would be indistinguishable from a mistake.

Retiring ​

Retiring stands a rule down. It stops reaching your team and their AI tools immediately; its text and history remain. See Retire a rule.

Next: Memory.

Vythos — the context layer for agencies that run on their own rules.