Skip to content

Latest commit

 

History

History

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
 
 
 
 

README.md

Layer 8 — Filesystem-as-substrate

The framework all of the above lives inside.

This is the meta-claim: the filesystem is the orchestration substrate. Not Notion, not Salesforce, not Confluence, not Slack-as-knowledge-base. The filesystem.

The Omni Software Convergence Hypothesis (OSCH)

99% of specialized workflow software becomes redundant when AI + filesystem is the orchestration substrate.

The thesis:

  • Jobs-AR observation: AI is what the operating system absorbs as the interface, not the application. Apps become OS-callable.
  • Real modularity: primitive layer, substrate-shared (filesystem + AI agent + git).
  • Fake modularity: product layer, fragmented disguised as composable (Salesforce + Slack + Notion + Asana, each siloed despite "integrations").
  • The fragmented SaaS world is extraction-through-fragmentation wearing composability's costume.

What survives the convergence:

  • Network-effect products (social, payments)
  • Hardware-interface products (drivers, peripherals)
  • Regulated products (finance, healthcare with compliance moats)
  • Hardware-coupled products (CAD, video editing with GPU pipelines)

What doesn't:

  • Specialized workflow SaaS (CRM, project management, doc collaboration, knowledge base, queue managers, dashboards) — all reducible to markdown + AI orchestration.

The proof-of-concept stack

Subsystem Filesystem implementation What it replaces
Persistence Markdown files + git Postgres / Notion DB / a state-management SaaS
Discipline primitive_*.md + feedback_*.md files A rules engine / a Notion database
CRMs Per-partner directories with dashboard, atomic entries, schedule Salesforce / HubSpot
Paper trails Daily markdown reports + PDF rendering pipeline A reporting tool
Hooks Python scripts in ~/.claude/session-chain/ A SaaS dashboard / an automation platform
Knowledge base Cross-linked markdown files Confluence / a wiki
Meta-protocols Markdown files cross-referencing each other An architecture-decision-record tool

Every entry in the right column has at least one $20+/month SaaS that monetizes it. Every entry in the middle column is free, owned, and version-controlled.

Why the filesystem wins

Property Filesystem Specialized SaaS
Greppable ✓ instant ✗ proprietary search
Diffable ✓ per-edit ✗ rare or absent
Cross-referenceable ✓ relative paths ⚠ database links, vendor-locked
Version-controlled ✓ git ⚠ per-vendor history
Survives tool change ✓ format-stable ✗ migration risk
Composable with AI ✓ direct ⚠ via API integration
Cost $0 $20–$200/seat/month

Why this is Layer 8 of JARVIS, not Layer 0

The filesystem is foundational, but it's labeled Layer 8 because it's the only layer that survives every other layer being replaced.

  • Replace the LLM (substrate change): Layers 1–7 partially survive, the filesystem fully survives.
  • Replace the agent platform (Claude → other): Layer 6 needs porting; the filesystem is unchanged.
  • Replace the bot host (fly.io → other): Layer 7 redeploys; the filesystem is unchanged.
  • Replace the operating system (Windows → Linux): everything ports trivially because everything is files.

The filesystem is the lowest-impedance substrate available. JARVIS is built on it deliberately.

Real modularity vs. fake modularity

  • Real modularity: a markdown primitive that lives in ~/.claude/projects/.../memory/ is grep-accessible from any tool, importable into any system, diffable by git, and survives any vendor change.
  • Fake modularity: a Notion database row that "supports" a Zapier integration is locked to Notion, requires authentication to extract, has no native diff, and dies if Notion changes pricing or shuts down.

The fake-modularity world advertises composability while structurally preventing it. Vendor lock-in is the business model.

What this layer enables for everything above

  • Layer 7's CRMs work because the filesystem is the database
  • Layer 4's primitive accumulation works because the filesystem is permanent
  • Layer 2's persistence works because the filesystem survives session reset
  • Layer 1's hooks work because the filesystem is what they read and write

Without filesystem-as-substrate, every other layer would need to commit to a specific external tool. With it, all layers are tool-agnostic.

The capital-insufficiency observation

Capital is not sufficient.

Elon / X is the canonical exhibit: maximal capital deployment cannot reverse a substrate-mismatch. You cannot buy your way out of fake modularity. You can only rebuild on real modularity. The filesystem is real modularity.

Source of truth

This layer doesn't have a "source of truth" file because it is the substrate. Every other layer's source of truth lives on this layer. The filesystem is verifiable by direct inspection — clone, ls, grep, cat.