Theme
Using Vythos
Update a rule
A rule is changed in its home: a one-line rule in Vythos, a document rule in its document. See Rules: a line or a document.
A one-line rule: rewrite it
On the Playbook, choose Rewrite this rule on its row, change the words and Save. The new wording is the next version — the row shows Version 2 — in force from that moment; the old wording stands down at the same moment and is kept in the history.
A one-line rule is never edited in place, so a draft written under the old wording was right when it was written, and is still checked against the wording its author had.
A document rule: edit the document
You don't edit a document rule in Vythos. You edit the document, and the rule follows. Every document rule tells you exactly how, in its own row: open it and the line under the text says what to do for that document's source.
Google Drive and Notion
Edit the file. Change the wording in the Google Doc, the Sheet, or the Notion page. Within about ten minutes the rule shows a new version, and the old version is kept.
Or upload a new version of the same file. For a PDF or a Word file in Drive, right-click the file → File information → Manage versions → Upload new version. That keeps the same file, so the rule follows it. Saving the new document as a separate file does not.
A new file is not an update
Rate Card 2026.pdf sitting next to Rate Card 2025.pdf is a different document, and Vythos will not transfer a rule to it on its own — a "v2" in a folder is as often a draft as a replacement. Add the new file with Add from a document and tick that it replaces the old one.
Uploaded files
Upload the file again under the same name, from Sources → Local Files. The new text becomes the next version of the rule.
Only the person who added the rule updates it this way. A colleague uploading a file that happens to have the same name is uploading their file; it doesn't touch your rule.
What counts as a change
Vythos compares the words. So:
- Reworded, re-figured, sections added or removed → new version.
- Renamed or moved the file → nothing changes; the rule follows the file itself, not its name or folder.
- Opened, commented on, re-saved with no edits → nothing. Vythos notices the file was touched, reads it, sees the same words, and leaves the rule alone.
How long it takes
About ten minutes, and never more than that in normal operation — Vythos checks each rule's document on that cycle. The checks are light, and nothing is re-read unless the document has actually changed, so this costs your Drive or Notion account almost nothing.
If you want to see it happen, change a number and watch the rule's version badge.
What happens to the values
The new values come from the new text. If everything you had confirmed is still stated in the document, the rule stays confirmed. If a confirmed value changed, the rule's values go back to unconfirmed — a new reading nobody has checked — until you confirm them again. See Values.
What happens to work already in progress
Nothing breaks. When an AI tool asked for context, Vythos recorded which version of each rule it handed over, and a draft is checked against that version. Your writer is never told off for following the rule they were given.
If a document can't be read
If Vythos can't read the document any more — deleted, binned, access withdrawn — the rule keeps working with the text it last read and shows an orange note explaining why. See When a file can't be read.
Older rules with no home
A workspace that has been running since before rules had a home may still hold a rule with neither a line's Rewrite nor a document's update line on its row. Nothing will ever change it. To give it a home, write it again as a line, or add its document with Add from a document and tick that it replaces the old rule; then retire the old one if it's still there.
