Templates are role-specific starting points for agents. They live inDocumentation Index
Fetch the complete documentation index at: https://docs.yourhq.ai/llms.txt
Use this file to discover all available pages before exploring further.
templates/ and get seeded into the gateway’s local git repo as template/<name> branches on first boot.
Template files
| File | Purpose |
|---|---|
agent.json | Runtime metadata: slug, name, description, team, capabilities, browser color |
IDENTITY.md | Role, voice, and domain behavior |
SOUL.md | Goals and non-negotiables |
USER.md | Owner profile placeholders (filled at provision time) |
MEMORY.md | Starting long-term context |
TOOLS.md | Tool-use guidance |
AGENTS.md | Agent-specific instructions |
skills/ | Reusable procedures and scripts |
How provisioning works
When you create an agent, HQ forks the selected template branch into the agent’s personal branch, then patches identity fields (slug, name, emoji, channel).
The model field is optional — agents use the default provider configured in Settings → Connections unless overridden per-agent from the agent detail page.