Skip to content

templates: add a new agent role template (pick from list) following the existing ROLE.md pattern #289

Description

@jsyqrt

Goal

Markus ships 25 role templates (templates/roles/): researcher, developer, reviewer, ops, finance, HR, SRE... Add a role we don't yet have, following the same structure.

Candidate roles (pick one or propose your own with a clear job description)

  • security-auditor (review code/arch for vulnerabilities)
  • data-analyst (SQL/reporting agent)
  • seo-specialist (web visibility)
  • sales-engineer (demo + technical sales)
  • localization-manager (i18n coordination)

How

  1. Study templates/roles/sre/ROLE.md and templates/roles/secretary/ROLE.md — note the structure: Identity & Expertise, Core Responsibilities, Workflow, Guardrails, metrics
  2. Create templates/roles/NEW-ROLE/ROLE.md with:
    • Identity section (who the agent is, core expertise)
    • Core Responsibilities (tables of duties, triggers, outputs)
    • Workflow steps
    • Guardrails / escalation rules
    • Concrete success metrics
  3. Add the role to the README package table if roles are listed there
  4. Validate: the role directory is discoverable by the agent system (see how templates/roles is loaded — packages/core or packages/org-manager role loading)

Acceptance criteria

  • New role directory with ROLE.md following the existing template conventions
  • The role appears in the Web UI when creating/editing a team
  • No code changes required unless the role registry is hardcoded (then list the registry files you changed)

Size: S · Skill needed: prompt/role design, writing · Great first PR — mostly writing, no deep code.

Metadata

Metadata

Assignees

No one assigned

    Labels

    Type

    No type

    Projects

    No projects

      Milestone

      No milestone

      Relationships

      None yet

      Development

      No branches or pull requests

      Issue actions