Skip to content

MKuckert/agent-harness

Repository files navigation

Agentic Harness

Agents

Agent Description
Planner Strategic software architect that interrogates requirements, consults Explorer & Librarian, and produces a structured PLAN.md before any code is written.
Builder Software developer that implements tasks defined in PLAN.md one at a time, validates with linters/tests, and triggers the Committer after each unit.
Reviewer Senior critic and sole authority to mark tasks [x] in PLAN.md; reviews both the plan (Mode 1) and the implementation (Mode 2) for correctness, security, and plan compliance.
Committer Specialized Git sub-agent that stages and commits changes using Conventional Commits; triggered by the Builder after every successful change.
Explorer Read-only code analyst that maps the existing codebase, identifies entry points and dependencies, and reports precise findings to Planner and Builder.
Librarian Information specialist that fetches external documentation, API references, and best practices from the web and synthesizes them for Planner and Builder.
Chronicler Knowledge manager and evolution specialist that writes post-mortems, rescues stalled processes, archives PLAN.md, and proposes harness improvements.
Dreamer Metacognitive consolidator that audits AGENTS.md and archived plans for redundancies and inconsistencies, then proposes and applies structural improvements after user confirmation.
Testing Minimal agent used to test and validate the agent harness and its environment.

Tool Permissions by Agent Role

Agent context7 fetch git filesystem filesystem
(readonly)
search
🧠 Planner ☑️ (PLAN.md only)
🧠 Builder ☑️
🧠 Chronicler ☑️ ☑️ ☑️
⚙️ Reviewer ☑️
⚙️ Committer ☑️ ☑️
⚙️ Explorer ☑️
⚙️ Librarian ☑️ ☑️ ☑️
⚙️ Testing ☑️
  • 🧠: Primary agent — can spawn sub-agents
  • ⚙️: Sub-agent

Setup

brew bundle
bin/build-docker-mcp.sh
docker mcp feature enable profiles
docker mcp feature disable dynamic-tools
echo "export DOCKER_MCP_IN_CONTAINER=1" >> ~/.bash_profile
docker mcp catalog pull mcp/docker-mcp-catalog:latest

For full setup, profile management, and server configuration see docs/mcp/SETUP.md.

MCP Reference

  • Servers — available MCP servers and their sources
  • Tools — full tool catalogue with signatures and descriptions

About

My own attempt to create an opencode ai agent harness

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors