TOTALLY\README.TXT LIKE, SERIOUSLY: SHOW ME THE RECEIPTS
TOTALLY / THE MANIFOLD Repository
TOTALLY.TXT 00 / LIKE, SERIOUSLY EPITEMIC

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.

FAILURE_MODES.TXT 01 / WHY AGENTS SPIRAL

THE EPITEMIC CRISIS

Why coding agents keep breaking your code.

§ 1.0

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_HIERARCHY.TXT 02 / THREE SPEEDS OF MEMORY

MEMORY REVOLUTION

Three speeds: Non-Negotiables, Receipts & Group Chat.

§ 2.0

Standard projects mix axioms, architectural conventions, and daily task notes into a giant, messy README. Totally separates truth into three temporal speeds.

Tier 1: Permanent

The Non-Negotiables

docs/INVARIANTS.md [INV-NNN]

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
Tier 2: Epochal

The Receipts

AGENTS.md, ARCHITECTURE.md, DECISIONS.md

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
Tier 3: Ephemeral

The Group Chat

docs/HANDOFF.md [RECEIPT TAGS]

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
AGENT_ROUTINE.TXT 03 / THE 5-STAGE WORKFLOW

SESSION PROTOCOL

The 5-Stage Agent Routine.

§ 3.0

Every coding agent follows five invariant stages from entering the room to logging off cleanly.

01
Catching Up on the Tea

Read docs/HANDOFF.md, check the session lock, drop external training priors (INV-010), and confirm a clean git status.

Read & Audit
02
The Vibe Check

Scope one bounded change, check why old guards exist (INV-004), and ask clarifying questions upfront instead of guessing (INV-009).

Ask First
03
Making the Edits

Surgical implementation with zero conversational filler. If a premise breaks mid-build, hit pause and regroup (INV-009).

Surgical Code
04
Showing the Proof

Run tests with negative proof grounding (INV-007). Stop on friction instead of hacking workarounds, and assign Receipt Tags.

Receipt Tags
05
Updating the Group Chat

Rewrite current state under the 80-line limit (INV-005), run check_totally.py, and log off cleanly.

Handoff & Exit
PROOF_TAGS.TXT 04 / SHOW ME THE RECEIPTS

EPISTEMIC TAGGING

Receipt Tags & Negative Proof Grounding.

§ 4.0

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.
GLOSSARY.TXT 05 / THE ROSETTA STONE

FOUR-WAY TRANSLATION

Valley-Girl, Middle-earth, Vedic & Plain English.

§ 5.0

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.

FILTER LIVE / 20 CANONICAL CONCEPTS
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
CHEAT_SHEET.TXT 06 / QUICK REFERENCE

QUICK REFERENCE

The Totally Cheat Sheet.

§ 6.0

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)
VIBE_LINTER.TXT 07 / AUTOMATED ENFORCEMENT

AUTOMATION

The Vibe Linter: Zero-Dependency Guard.

§ 7.0

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.

LINEAGE.TXT 08 / ARCHITECTURAL EVOLUTION

GENEALOGY

Four editions, one unbroken chain of rigor.

§ 8.0

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.