{"id":50512534,"url":"https://github.com/duck-lint/coding-agent-harness","last_synced_at":"2026-06-02T21:03:42.679Z","repository":{"id":357406136,"uuid":"1234727227","full_name":"duck-lint/coding-agent-harness","owner":"duck-lint","description":"This harness prevents common failure modes with iterative AI-assisted coding. Especially helpful for users with no formal coding language syntax experience.","archived":false,"fork":false,"pushed_at":"2026-05-30T18:26:40.000Z","size":268,"stargazers_count":2,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-05-30T19:13:44.344Z","etag":null,"topics":["ai-assisted-development","coordination","harness-engineering","harness-framework","sub-agents"],"latest_commit_sha":null,"homepage":"https://youtu.be/XiF06_yM488?si=Pxh8pqdHvqghgJdO","language":null,"has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/duck-lint.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-05-10T15:07:16.000Z","updated_at":"2026-05-30T18:26:44.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/duck-lint/coding-agent-harness","commit_stats":null,"previous_names":["duck-lint/agent-harness","duck-lint/coding-agent-harness"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/duck-lint/coding-agent-harness","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duck-lint%2Fcoding-agent-harness","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duck-lint%2Fcoding-agent-harness/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duck-lint%2Fcoding-agent-harness/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duck-lint%2Fcoding-agent-harness/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/duck-lint","download_url":"https://codeload.github.com/duck-lint/coding-agent-harness/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/duck-lint%2Fcoding-agent-harness/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":33835766,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-02T02:00:07.132Z","response_time":109,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["ai-assisted-development","coordination","harness-engineering","harness-framework","sub-agents"],"created_at":"2026-06-02T21:03:42.554Z","updated_at":"2026-06-02T21:03:42.668Z","avatar_url":"https://github.com/duck-lint.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# Coding Agent Harness Template\n\nThis repo packages a lightweight external cognition harness for Codex-driven coding work.\n\nIt contains:\n- `AGENTS.md`: always-on orchestrator guidance for the user-facing chat\n- `harness-skills/project-manager/`: advisory skill for strict admissibility and project trajectory reports\n- `harness-skills/decision-matrix/`: first-class decision aid for structured option comparison\n- `harness-skills/seed-repo/`: skill and script for seeding a target repo with `harness/`\n- `subagents/`: distributable TOML templates for the project-manager advisory role plus planner, implementer, reviewer, adversary, and archivist roles\n\n## Architecture\n\nThe root orchestrator owns the user conversation and role routing. The project-manager skill is advisory: it produces strict reports about admissibility, thesis/tension, approval boundaries, affected surfaces, and next admissible transitions. The subagents execute bounded jobs inside their own authority.\n\nThis keeps the UX in one chat while preserving separate context and purpose:\n- root `AGENTS.md` handles conversation and orchestration\n- `$project-manager` handles project direction and admissibility review\n- `decision-matrix` handles structured comparison when the user needs to choose among several options\n- installed subagents handle project-direction review, planning, implementation, review, adversarial checks, and archival memory\n- `$seed-repo` installs repo-local harness memory into target projects\n\n## Seeding A Repo\n\nUse the seed skill script from this repo:\n\n```powershell\npython .\\harness-skills\\seed-repo\\scripts\\seed-repo.py --target C:\\path\\to\\target-repo\n```\n\nThe script copies:\n\n```text\nharness-skills/seed-repo/assets/repo-harness-template/repo-harness/\n```\n\ninto:\n\n```text\n\u003ctarget-repo\u003e/harness/\n```\n\nIt aborts if `\u003ctarget-repo\u003e/harness/` already exists unless `--force` is explicitly supplied.\n\n## Subagent Installation\n\nThe TOML files under `subagents/` are install templates. To let the root orchestrator spawn these roles, install them into:\n\n```text\n~/.codex/agents/\n```\n\nThe seed script can do this with:\n\n```powershell\npython .\\harness-skills\\seed-repo\\scripts\\seed-repo.py --target C:\\path\\to\\target-repo --install-subagents\n```\n\nInstalling subagents changes user-global Codex config. The orchestrator or seed skill must ask for explicit approval before running that option.\n\n## Seeded Harness Layout\n\n```text\nharness/\n  README.md\n  harness-runtime.md\n  sub-agents.md\n  archive-policy.md\n  known-failures.md\n  open-decisions.md\n  canon/\n    type-system-operational.md\n    bridge-schema.md\n  implementation-projects/\n    active/\n    archive/\n    templates/\n      implementation-plan-template.md\n      implementation-tracker-template.md\n  project-spec/\n    template-governance-primitives.md\n    template-project-spec.md\n```\n\n`harness/` is the canonical repo-local continuity store. Do not duplicate project state in repo-root `memories/`, host memory files, or chat-only summaries.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fduck-lint%2Fcoding-agent-harness","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fduck-lint%2Fcoding-agent-harness","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fduck-lint%2Fcoding-agent-harness/lists"}