AI Product Building Architecture Knowledge Systems

Files are the universal interface between humans and agents

Markdown and YAML files on disk beat databases because agents already know file operations and humans can inspect everything

@danshipper + @nicbstme — Agent-Native Architectures + Fintool · Feb 24, 2026 · 17 connections

Agents already know cat, grep, mv, mkdir. Users can inspect and edit what agents create. File paths are self-documenting — /projects/acme/notes/ beats SELECT * FROM notes WHERE project_id = 123. iCloud handles multi-device sync for free.

Nicolas Bustamante at Fintool stores user data (watchlists, portfolio, preferences, memories, skills) in S3 as YAML files instead of a traditional database. This makes everything debuggable with cat, versionable for free, and directly editable by users. The context.md pattern — a single markdown file as agent working memory — embodies this same idea and connects to why Context is the product, not the model.

This pattern is why Markdown skill files may replace expensive fine-tuning works in practice — when the knowledge layer is plain files, both humans and agents can read, write, and evolve it without deployment cycles.

This extends beyond developer tooling into enterprise architecture: Agents eat your system of record — the rigid app was the constraint, not the schema — when agents replace rigid apps, files become the source of truth and databases become regenerable caches derived from those files.

Connected Insights

References (3)

→ Context is the product, not the model → Agents eat your system of record — the rigid app was the constraint, not the schema → Markdown skill files may replace expensive fine-tuning

Referenced by (14)

← Context centralization is why coding AI works — git is a solved context repository, knowledge work has no equivalent ← Context is the product, not the model ← Markdown skill files may replace expensive fine-tuning ← Spec files are external memory that survives context resets ← Persistent agent memory preserves institutional knowledge that walks out the door with employees ← Structure plus reasoning beats flat similarity for complex domains ← Skill graphs enable progressive disclosure for complex domains ← A skill's folder structure is its context architecture — the file system is a form of context engineering ← Agents eat your system of record — the rigid app was the constraint, not the schema ← Context inefficiency compounds three penalties: cost, latency, and quality degradation ← Harness engineering — humans steer, agents execute, documentation is the system of record ← Virtual filesystems replace sandboxes for agent navigation — intercept commands instead of provisioning infrastructure ← Knowledge systems need dual-layer storage — narrative depth and structured queries can't share a format ← Memory defines the agent — a zip of markdown files IS the agent, and portable memory between harnesses is the frontier