Dojo Templates

Dojo templates are pre-built venture blueprints that install a complete setup in one command: agents with roles, an escalation hierarchy, a directive tree, and fuel limits. Think of them as starter kits for common multi-agent workflows.

Bundled Templates

Mayros ships with 3 built-in templates:

security-audit

Three-agent squad for comprehensive security auditing.

Agent	Role	Pulse	Escalates To
`scanner`	Vulnerability Scanner	4h	—
`reviewer`	Security Reviewer	2h	scanner
`fixer`	Patch Author	1h	reviewer

Directives: "Maintain secure codebase" with OWASP Top 10 scanning, dependency auditing, and critical vulnerability patching. Default prefix: SEC, fuel limit: 10,000 cents.

content-pipeline

Writer-editor-publisher pipeline with review gates and quality checks.

Agent	Role	Pulse	Escalates To
`writer`	Content Writer	6h	—
`editor`	Editor	4h	writer
`publisher`	Publisher	2h	editor

Directives: "Produce high-quality content" with drafting, editing, and publishing tasks. Default prefix: PUB, fuel limit: 5,000 cents.

devops-squad

Deploy-monitor-respond cycle for infrastructure operations.

Agent	Role	Pulse	Escalates To
`deployer`	Release Engineer	1h	—
`monitor`	Observability Agent	30m	deployer
`responder`	Incident Responder	15m	monitor

Directives: "Maintain reliable infrastructure" with automated deployment, health monitoring, and incident triage. Default prefix: OPS, fuel limit: 15,000 cents.

Preview Before Install

See exactly what a template will create before committing:

bash
mayros kaneru dojo preview --template security-audit

Template: Security Audit Squad (security-audit v1.0.0)
Three-agent squad for comprehensive security auditing...

Prefix: SEC
Fuel limit: 10000 cents

Agents (3):
  scanner [Vulnerability Scanner] (pulse: 4h)
  reviewer [Security Reviewer] → escalates to scanner (pulse: 2h)
  fixer [Patch Author] → escalates to reviewer (pulse: 1h)

Directives (6):
  [strategic] Maintain secure codebase
    [objective] Identify and classify vulnerabilities
    [objective] Remediate critical and high severity findings
      [task] Run OWASP Top 10 scan
      [task] Review dependency audit results
      [task] Patch critical vulnerabilities

Install a Template

bash
mayros kaneru dojo install --template security-audit --name "My Security Team"

This atomically creates:

A venture named "My Security Team" with prefix SEC and 10,000-cent fuel limit
3 agents deployed with their roles
Escalation hierarchy (fixer → reviewer → scanner)
6 directives organized as a strategic → objective → task tree

List Available Templates

bash
mayros kaneru dojo list

Hub Marketplace

Templates can also be downloaded from the Skill Hub marketplace:

bash
# Search for community templates
mayros kaneru dojo search
mayros kaneru dojo search --query "data pipeline"

# Install from the Hub
mayros kaneru dojo install-hub --slug my-custom-template --name "Custom Venture"

Hub templates are parsed as DojoTemplate JSON and validated before installation.

Creating Custom Templates

A custom template is a JSON file conforming to the DojoTemplate schema:

json
{
  "id": "my-template",
  "name": "My Custom Template",
  "description": "A brief description of what this template sets up.",
  "version": "1.0.0",
  "agents": [
    { "agentId": "lead", "role": "Team Lead", "pulseInterval": "2h" },
    { "agentId": "worker", "role": "Worker", "escalatesTo": "lead", "pulseInterval": "1h" }
  ],
  "directives": [
    { "title": "Main goal", "level": "strategic" },
    { "title": "Sub-goal", "level": "objective", "parentIndex": 0 },
    { "title": "Specific task", "level": "task", "parentIndex": 1 }
  ],
  "ventureDefaults": {
    "prefix": "MYT",
    "fuelLimit": 8000
  }
}

Validation Rules

Templates are validated on install with these constraints:

Rule	Limit
Maximum agents	20
Maximum directives	50
Agent ID format	Alphanumeric, hyphens, underscores only (`^[a-zA-Z0-9_-]+$`)
Required fields	`id`, `agents`, `directives`, `ventureDefaults`

Templates exceeding these limits are rejected with a descriptive error message.

MCP Tools

📌

kaneru_dojo_list

List all available Dojo templates (bundled and Hub).

📥

kaneru_dojo_install

Install a template by ID, creating a fully configured venture.

Next Steps

Ventures & Missions — what gets created when you install a template
Learning & Routing — how agents build expertise after deployment
Fuel Control — budget limits set by templates