Skip to content

armgit / ECC

Public Imported from GitHub
0

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

docs: correct github copilot support status for copilot cli

Brian Swiger0d6dde0d1f35
diff --git a/README.md b/README.md
index 00d3a8ca7..564199491 100644
--- a/README.md
+++ b/README.md
@@ -341,7 +341,7 @@ cd ECC
| CodeBuddy | `./install.sh --profile minimal --target codebuddy` | Project-local `.codebuddy/` install |
| JoyCode | `./install.sh --profile minimal --target joycode` | Project-local `.joycode/` install |
-GitHub Copilot support is already included in this repository. `.github/copilot-instructions.md` provides the instruction layer, `.github/prompts/` contains the reusable `/plan`, `/tdd`, `/security-review`, `/build-fix`, and `/refactor` prompts, and `.vscode/settings.json` enables `chat.promptFiles`.
+GitHub Copilot support is already included in this repository. `.github/copilot-instructions.md` provides the instruction layer, `.github/prompts/` contains the reusable `/plan`, `/tdd`, `/security-review`, `/build-fix`, and `/refactor` prompts, and `.vscode/settings.json` enables `chat.promptFiles`. GitHub Copilot CLI additionally discovers the `.agents/skills/` subset from a plain clone with no setup; see [Platform Support](#platform-support) for the full catalog and agents.
For a harness without a native ECC target, use the [manual adaptation guide](docs/MANUAL-ADAPTATION-GUIDE.md). It explains how to carry a small set of ECC skills and workflow instructions into chat-style tools without pretending hooks or native skill discovery are available.
@@ -1588,7 +1588,7 @@ See [affaan-m/ECC#2065](https://github.com/affaan-m/ECC/issues/2065).
| Codex | Supported native plugin | Codex marketplace plugin or repo config | Native hooks require an explicit trust decision and do not use Claude's hook profiles. The legacy sync is compatibility-only. |
| Cursor | Beta project adapter | Selective installer into `.cursor/` | Agent discovery varies by Cursor build, and ECC's installer paths do not yet expose identical hook sets ([#2419](https://github.com/affaan-m/ECC/issues/2419)). |
| OpenCode | Beta built plugin | Build plugin, then selective installer | ECC ships a subset of the catalog; connect a provider and select a model in OpenCode ([#2617](https://github.com/affaan-m/ECC/issues/2617)). |
-| GitHub Copilot | Instruction-only | Checked-in instructions and prompt files | No ECC hooks, runtime agents, delegation, or native skill discovery. |
+| GitHub Copilot | Instructions, prompts, and native skill/agent discovery (Copilot CLI) | Checked-in instructions and prompt files; skills and agents are discovered by Copilot CLI from existing paths | ECC's hook automations do not run. There is no `copilot` installer target, so placing the full skill and agent catalog is a manual step. |
| Gemini, Zed, Antigravity, Qwen, Hermes, OpenClaw, Kimi, CodeBuddy, JoyCode | Experimental/minimal adapters | Harness-specific selective target | File placement and instruction portability are tested; full Claude feature parity is not claimed. |
### Cross-tool capability map
@@ -1596,16 +1596,16 @@ See [affaan-m/ECC#2065](https://github.com/affaan-m/ECC/issues/2065).
| Capability | Claude Code | Codex | Cursor | OpenCode | GitHub Copilot |
|---|---|---|---|---|---|
| Instructions | Native | Native `AGENTS.md` | Project rules | Plugin instructions | Native instruction file |
-| Skills | Native installed set | Native plugin set | Build-dependent/project set | Built subset | Prompt/instruction references only |
-| Agents/delegation | Native agents | Codex multi-agent roles; Claude agent files are not installed as roles | Build-dependent project agents | Plugin agents | Not supported |
-| ECC hooks | Native plugin hooks | Native reviewed subset with explicit trust | Cursor hook adapter; install-path differences remain | Plugin events | Not supported |
+| Skills | Native installed set | Native plugin set | Build-dependent/project set | Built subset | Native discovery (Copilot CLI) from `.github/skills/`, `.agents/skills/`, `.claude/skills/` |
+| Agents/delegation | Native agents | Codex multi-agent roles; Claude agent files are not installed as roles | Build-dependent project agents | Plugin agents | Copilot CLI custom agents via `.github/agents/` and `--agent` |
+| ECC hooks | Native plugin hooks | Native reviewed subset with explicit trust | Cursor hook adapter; install-path differences remain | Plugin events | Not ported; Copilot CLI has its own plugin hook system |
| MCP configuration | Available, explicit activation | Native plugin manifest; legacy sync can merge TOML | Explicit project/user config | Provider/plugin config | Not supplied by ECC |
-| Parity with Claude Code | Primary reference | Partial | Partial | Partial | Not a parity target |
+| Parity with Claude Code | Primary reference | Partial | Partial | Partial | Partial |
**Key architectural decisions:**
- **AGENTS.md** at root is the universal cross-tool file (read by Claude Code, Cursor, Codex, and OpenCode; GitHub Copilot uses `.github/copilot-instructions.md` instead)
- **DRY adapter pattern** lets Cursor reuse Claude Code's hook scripts without duplication
-- **Skills format** (SKILL.md with YAML frontmatter) works across Claude Code, Codex, and OpenCode
+- **Skills format** (SKILL.md with YAML frontmatter) works across Claude Code, Codex, OpenCode, and GitHub Copilot CLI
- Codex's narrower native hook set is supplemented by `AGENTS.md`, optional `model_instructions_file` overrides, and sandbox permissions
<details>
@@ -1845,7 +1845,7 @@ For the full ECC OpenCode setup, either:
<details>
<summary><strong>GitHub Copilot support in depth</strong></summary>
-ECC provides **GitHub Copilot support** for VS Code via Copilot Chat's native instruction and prompt file system. No extra tooling required.
+ECC supports **GitHub Copilot** on two surfaces: Copilot Chat in VS Code, via its native instruction and prompt file system, and **GitHub Copilot CLI**, which discovers ECC's skills and agents from paths this repository already ships. No extra tooling is required for either.
#### What's included for GitHub Copilot
@@ -1866,6 +1866,45 @@ To use the workflow prompts in Copilot Chat:
2. Click the **paperclip / attach** icon and select **Prompt...**, or type `/` and choose a prompt.
3. Select the prompt (e.g. `plan`, `tdd`, `security-review`).
+#### Copilot CLI: skills and agents
+
+GitHub Copilot CLI discovers `SKILL.md` skills from `.github/skills/`,
+`.agents/skills/`, `.claude/skills/`, `~/.copilot/skills/`, and
+`~/.agents/skills/`, and custom agents from `.github/agents/`. ECC's skill and
+agent frontmatter (`name`, `description`) is already compatible, so no
+conversion step is needed.
+
+Because ECC ships a skill subset in `.agents/skills/`, a plain clone of this
+repository is picked up by Copilot CLI with no configuration at all:
+
+```bash
+git clone https://github.com/affaan-m/ECC.git && cd ECC
+copilot skill list
+# 42 project skills: 39 from .agents/skills/, 3 from .claude/commands/
+```
+
+To expose the full catalog, place `skills/` where Copilot CLI looks:
+
+```bash
+cp -r skills .github/skills # or: copilot skill add ./skills
+copilot skill list --json | jq '[.[] | select(.source=="project")] | length'
+# 286
+```
+
+Agents work the same way:
+
+```bash
+cp -r agents .github/agents
+copilot --agent architect -p "Review this module's boundaries"
+```
+
+Verified against Copilot CLI 1.0.83. All 286 skills load and report
+`enabled: true`. Agents load and run; agent files that declare a Claude model
+name (`model: opus`, `model: sonnet`) emit a warning and fall back to the
+session's default model, so remove or remap `model:` if you want to pin one.
+
+There is no `copilot` target in `install.sh` yet — the steps above are manual.
+
#### Feature coverage
| ECC Feature | Copilot equivalent |
@@ -1878,12 +1917,24 @@ To use the workflow prompts in Copilot Chat:
| Build error resolution | `build-fix` prompt |
| Refactoring | `refactor` prompt |
| Commit message format | Per-task instruction in `settings.json` |
-| Hooks / automation | Not supported (Copilot has no hook system) |
-| Agents / delegation | Not supported (Copilot has no subagent API) |
+| Skills | Native discovery in Copilot CLI (`.github/skills/`, `.agents/skills/`) |
+| Agents / delegation | Copilot CLI custom agents (`.github/agents/`, `--agent`) |
+| Hooks / automation | ECC's hooks are not ported (Copilot CLI has its own plugin hook system) |
#### Limitations
-GitHub Copilot does not have a hook system or a subagent API, so ECC's hook automations (auto-format, TypeScript check, session persistence, dev-server guard) and agent delegation are unavailable. The instruction and prompt layer still brings the full ECC coding philosophy (standards, security, TDD, and workflow) into every Copilot Chat session.
+ECC's hook automations (auto-format, TypeScript check, session persistence,
+dev-server guard) are written against Claude Code's hook event model and are
+not ported to Copilot. Copilot CLI does expose a hook system through its plugin
+format, but ECC does not currently ship a Copilot plugin, so none of ECC's hooks
+run there.
+
+ECC also does not install a `copilot` target, so skill and agent placement is
+manual (see above). Skills that shell out to bundled scripts assume the same
+interpreters as on Claude Code. Copilot Chat in VS Code does not read
+`.github/skills/` or `.github/agents/`; those paths are Copilot CLI surfaces.
+The instruction and prompt layer is what carries ECC's coding philosophy into
+Copilot Chat sessions.
</details>
<details>
@@ -2108,7 +2159,7 @@ Yes. ECC is cross-platform:
- **Gemini CLI**: Experimental project-local support via `.gemini/GEMINI.md` and shared installer plumbing.
- **OpenCode**: Beta plugin integration in `.opencode/`; models follow the user's OpenCode selection, while catalog parity remains limited.
- **Codex**: Supported native marketplace plugin for the app and CLI, plus repo-local configuration. The older sync flow remains available only for compatibility.
-- **GitHub Copilot (VS Code)**: Instruction and prompt layer via `.github/copilot-instructions.md`, `.vscode/settings.json`, and `.github/prompts/`.
+- **GitHub Copilot**: Instruction and prompt layer for Copilot Chat via `.github/copilot-instructions.md`, `.vscode/settings.json`, and `.github/prompts/`. Copilot CLI additionally discovers ECC skills (`.agents/skills/`, `.github/skills/`) and custom agents (`.github/agents/`).
- **Antigravity**: Native Antigravity 2.0 setup for workflows, skills, custom agents, and flattened rules in `.agents/`. See [Antigravity Guide](docs/ANTIGRAVITY-GUIDE.md).
- **JoyCode / CodeBuddy**: Project-local selective install adapters for commands, agents, skills, and flattened rules. See [JoyCode Adapter Guide](docs/JOYCODE-GUIDE.md).
- **Qwen CLI**: Home-directory selective install adapter for commands, agents, skills, rules, and Qwen config. See [Qwen CLI Adapter Guide](docs/QWEN-GUIDE.md).