best-copilot

best-copilot

English | Simplified Chinese | Korean | Japanese

best-copilot is an installable agent-team workflow for serious engineering work in Codex, Copilot CLI, and Claude Code. It gives a repository a senior delivery flow: initialize facts, freeze scope, design before building, implement through specialist roles, review independently, verify with evidence, and preserve a resume point for the next session.

Codex uses .codex-plugin/plugin.json, .agents/plugins/marketplace.json, .agents/skills -> ../skills, and .codex/agents/*.toml. Copilot CLI uses root agents/ and skills/ through plugin.json. Claude Code uses the claude-plugin/ package: claude-plugin/.claude-plugin/plugin.json, claude-plugin/skills -> ../skills, and claude-plugin/agents -> ../claude-agents. Repository-level rules live in .github/instructions/**.

Why It Exists

Large AI coding tasks fail when they jump straight from a vague request to a patch. best-copilot adds the missing delivery discipline:

• One senior entry point: Senior Project Expert owns intent, scope, dispatch, fan-in, closeout, and reusable reflection/memory/policy signals.
• Eight specialist agents: planning, architecture, implementation, frontend, QA, security, root-cause fixing, and specification work have separate ownership.
• Thirty-nine skills: role workflows, bootstrap, search, planning, workspace isolation, TDD, design review, execution, Java/Python coding guidelines, verification, branch closeout, frontend audit, workflow evolution, and a Senior Project Expert compatibility entrypoint are installable skills.
• Target-local memory and spec: installed projects keep facts, workstreams, memory, and specs inside the target repository, not in the plugin package.
• Evidence-first closure: "done" requires command output, static checks, browser evidence, or an explicit blocker.

Install

Codex

Codex supports plugins as installable bundles for reusable skills, apps, and MCP config. Add this repository as a Codex marketplace, then install the plugin from the Codex plugin directory:

codex plugin marketplace add funky-eyes/best-copilot
codex plugin add best-copilot@best-copilot

For local development from this checkout:

codex plugin marketplace add /absolute/path/to/best-copilot
codex plugin add best-copilot@best-copilot

Codex discovers:

• plugin metadata from .codex-plugin/plugin.json
• local/repo marketplace metadata from .agents/plugins/marketplace.json
• marketplace plugin source from plugins/best-copilot, a real Codex plugin package whose skills folder links to the shared root skills/
• shared skills from skills/ through the plugin manifest, visible on the installed plugin details page
• direct repo-scoped shared skills through .agents/skills, which is the path that makes these skills appear in the normal $ skill selector when working from this checkout
• Codex custom agents from .codex/agents when working from this checkout, after copying that adapter directory into a target repo, or after repo-init-scan runs with Codex compatibility

After installing or editing the plugin, start a new Codex thread/session. Use @best-copilot when you want this workflow from the installed plugin. If you want the individual workflow skills to appear in the normal $ skill selector, expose them through a repo or user skill location such as .agents/skills or ~/.agents/skills.

Codex subagents are configured separately from plugins. The Copilot agents/*.agent.md files and Claude claude-agents/*.md adapters do not become Codex custom agents after plugin installation, so this repository also ships native Codex TOML adapters under .codex/agents. For target repositories, the init helper creates AGENTS.md and the same eight .codex/agents/*.toml adapters when Codex compatibility is requested.

Copilot CLI

Register this repository as a Copilot CLI plugin marketplace:

copilot plugin marketplace add funky-eyes/best-copilot

Install from the registered marketplace: