Agents

Agents are specialized sub-agents with focused tool access and a system prompt. Claude dispatches them via the Agent tool with subagent_type: <name>. In the claude-shared source tree they live at agents/<name>.md; at runtime under .claude/agents/<name>.md or ~/.claude/agents/<name>.md, or bundled inside the nolte-shared plugin.

Bundled agents

Agent	Purpose
claude-plugin-developer	Drafts spec-conforming plugin skills and agents for nolte-shared
audience-doc-author	Drafts or refines audience-driven documentation against an existing audience artifact
audience-review	Reviews audience artifacts produced by audience-identify (read-only)
spec-readiness-reviewer	Audits specs for contradictions, audience fit, and Requirement-vs-Acceptance completeness
docs-freshness-checker	Audits MkDocs documentation for language parity, dead links, stale path references, ADR hygiene
prose-vale-curator	Curates prose to pass Vale without altering technical claims
png-to-transparent-svg	Converts a PNG image with baked-in checkerboard transparency into an SVG file with real alpha

All agents follow the same specification (Agent Authoring). Canonical source per agent: agents/<name>.md in the source tree.

Agent anatomy

An agent is a single Markdown file with YAML frontmatter and a system prompt in the body:

---
name: <kebab-case-name>
description: Concrete triggers ("use when …"): not abstract capabilities.
tools: [Read, Grep, Glob]   # optional, principle of least authority
model: sonnet               # optional
---

# System Prompt

Role and boundaries. Output format. Procedure.

Frontmatter name must match the filename without .md. Omit tools only when the agent genuinely needs the full surface; otherwise list the minimum. Read-only agents must never receive write/edit/execution tools.

Source vs. runtime location

Context	Path
claude-shared source tree	agents/<name>.md
Consuming project, project-level	.claude/agents/<name>.md
Consuming project, user-level	~/.claude/agents/<name>.md
Delivered via plugin	the plugin's designated agents path

Agents must not assume a particular install location; all internal references stay relative to the agent file or the project it operates on.

Authoring rules

Full rules, acceptance criteria and open questions:

• Agent Authoring (Spec)
• Canonical (EN): spec/claude/agent-management/en.md
• Translation (DE): spec/claude/agent-management/de.md