agent-harness-construction
Design and optimize AI agent action spaces, tool definitions, and observation formatting for higher completion rates.
- Action space quality depends on stable tool names, narrow input schemas, deterministic outputs, and avoiding catch-all tools; granularity should match operation risk (micro-tools for high-risk, macro-tools only when round-trip cost dominates.
- Observation design requires every tool response to include status, summary, next_actions, and artifacts; error paths must provide root cause hints, safe retry instructions, and explicit stop conditions.
- Context budgeting keeps system prompts minimal, moves large guidance into on-demand skills, and prefers file references over inlining; compaction happens at phase boundaries, not arbitrary token thresholds.
- Recommends hybrid architecture combining ReAct planning with typed tool execution; track completion rate, retries per task, pass@1/pass@3, and cost per successful task to measure effectiveness.
Agent Harness Construction
Use this skill when you are improving how an agent plans, calls tools, recovers from errors, and converges on completion.
Core Model
Agent output quality is constrained by:
- Action space quality
- Observation quality
- Recovery quality
- Context budget quality
Action Space Design
- Use stable, explicit tool names.
- Keep inputs schema-first and narrow.
- Return deterministic output shapes.
- Avoid catch-all tools unless isolation is impossible.
More from affaan-m/everything-claude-code
security-review
Use this skill when adding authentication, handling user input, working with secrets, creating API endpoints, or implementing payment/sensitive features. Provides comprehensive security checklist and patterns.
7.9Kgolang-patterns
Idiomatic Go patterns, best practices, and conventions for building robust, efficient, and maintainable Go applications.
7.5Kcoding-standards
Baseline cross-project coding conventions for naming, readability, immutability, and code-quality review. Use detailed frontend or backend skills for framework-specific patterns.
6.7Kfrontend-patterns
Frontend development patterns for React, Next.js, state management, performance optimization, and UI best practices.
6.7Kbackend-patterns
Backend architecture patterns, API design, database optimization, and server-side best practices for Node.js, Express, and Next.js API routes.
6.6Kgolang-testing
Go testing patterns including table-driven tests, subtests, benchmarks, fuzzing, and test coverage. Follows TDD methodology with idiomatic Go practices.
6.1K