TOTALLY / PLAIN-ENGLISH & VALLEY-GIRL EDITION OF VEDAS
The agents change every session.
The Receipts endure.
Show Me the Receipts
No unproven speculation in handoffs. Every claim must carry a formal Receipt Tag: [SAW_IT_MYSELF], [OBVIOUSLY], [GOSPEL], [VIBE_CHECK], or [NO_RECEIPTS].
Three Speeds of Memory
Non-Negotiables carved in stone, append-only Receipts for architecture and ADRs, and an 80-line Group Chat handoff that stays strictly on one screen.
Ask First, Don't Guess
Hermeneutic circle safeguards: drop external assumptions on entry, clarify mixed signals upfront, and hit pause when a premise breaks mid-build.
THE EPITEMIC CRISIS
Why coding agents keep breaking your code.
AI coding agents enter every turn with a fresh brain: zero working memory of yesterday's decisions, blind trust in their own plausible output, and a persistent habit of silently guessing when instructions are vague.
| The Drama (Failure Mode) | What Actually Happens | How Totally Shuts It Down |
|---|---|---|
| Faking It (No Proof) | Agent assumes untested code works because the syntax looks pretty. | Receipt Tags: Mandatory [SAW_IT_MYSELF] or [NO_RECEIPTS] tags on every handoff claim (INV-003). |
| Silent Guessing | Agent encounters vague requirements and secretly compiles a wild guess into code. | Ask First, Don't Guess: Agent halts during scoping and asks clarifying questions before building (INV-009). |
| Projecting Assumptions | Agent projects standard package managers or framework idioms not present in the files. | Drop the Assumptions: Agent audits priors on entry and relies only on verified repository files (INV-010). |
| Cheesy Workarounds | Agent hits unexpected test friction and sneaks around it with a cheesy fallback hack. | Huge Red Flag: Friction triggers an immediate stop-and-inquire routine; no silent hack routing (INV-007, INV-009). |
| Deleting Old Guards | Agent deletes an unfamiliar constraint or boundary without knowing what it protected. | Why Is This Even Here?: Must trace the originating decision (D-NNN) before altering any guard (INV-004, INV-009). |
MEMORY REVOLUTION
Three speeds: Non-Negotiables, Receipts & Group Chat.
Standard projects mix axioms, architectural conventions, and daily task notes into a giant, messy README. Totally separates truth into three temporal speeds.
The Non-Negotiables
Ten bedrock laws set in stone (INV-001 through INV-010). Autonomous agents cannot alter or relax these without explicit human maintainer sign-off.
IMMUTABLE / ZERO DRIFT
The Receipts
Append-only architecture and decision history. When a technical choice changes, a new entry supersedes the old; past history is never erased.
APPEND-ONLY / ADRS
The Group Chat
The immediate status update. Rewritten every session, capped at 80 lines, qualified with explicit Receipt Tags so nobody has to read a novel to get up to speed.
REWRITTEN / ≤ 80 LINES
SESSION PROTOCOL
The 5-Stage Agent Routine.
Every coding agent follows five invariant stages from entering the room to logging off cleanly.
Read docs/HANDOFF.md, check the session lock, drop external training priors (INV-010), and confirm a clean git status.
Scope one bounded change, check why old guards exist (INV-004), and ask clarifying questions upfront instead of guessing (INV-009).
Surgical implementation with zero conversational filler. If a premise breaks mid-build, hit pause and regroup (INV-009).
Run tests with negative proof grounding (INV-007). Stop on friction instead of hacking workarounds, and assign Receipt Tags.
Rewrite current state under the 80-line limit (INV-005), run check_totally.py, and log off cleanly.
EPISTEMIC TAGGING
Receipt Tags & Negative Proof Grounding.
Never trust an assertion without a receipt. Totally enforces formal epistemic classification on every claim.
| Receipt Tag | Plain English Meaning | Vedic Equivalent | When to Use It |
|---|---|---|---|
| [SAW_IT_MYSELF] | Directly run and observed in this session | Pratyakṣa | When a test command ran cleanly and you saw the terminal output with your own eyes. |
| [OBVIOUSLY] | Logically derived from types, schemas, or proofs | Anumāna | Static type checks, AST linting, and mathematical invariants that must hold true. |
| [GOSPEL] | Decreed by maintainer contract or specification | Śabda | Documented requirements, schema contracts, and maintainer specifications. |
| [VIBE_CHECK] | Working hypothesis explaining an anomaly | Arthāpatti | An unexplained failure or suspected cause awaiting empirical reproduction. |
| [NO_RECEIPTS] | Explicit boundary of non-observation | Anupalabdhi | Things that have not been run or tested this session. The honest admission of limits. |
FOUR-WAY TRANSLATION
Valley-Girl, Middle-earth, Vedic & Plain English.
Every term in Totally maps 1-to-1 to plain English, to Mellon, and to Vedas. Use this table as a live dictionary to translate across editions.
| Totally Term (Valley-Girl) | Plain English Meaning | Mellon (Middle-earth) | Vedas (Sanskrit) | File / Rule |
|---|---|---|---|---|
| The Non-Negotiables | Immutable bedrock invariants of the project | The Elder Runes | Śruti | docs/INVARIANTS.md |
| The Receipts | Append-only architecture and decision history | The Red Book of Westmarch | Smṛti | docs/DECISIONS.md |
| The Group Chat | Rewritten 80-line current session handoff | The Watchfire Log | Vartamāna | docs/HANDOFF.md |
| Fresh Brain | Fresh context window with zero memory of past chats | New Traveler | Śūnya | Architecture |
| Receipt Tag | Mandatory tag showing how a claim was proven | Proof Badge / Ranger Mark | Pramāṇa | INV-003 |
| Punchy Proposition | High-density proposition under 25 words with zero fluff | Mithril Prose | Sūtra | INV-008 |
| Receipt Consolidation | Subconscious distillation of episodic logs into short rules | Elven Sleep | Sūtra Consolidator | INV-008 |
| No Em Dashes, Seriously | Ban on em dashes and robotic AI conversational filler | No Black Speech | Śikṣā | INV-006 |
| Catch the Red Flag | A new test must fail on the old bug before you trust it | Sting's Blue Glow | Vyatireka | INV-007 |
| The Vibe Linter | Bidirectional Python script enforcing document integrity | The Palantír Linter | Ghana-pāṭha Checker | INV-004 |
| The Agent Routine | The 5-stage start-to-finish session workflow | Fellowship Quest Loop | Kalpa | AGENTS.md |
| Drop the Assumptions | Discarding pre-trained model priors upon repo entry | Ban Saruman's Voice | Adhyāsa-Nirāsa | INV-010 |
| Mixed Signals | Ambiguity or part-whole gap blocking sound execution | Riddles in the Dark | Saṃśaya | INV-009 |
| Ask First, Don't Guess | Asking clarifying questions before writing code; never guessing | Speak, Friend | Praśna | INV-009 |
| Hit Pause & Regroup | Looping from Build/Verify back to Scope when a premise breaks | Turn Back at Caradhras | Āvartana | INV-009 |
| Huge Red Flag | Code or test friction that halts workarounds and triggers inquiry | "You Shall Not Pass!" | Pratibandha | INV-007, INV-009 |
| Why Is This Even Here? | Tracing why an old constraint exists before removing it (Chesterton's Gate) | The Doors of Durin | Pūrva-Pakṣa | INV-004, INV-009 |
| Both Things Are True | Two true claims that conflict, tracked with an owner and review trigger | Two Watchtowers | Ubhaya-Saṃkaṭa | docs/DECISIONS.md (T-NNN) |
| Our Circle (Zone) | One repository and the rules that apply inside it; outside docs are gossip | Realm Border (Zone) | Kṣetra | AGENTS.md, docs/SECURITY.md |
| The Plan | Permanent, never-renumbered roadmap task IDs | The Shire Reckoning | Jyotiṣa | INV-004 |
QUICK REFERENCE
The Totally Cheat Sheet.
Copy-paste commands, prompts, and Non-Negotiables for daily agent sessions.
Session Entry Routine
1. Read docs/HANDOFF.md
2. Read docs/INVARIANTS.md
3. Run python3 tools/check_totally.py --template
4. Inspect git status
Session Exit Routine
1. Run offline verification tests
2. Rewrite docs/HANDOFF.md (under 80 lines, with Receipt Tags)
3. Run python3 tools/check_totally.py
AI Coding Assistant Starter Prompt
You are an agent operating under Totally in totally/. Read docs/HANDOFF.md and docs/INVARIANTS.md first. Never guess silently; if anything is ambiguous, ask clarifying questions before editing code. Show me the receipts. Run python3 tools/check_totally.py to verify your work.
The Ten Non-Negotiables
- INV-001: Zero External Baggage (standard library only)
- INV-002: One Source of Truth (no duplicate descriptions)
- INV-003: Show Me the Receipts (mandatory Receipt Tags)
- INV-004: Two-Way Sync (reciprocal reference checks)
- INV-005: Keep It Short (80-line Group Chat cap)
- INV-006: No Em Dashes, Seriously (zero em dashes)
- INV-007: Catch the Red Flag (negative proof grounding)
- INV-008: Keep It Tight (under 25 words per rule)
- INV-009: Ask First, Don't Guess (clarify upfront)
- INV-010: Drop the Assumptions (no prior projection)
AUTOMATION
The Vibe Linter: Zero-Dependency Guard.
Prose guidelines without code enforcement are just wishes. The Vibe Linter turns the Non-Negotiables into a binary build gate.
$ python3 tools/check_totally.py --template 0 error(s), 0 warning(s) in 15 file(s)
Bidirectional Check
Ensures that every Non-Negotiable cited anywhere exists in docs/INVARIANTS.md, and every rule defined there is cited in the living documents.
Receipt Tag Scanner
Scans every capability assertion in docs/HANDOFF.md to guarantee that an explicit Receipt Tag is present.
Em Dash Firewall
Scans all Markdown prose and rejects any em dashes (INV-006), keeping prose spoken, direct, and free of model ruts.
GENEALOGY
Four editions, one unbroken chain of rigor.
From biological physics to Sanskrit epistemology, Middle-earth lore, and pop-culture clarity: the evolution of AI agent memory.
The Hypervisor
"Gives the model a body." Semantic leverage, bio-physics, and living memory.
The Manifold
"Gives the work a memory." Zero-dependency Markdown contracts and two speeds.
Vedas
"Classical Epistemology." Śruti, Smṛti, Vartamāna, Pramāṇa, and Sūtras for epistemology nerds.
Mellon
"Plain English & Lore." Elder Runes, Red Book, Watchfire, and Lord of the Rings tropes.
Totally
"Like, Seriously Epistemic." Non-Negotiables, The Receipts, The Group Chat, and Valley-Girl clarity.