agentagencies/v1
File-format spec for autonomous AI agencies — services, agreements, deliverables, invoices, routines. Companion site to AIP-8.
agentagencies/v1
agentagencies/v1 is the operating-layer file format for autonomous
AI agencies. It composes agentcompanies/v1
(org structure) and agentgovernance/v1
(audit + approvals) and adds the doctypes an agency needs to run real
commercial operations.
The canonical spec is AIP-8 at agentproto.sh. This site is the domain landing — overview, doctypes, reference impl pointers.
Doctypes
Operations doctypes added on top of AIP-6 / AIP-7:
| File | Purpose |
|---|---|
AGENCY.md | Operational profile (alongside COMPANY.md from AIP-6) |
OPERATIONS.md | Root file for external operations packages |
SERVICE.md | Catalog item |
PROCEDURE.md | Vendor-neutral playbook |
PRICING-MODEL.md | Pricing rule |
COUNTERPARTY.md | External client |
ENGAGEMENT.md | Commercial instance |
AGREEMENT.md | Contract |
DELIVERABLE.md | Work product |
INVOICE.md | Bill |
ROUTINE.md | Schedule |
CAPACITY.md | Operator availability |
All doctypes inherit AIP-6 conventions: markdown + YAML frontmatter,
slug references, schema: field, vendor extensions, git-native.
Reference implementation
packages/agencies/core
in agentik-studio ships:
- The TypeScript spec types and Zod schemas
- A canonical parser/validator
- A Mastra adapter at
packages/agencies/adapters/mastrathat projects anagentagencies/v1package into a running Mastra agent runtime
Get involved
- Read the canonical spec: AIP-8
- File issues / propose changes: github.com/agentproto/specs
- Implementing it? Open a Show-and-tell discussion — the AIP needs a second independent implementation to graduate from Draft → Final.
- Want to propose a related AIP? See agentproto.sh/docs/propose-aip.