All insights
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 · · 15 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 → Markdown skill files may replace expensive fine-tuning → Agents eat your system of record — the rigid app was the constraint, not the schema

Referenced by (12)

← Context is the product, not the model ← 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 ← Agents eat your system of record — the rigid app was the constraint, not the schema ← Markdown skill files may replace expensive fine-tuning ← Harness engineering — humans steer, agents execute, documentation is the system of record ← Context inefficiency compounds three penalties: cost, latency, and quality degradation ← A skill's folder structure is its context architecture — the file system is a form of context engineering ← 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