{"id":49527436,"url":"https://github.com/mheadd/my-agent-team","last_synced_at":"2026-05-02T04:02:21.022Z","repository":{"id":353130172,"uuid":"1197595243","full_name":"mheadd/my-agent-team","owner":"mheadd","description":"An agent chain to take a software specification from planning to pull request","archived":false,"fork":false,"pushed_at":"2026-04-22T15:55:25.000Z","size":221,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"main","last_synced_at":"2026-04-22T16:34:02.215Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"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/mheadd.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":"AGENTS.md","dco":null,"cla":null}},"created_at":"2026-03-31T17:57:05.000Z","updated_at":"2026-04-22T15:55:28.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/mheadd/my-agent-team","commit_stats":null,"previous_names":["mheadd/my-agent-team"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/mheadd/my-agent-team","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mheadd%2Fmy-agent-team","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mheadd%2Fmy-agent-team/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mheadd%2Fmy-agent-team/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mheadd%2Fmy-agent-team/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mheadd","download_url":"https://codeload.github.com/mheadd/my-agent-team/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mheadd%2Fmy-agent-team/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":32522252,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-02T01:12:54.858Z","status":"online","status_checked_at":"2026-05-02T02:00:05.923Z","response_time":132,"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":[],"created_at":"2026-05-02T04:02:19.988Z","updated_at":"2026-05-02T04:02:21.014Z","avatar_url":"https://github.com/mheadd.png","language":null,"funding_links":[],"categories":[],"sub_categories":[],"readme":"# My Agent Team\n\nA four-agent chain that takes a software specification from planning to pull request. An **Orchestrator** governs the workflow, a **Builder** writes the code, a **Reviewer** evaluates it, and a **Shipper** prepares the PR.\n\n## Setup\n\nCopy the contents of this repository into your own project, placing files in the matching directory structure:\n\n- `.github/agents/` — Agent definitions (orchestrator, builder, reviewer, shipper)\n- `.github/instructions/` — Instruction files referenced by agents\n- `.github/skills/` — Skill definitions for specialized tasks (ADR writing, changelog updates, PR writing)\n- `docs/adr/` — Directory for Architecture Decision Records\n- `AGENTS.md` — Top-level conventions shared across all agents\n\nThe agent and skill files use relative references, so the directory structure must be preserved.\n\nThis repo comes with agent definitions in `.github/agents/` - you can supplement the behavior of the agents by adding relevant instructions and skills files in `.github/instructions/` and `.github/skills/` respectively.\n\n## How It Works\n\n1. Start with the **Orchestrator** — it reviews the spec for ambiguity, declares scope, and drives the process.\n2. The Orchestrator runs the **Builder** as a subagent to implement the spec.\n3. The Orchestrator runs the **Reviewer** as a subagent to evaluate the output (PASS or FAIL).\n4. On PASS, the Orchestrator runs the **Shipper** as a subagent to prepare the pull request.\n\nThe chain includes human checkpoints for spec clarification and architectural decisions. See [AGENTS.md](AGENTS.md) for full details on conventions and agent behavior.\n\n## Usage\n\nThe Orchestrator uses VS Code's [subagent pattern](https://code.visualstudio.com/docs/copilot/agents/subagents) to invoke the Builder, Reviewer, and Shipper automatically — no manual switching required. Only the Orchestrator appears in the agent picker; the other agents run as subagents within the Orchestrator's session.\n\n### VS Code\n\nSelect **Orchestrator** from the agent picker and give it a spec:\n\n![Selecting the Orchestrator from the VS Code agent picker](agent-picker.png)\n\n```\nImplement the spec in docs/specs/user-registration.md\n```\n\nThe Orchestrator reviews the spec for ambiguity, asks clarifying questions, then automatically drives the Builder → Reviewer → Shipper chain. You'll see each subagent appear as a collapsible tool call in the chat — expand to view details.\n\nYou can also point it at an issue or inline requirements:\n\n```\nImplement the requirements in issue #42\n```\n\n### Copilot CLI\n\nYou can also run the Orchestrator from the [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/create-custom-agents-for-cli). In interactive mode, type `/agent` to see available agents:\n\n![Selecting a custom agent in the Copilot CLI](agent-picker-cli.png)\n\nSelect **Orchestrator** from the list. The CLI confirms the active agent and you can enter your prompt:\n\n![The Orchestrator agent selected and active in the Copilot CLI](select-orchestrator.png)\n\nYou can also invoke it directly from the command line:\n\n```\ncopilot --agent orchestrator --prompt \"Implement the spec in docs/specs/user-registration.md\"\n```\n\n\u003e **⚠️ Experimental:** The subagent pattern used by the Orchestrator (the `agents` frontmatter field) is not yet fully supported in the Copilot CLI. The CLI will load the Orchestrator as a custom agent, but may report warnings about unknown fields. The agents will still run, but this integration should be considered experimental.\n\n### Human checkpoints\n\nThe chain pauses for your input at three points:\n\n1. **Spec ambiguity** — before work begins, if the Orchestrator finds requirement-level gaps.\n2. **Branch confirmation** — before the Builder starts, verifying the active branch is correct.\n3. **ADR confirmation** — before the Shipper runs, if a major architectural decision was made.\n\n### If the build loop fails\n\nIf the Reviewer returns FAIL, the Orchestrator re-runs the Builder with the issue list. After two consecutive failures on the same issues, it escalates to you for guidance.\n\n\u003e **Note:** Always start with the Orchestrator. The Builder, Reviewer, and Shipper are not directly selectable — they run only as subagents of the Orchestrator.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmheadd%2Fmy-agent-team","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmheadd%2Fmy-agent-team","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmheadd%2Fmy-agent-team/lists"}