Agents work better when the surrounding software, documentation, and operational tooling are legible to them from the start.
Summary
Karpathy argues that much of today’s infrastructure is still written for humans. Documentation tells the human to click through URLs, configure settings, and wire services together. Agent-native infrastructure would instead expose instructions, sensors, actuators, APIs, and data structures that are legible and executable by agents.
Examples
- Setup instructions written as agent-ready tasks.
- APIs and CLIs that avoid fragile browser-only configuration.
- Docs that include copy-pasteable agent prompts.
- Machine-readable project state and deployment state.
- Agents that can coordinate with other agents on behalf of people or organizations.
Implication For This Wiki
This wiki should be easy for an LLM to operate:
notes/index.mdtells the agent what exists.log.mdtells the agent what happened recently.AGENTS.mdtells the agent how to act.raw/Source Index.mdtells the agent what sources exist and their status.
That makes the vault more agent-native than a normal folder of notes.
Related Concepts
Sources
Open Questions
- What would make this Obsidian vault more agent-native?
- Which operations should be represented as CLI tools instead of prose instructions?