Skip to main content
worker files / agent roles

suspec-agents

Claude Code worker files for Suspec roles.

Add one when a role needs its own operating context.

  1. 01Role
  2. 02Inputs
  3. 03Tools
  4. 04Evidence

delegation record

worker identity · inputs · tools · evidence

note

A worker can return evidence. It cannot certify its own result.

role files

workers

6

hooks

2

home

.claude/agents

This page is a roster. The repo holds the files; the docs explain when to delegate.

install.sh — copy one worker
pwrcheckevidence

# copy one worker

$ REPO=<your-repo>

$ AGENT=suspec-reviewer.md

$ DEST="$REPO"/.claude/agents

$ mkdir -p "$DEST"

$ cp agents/"$AGENT" "$DEST"/

# optional hooks

$ DEST="$REPO"/.claude/hooks

$ mkdir -p "$DEST"

$ cp hooks/*.sh "$DEST"/

These are Claude Code agents in .claude/agents/. npx skills installs the skills catalog, not these.

tier-1.conf — read-only workers

Read-only workers

These drop Edit/Write from the tool list. The guard narrows shell writes. It is not a sandbox.

review requiredtoolable limits
tier-2.conf — bounded authoring

Bounded-authoring workers

These can write one artifact. The scope is instruction, not hard enforcement.

bounded draftreview required
scope.note — toolable, not a wall

Limits

Tool lists and hooks narrow the surface. They do not make a hard security boundary.

Read the enforcement notes →

delegation trace

Why not just the built-in reviewer?

Use built-ins when they are enough. Use these when a role file or delegation trace helps.

How the delegation trace works →

portability

Claude Code first

suspec agents emit --codex generates Codex agent files from the same definitions.

Tool scoping and hooks are specific to Claude Code. Other runners need their own controls.

catalog — browse on github

The full catalog

Six workers and two hooks. Read the file before you copy it.

Browse suspec-agents on GitHub →