Architecture
Agent-Native Architecture
DS
Dan Shipper
CEO & Co-founder, Every
Open in YouTube at 0:25:42Timestamp: 0:25:42
Design principles for building apps with agents at their core: Parity (agents can do what users can), Granularity (tools smaller than features), and Skills (organized capabilities). Every button press is a prompt.
When to Use
When starting a new AI-native projectRefactoring for AI collaborationWhen AI struggles with your codebaseTo enable emergent agent capabilities
Steps (4)
1
Establish Parity
Whatever users can do through the UI, agents should be able to do. This enables emergent features—agents can clear all comments even if you didn't build that feature.
2
Increase Granularity
Design tools at a granular level, smaller than features. Agents can combine tools in ways you didn't predict.
3
Define Skills
Organize code by capability/skill boundaries. Each feature is a skill with prompts and tools that runs in a loop until done.
4
Document for Agents
Create AGENTS.md, README files, and inline documentation that helps AI understand context.
Tools
AGENTS.mdSkillsMCP