Skip to content

FRED.md

Latest commit

 

History

History
62 lines (43 loc) · 4.25 KB

FRED.md

File metadata and controls

62 lines (43 loc) · 4.25 KB
Raw

FRED — A Personal Operating System

Framework. Record. Encyclopedia. Deliverable.

FRED is a personal operating system built on an Obsidian vault. The AI (Cowork, running on a mini PC) reads, writes, and maintains the vault under a strict operating contract. The user interacts with it through a phone-side relay (Dispatch). Together they form a memory + reasoning + execution loop that learns over time.

FRED is a ship. You are the owner; FRED is the vessel and her crew — the Captain sets the rules (Framework), the steward keeps the log and the standing Orders (Record), the galley provisions knowledge (Encyclopedia), and the bosun drives the work on deck (Deliverable). The full crew and naming charter live in 1-F/Rules/naming-conventions.md.

The four layers

1-F/   Framework — Rules, Templates, Skills, Tools. How the AI thinks. Capability and rules; no memory.
2-R/   Record — Sessions, Life-Journal, Worker-Prompts, Scratch. The AI's intake + activity log and the standing worker-prompts.
3-E/   Encyclopedia — Active topic folders. The verified, lifecycle-managed knowledge library.
4-D/   Deliverable — Active tasks, Routine-Plans. The master actionable list.

Day-to-day flow: idea → Framework (the AI thinks) → Record (the AI intakes) → Encyclopedia (the AI organises and enriches) → Deliverable (the AI surfaces an actionable plan).

What's in each folder

See the ABOUT-<layer>.md inside each top-level folder for the full breakdown.

FRED's evolution

Version Window What changed
V1 2026-04-25 → 05-01 Simple Project Manager
V2 2026-05-01 → 05-03 Project Manager + Life Management hybrid
V3 2026-05-03 → 05-05 Became a Life Management system
V4 2026-05-05 → 05-25 Adopted the four-layer architecture
V5 2026-05-25 → 06-08 Essential skills (Lint, Watch, Caption, Defuddle, REFRESH), 6-state lifecycle, scheduled tasks, F.R.E.D. single-letter folder restructure. First public release.
V6+ TBD Roadmap: provenance per claim, initiatives layer, Socratic challenge mode, typed wiki-link edges, injection defense

The execution chain

  • Cowork (mini PC) — the executor with vault access. Built on Claude Opus.
  • Dispatch (phone) — the lightweight interface. Built on Claude Sonnet.
  • Creator chat (claude.ai) — the architect. Designs rule updates as paste-ready replacements.
  • Specialist + Dispatcher + PM chats (claude.ai, per-project) — thinkers / translators / orchestrators.

The user is the relay. Dispatch sends command blocks to Cowork. Cowork executes against the vault.

Architecture decisions worth knowing

  • Topics not folders. Knowledge is organised by topic, not by directory hierarchy. Topics are registered in 1-F/Rules/topics.md. Each topic gets a folder under 3-E/Active/<topic>/ containing a master file and supporting clippings.
  • Wikilinks resolve globally. Obsidian-style [[some-slug]] references resolve by filename across the whole vault — no folder paths needed.
  • 6-state lifecycle on knowledge. draft → active → stale | contradicted | canonical → archived. The review skill — the galley's health loop (the chef in the ship model) — proposes transitions on a schedule.
  • Health passes run on a schedule. Daily task pass (tasks), weekly Encyclopedia pass + INDEX rebuild (review), monthly whole-vault audit. Reports land in 2-R/Sessions/Lint-Reports/ + Task-Reports/.
  • Pre-write path check. All writes to 1-F/ require user confirmation, with a few auto-permitted exceptions (bugfix.md append, 1-F/Templates/, 2-R/Scratch/, 2-R/Sessions/).
  • Privacy registry. 1-F/Rules/privacy.md lists protected paths. V5 ships with only 1-F/ registered as confirm-first; personal tiers (health/finance/faith) are re-registered via the make private: command when added.

Starting points

  • Read 1-F/Rules/CLAUDE.md for the global instructions the AI loads each session.
  • Read 1-F/Rules/cowork_contract.md for the full operating contract.
  • Read 1-F/Templates/prompts/fred_master_prompt.md for the Creator chat system prompt.
  • Browse 1-F/Skills/ for the modular capabilities loaded on demand.

License

MIT. See LICENSE at the root.