Skip to content

Agents

A subagent is a one-shot, role-prompted invocation of the host runtime's "spawn a subordinate agent" capability. Agents do not run in a daemon; they spawn, execute, and exit. Workflows orchestrate, agents read, write, and reason.

agents/ ships 13 spawnable agents and 3 audit-surface modules, 16 files total. Modules carry module: true in their frontmatter and are loaded via Read by their parent spawnable agent; lib/agents.cjs::loadAgent rejects them for direct spawning. The modules are np-critic-style, np-critic-tests, and np-critic-acceptance, loaded by np-critic per the Single-Critic Revision (ADR-0010 §2026-05-05). np-researcher-reconciler (Stage 2 of the researcher swarm, ADR-0018) joined the spawnable set on 2026-05-12.

The orchestration graph is exactly one level deep: agents may not spawn other agents.

Where to look

TopicPage
Full per-agent details (tier, tools, spawn-source, handoff protocol)Catalog
The frontmatter contract (required fields, forbidden fields, tier enum)Frontmatter Schema
Why no model / hooks field, what tier means, the mandatory-initial-read invariantConcepts → Agents
Tier × Profile model resolutionAgent Frontmatter Schema § Model resolution