CONCEPTS
Agent catalog
The catalog lists every agent persona available in Verdaca's current release, organized by the deliberation context each one is optimized for. Personas are not interchangeable by default — each carries a role contract, a constraint set, and an output format spec. Choose the ones whose domain focus matches what you need in the room.
ADVISORY
Persona contracts are versioned independently of the kernel. When a persona contract advances a major version, existing sessions that reference that persona by name will continue to use the pinned version until you explicitly migrate.
Studio agents
Studio agents are optimized for high-deliberation work: design, architecture, strategy, and quality critique. They are the default panel for Studio-tier sessions.
| Agent | Role | Key capabilities |
|---|---|---|
| Sally | UX Designer | Screen-level UX analysis, accessibility critique, component hierarchy review, and user-journey gap identification |
| Winston | Architect | System architecture review, layer decomposition, cross-component dependency analysis, and ADR drafting |
| Amelia | Test architect | Test strategy design, coverage gap analysis, contract test scaffolding, and no-waiver boundary enforcement |
| Sophia | Market strategist | Narrative strategy, market positioning, audience-register calibration, and message stress-testing |
| Caravaggio | Visual designer | Visual identity critique, brand-system consistency review, typography and contrast audit, and layout hierarchy evaluation |
| Quinn | QA lead | End-to-end quality gate enforcement, regression surface analysis, and test-artifact provenance review |
Factory agents
Factory agents handle structured analysis tasks — requirements decomposition, data interpretation, and test execution — and are optimized for high-throughput, repeatable work within defined scope.
| Agent | Role | Key capabilities |
|---|---|---|
| John | Business analyst | Requirements elicitation, process mapping, acceptance criteria drafting, and stakeholder-needs decomposition |
| Mary | Data analyst | Quantitative analysis, dataset interpretation, metric framing, and findings synthesis |
| Murat | Test engineer | Test case execution, defect triage, coverage reporting, and quality-metric tracking |
Using an agent
Load any catalog persona by its ID string and attach it to an active session.
from verdaca.catalog import get_agent
sally = get_agent("sally")
session.add_persona(sally)IMPORTANT
Pin personas by explicit version in production sessions; relying on the default alias means your session behavior will change when the catalog advances.
Build your own
If no catalog persona covers your domain, you can define your own with the same role-card and constraint schema the catalog agents use.
See Build your own agent for the full guide.