N Agentic Harnesses For Anthropic
Use this skill as a router for designing, building, and evaluating agentic harnesses.
Read only the files you need. Do not load the entire reference set unless the request genuinely spans multiple subsystems.
Default posture:
- Bias toward lean, solo-maintainable architecture.
- Start with a single-agent design unless clear constraints justify more.
- Require an evaluation plan even for greenfield builds.
- Prefer explicit system boundaries, permission policy, and workflow state over prompt cleverness.
- Translate ideas into implementation phases, success criteria, and failure tests.
Step 0: Gather Context
Before routing, make sure you have enough to work with.
If the user is asking for a design, confirm you understand:
- what product or system the harness serves
- what actions the agent will take
- who the users are
- any known constraints (solo dev, team, existing stack, timeline)
If the user is asking for an evaluation, you need access to the harness itself:
- read their codebase, CLAUDE.md, settings, skills, hooks, or architecture docs
- if none of that is available, ask what they have and where it lives
- do not evaluate from vibes alone — gather evidence first
If the request is vague ("help me build an agent" or "is my harness any good"), ask one or two clarifying questions before proceeding. Do not stall the conversation with an interview — get enough to pick a mode and start.
Step 1: Classify The Request
Choose one mode before reading reference files.
design
Use when the user is creating a new harness, planning a major rebuild, or asking for architecture, MVP, or implementation sequencing.
Default reads:
references/01-principles-and-solo-dev-defaults.md
references/02-harness-shapes-and-architecture.md
references/08-design-and-build-playbook.md
Add subsystem files only as needed.
evaluation
Use when the user already has a harness and wants gaps, risks, missing primitives, UX upgrades, or architectural cleanup.
Default reads:
references/01-principles-and-solo-dev-defaults.md
references/09-evaluation-and-improvement-playbook.md
Add subsystem files only for the parts under review.
design + evaluation
Use when the user wants a target architecture and a way to verify it, compare it with an existing system, or define acceptance criteria before building.
Default reads:
references/01-principles-and-solo-dev-defaults.md
references/02-harness-shapes-and-architecture.md
references/08-design-and-build-playbook.md
references/09-evaluation-and-improvement-playbook.md
Step 2: Classify The Product Shape
Determine the closest product shape before going deeper:
- code agent
- chat assistant
- workflow orchestrator
- internal copilot
- embedded AI product feature
- hybrid system
If the request is ambiguous, pick the closest shape and state the assumption.
Step 3: Read The Smallest Useful Reference Set
Read these only when the request needs them:
references/01-principles-and-solo-dev-defaults.md
Use first for almost every request. It defines the default decision posture.
references/02-harness-shapes-and-architecture.md
Read when choosing system shape, boundaries, lifecycle, transports, or deployment structure.
references/03-tools-execution-and-permissions.md
Read when the request involves tool registries, tool calling, approval gates, sandboxes, or trust tiers.
references/04-state-sessions-and-durability.md
Read when the request involves sessions, resumability, retries, idempotency, approval waits, or long-running work.
references/05-context-memory-and-evaluation.md
Read when the request involves context windows, retrieval, memory, provenance, evals, replay tests, or regression detection.
references/06-agents-and-extensibility.md
Read when the request involves multi-agent design, plugins, hooks, skills, or extension surfaces.
references/07-ux-observability-and-operations.md
Read when the request involves streaming UX, health checks, logs, analytics, budgets, or supportability.
references/08-design-and-build-playbook.md
Read when the user needs a build-ready plan from idea to implementation.
references/09-evaluation-and-improvement-playbook.md
Read when the user needs findings, missing primitives, upgrade priorities, or acceptance tests.
references/10-example-requests-and-output-patterns.md
Read when you need prompt examples or response structure examples.
references/11-codex-translation-notes.md
Read only when adapting this Anthropic-style skill into a Codex-oriented version or when mapping concepts between the two environments.
Do not rely on reference-to-reference chains. This file is the index.
Operating Rules
- Convert vague ambitions into concrete harness primitives.
- Push back on unnecessary complexity.
- Treat workflow state, permissions, context assembly, and evaluation as first-class architecture, not cleanup tasks.
- Separate universal harness primitives from product-specific manifestation.
- For evaluation requests, present findings first and improvement sequence second.
- For design requests, include how the design will be tested before calling it done.
Output Contract
For design
Return:
- recommended harness shape
- core primitives and subsystem boundaries
- MVP boundary
- phased implementation plan
- verification and acceptance criteria
For evaluation
Return:
- findings ordered by severity or leverage
- missing or weak primitives
- user experience and operational gaps
- prioritized upgrade path
- tests or checks that confirm the fixes
For design + evaluation
Return:
- target architecture
- comparison against current or likely failure modes
- implementation phases
- acceptance criteria
- evaluation plan covering regressions, safety, and UX
Final Check Before Responding
- Did you keep the design lean enough for a solo developer unless the request clearly demanded more?
- Did you avoid recommending multi-agent coordination by default?
- Did you include evaluation, not just construction?
- Did you give the user an operational path forward instead of abstract theory?
1---2name: n-agentic-harnesses-anthropic3description: Design, evaluate, and improve agentic harnesses — the orchestration layer around LLM-powered tools, agents, assistants, copilots, workflow runtimes, and AI-driven product features. Use this skill whenever the user mentions building an agentic system, structuring tool use, adding permissions or approval gates, designing multi-step AI workflows, managing context windows or memory, making agents durable or resumable, evaluating or pressure-testing an existing harness, planning phased implementation for an AI product, reviewing agent architecture, improving agent UX or observability, or asking how to know if their harness is actually good. Also use when the user describes problems that imply harness gaps — like agents doing unexpected things, context getting stale, sessions not surviving crashes, tools running without permission, or costs spiraling — even if they do not use the word "harness."4---56# N Agentic Harnesses For Anthropic78Use this skill as a router for designing, building, and evaluating agentic harnesses.910Read only the files you need. Do not load the entire reference set unless the request genuinely spans multiple subsystems.1112Default posture:1314- Bias toward lean, solo-maintainable architecture.15- Start with a single-agent design unless clear constraints justify more.16- Require an evaluation plan even for greenfield builds.17- Prefer explicit system boundaries, permission policy, and workflow state over prompt cleverness.18- Translate ideas into implementation phases, success criteria, and failure tests.1920## Step 0: Gather Context2122Before routing, make sure you have enough to work with.2324If the user is asking for a **design**, confirm you understand:2526- what product or system the harness serves27- what actions the agent will take28- who the users are29- any known constraints (solo dev, team, existing stack, timeline)3031If the user is asking for an **evaluation**, you need access to the harness itself:3233- read their codebase, CLAUDE.md, settings, skills, hooks, or architecture docs34- if none of that is available, ask what they have and where it lives35- do not evaluate from vibes alone — gather evidence first3637If the request is vague ("help me build an agent" or "is my harness any good"), ask one or two clarifying questions before proceeding. Do not stall the conversation with an interview — get enough to pick a mode and start.3839## Step 1: Classify The Request4041Choose one mode before reading reference files.4243### `design`4445Use when the user is creating a new harness, planning a major rebuild, or asking for architecture, MVP, or implementation sequencing.4647Default reads:4849- `references/01-principles-and-solo-dev-defaults.md`50- `references/02-harness-shapes-and-architecture.md`51- `references/08-design-and-build-playbook.md`5253Add subsystem files only as needed.5455### `evaluation`5657Use when the user already has a harness and wants gaps, risks, missing primitives, UX upgrades, or architectural cleanup.5859Default reads:6061- `references/01-principles-and-solo-dev-defaults.md`62- `references/09-evaluation-and-improvement-playbook.md`6364Add subsystem files only for the parts under review.6566### `design + evaluation`6768Use when the user wants a target architecture and a way to verify it, compare it with an existing system, or define acceptance criteria before building.6970Default reads:7172- `references/01-principles-and-solo-dev-defaults.md`73- `references/02-harness-shapes-and-architecture.md`74- `references/08-design-and-build-playbook.md`75- `references/09-evaluation-and-improvement-playbook.md`7677## Step 2: Classify The Product Shape7879Determine the closest product shape before going deeper:8081- code agent82- chat assistant83- workflow orchestrator84- internal copilot85- embedded AI product feature86- hybrid system8788If the request is ambiguous, pick the closest shape and state the assumption.8990## Step 3: Read The Smallest Useful Reference Set9192Read these only when the request needs them:9394- `references/01-principles-and-solo-dev-defaults.md`95 Use first for almost every request. It defines the default decision posture.96- `references/02-harness-shapes-and-architecture.md`97 Read when choosing system shape, boundaries, lifecycle, transports, or deployment structure.98- `references/03-tools-execution-and-permissions.md`99 Read when the request involves tool registries, tool calling, approval gates, sandboxes, or trust tiers.100- `references/04-state-sessions-and-durability.md`101 Read when the request involves sessions, resumability, retries, idempotency, approval waits, or long-running work.102- `references/05-context-memory-and-evaluation.md`103 Read when the request involves context windows, retrieval, memory, provenance, evals, replay tests, or regression detection.104- `references/06-agents-and-extensibility.md`105 Read when the request involves multi-agent design, plugins, hooks, skills, or extension surfaces.106- `references/07-ux-observability-and-operations.md`107 Read when the request involves streaming UX, health checks, logs, analytics, budgets, or supportability.108- `references/08-design-and-build-playbook.md`109 Read when the user needs a build-ready plan from idea to implementation.110- `references/09-evaluation-and-improvement-playbook.md`111 Read when the user needs findings, missing primitives, upgrade priorities, or acceptance tests.112- `references/10-example-requests-and-output-patterns.md`113 Read when you need prompt examples or response structure examples.114- `references/11-codex-translation-notes.md`115 Read only when adapting this Anthropic-style skill into a Codex-oriented version or when mapping concepts between the two environments.116117Do not rely on reference-to-reference chains. This file is the index.118119## Operating Rules120121- Convert vague ambitions into concrete harness primitives.122- Push back on unnecessary complexity.123- Treat workflow state, permissions, context assembly, and evaluation as first-class architecture, not cleanup tasks.124- Separate universal harness primitives from product-specific manifestation.125- For evaluation requests, present findings first and improvement sequence second.126- For design requests, include how the design will be tested before calling it done.127128## Output Contract129130### For `design`131132Return:133134- recommended harness shape135- core primitives and subsystem boundaries136- MVP boundary137- phased implementation plan138- verification and acceptance criteria139140### For `evaluation`141142Return:143144- findings ordered by severity or leverage145- missing or weak primitives146- user experience and operational gaps147- prioritized upgrade path148- tests or checks that confirm the fixes149150### For `design + evaluation`151152Return:153154- target architecture155- comparison against current or likely failure modes156- implementation phases157- acceptance criteria158- evaluation plan covering regressions, safety, and UX159160## Final Check Before Responding161162- Did you keep the design lean enough for a solo developer unless the request clearly demanded more?163- Did you avoid recommending multi-agent coordination by default?164- Did you include evaluation, not just construction?165- Did you give the user an operational path forward instead of abstract theory?