Skip to content

Personas Reference

In SNIPER v3, agent behavior is defined directly in agent definition files (packages/core/agents/*.md). Cognitive personas are optional mixins that shape how an agent thinks — they overlay a thinking style onto any agent.

Cognitive Personas

Cognitive personas influence an agent's reasoning and decision-making priorities. They are applied as mixins via configuration.

PersonaDescription
Devil's AdvocateChallenges assumptions, finds weaknesses, stress-tests proposals
Performance FocusedPrioritizes runtime performance, efficiency, and resource optimization
Security FirstPrioritizes security in every decision, identifies threats early

Agents vs Personas

In v3, the distinction between "agents" and "personas" has been simplified:

  • Agents (packages/core/agents/*.md) define who does the work — their role, constraints, and output. There are 13 specialized agents including lead-orchestrator, architect, backend-dev, code-reviewer, doc-writer, and more.
  • Cognitive personas (packages/core/personas/cognitive/*.md) define how agents think — overlaying a reasoning style like security-first or performance-focused.

Agents are assigned to protocol phases. Cognitive personas are optionally applied to agents via configuration to adjust their approach.

Applying Cognitive Personas

Configure cognitive personas in .sniper/config.yaml:

5 lines
yaml
agents:
  architect:
    cognitive: security-first    # Architect will prioritize security
  backend-dev:
    cognitive: performance-focused  # Backend dev will prioritize performance