@jaybeeuu/agent-cortex 1.43.0 → 2.0.0

package/.agents/skills/style-versioning/SKILL.md

@@ -82,7 +82,7 @@ changeset to make it green.
 The `release` job in `.github/workflows/ci.yml` handles everything automatically:
 
 1. **Detects new changesets** on main
-2. **Creates a "Version Packages" PR** — the `version` step runs `pnpm version-packages`, which bumps `package.json`, syncs `plugin.json` (via `scripts/sync-plugin-version.sh`), updates `CHANGELOG.md`, and regenerates the committed Copilot output (`pnpm build:copilot`; the Claude plugin is materialised at install time with the package version, so it has no committed output to regenerate) so the drift gates never fail on a version bump
+2. **Creates a "Version Packages" PR** — the `version` step runs `pnpm version-packages` (`changeset version`), which bumps `package.json` and rewrites `CHANGELOG.md`. That is the whole release surface: every plugin this package ships is materialised at install time with the package version, so there is no generated output to regenerate and no drift gates to satisfy on a version bump
 3. **When "Version Packages" is merged**:
    - Creates a git tag
    - Publishes to npm — `pnpm publish-package` packs with `pnpm pack` and publishes with `npm publish --provenance --access public`. Authenticates via npm Trusted Publishing (OIDC): the release job's `id-token` permission lets npm exchange a GitHub OIDC token for a short-lived npm token at publish time, so no `NPM_TOKEN` secret or `.npmrc` auth config is required — only the one-time npm-side Trusted Publishing setup on npmjs.com (package → Access → Trusted Publishing → GitHub repo `jaybeeuu/agent-cortex` + workflow `.github/workflows/ci.yml`)
@@ -141,18 +141,17 @@ human-only follow-ups, including the merge probe that closes AC1.
 
 ### Version lockstep
 
-All version numbers stay in lockstep automatically:
+Two files carry the version, in lockstep automatically:
 
 1. `package.json` → bumped by changesets
-2. `plugin.json` → synced by `scripts/sync-plugin-version.sh`
-3. `CHANGELOG.md` → generated by changesets
+2. `CHANGELOG.md` → generated by changesets
 
 **Never bump versions manually.** Always create a changeset file.
 
 ## Common mistakes
 
 - **Running `pnpm changeset`**: Interactive, wastes tokens. Write the file directly.
-- **Bumping versions manually**: Don't touch `"version"` in `package.json` or `plugin.json`. Create a changeset.
+- **Bumping versions manually**: Don't touch `"version"` in `package.json`. Create a changeset.
 - **Omitting the changeset**: CI fails the PR. Publishing is the default; the only
   opt-out is the `no-publish` label, which must already exist in the repo's settings.
 - **Wrong bump type**: `patch` for fixes, `minor` for additions, `major` for breakage. When in doubt, ask the user.
@@ -170,4 +169,4 @@ All version numbers stay in lockstep automatically:
 | Agent bumps versions locally | Agent writes a changeset file |
 | Manual GitHub release creation | Automated by the `release` job in `ci.yml` |
 | `publish.yml` triggered by release | `ci.yml` release job on push to main |
-| Version sync was manual | `sync-plugin-version.sh` runs automatically |
+| Version files synced by hand | changesets bumps `package.json` + `CHANGELOG.md` |

package/.github/workflows/ci.yml

@@ -220,11 +220,6 @@ jobs:
           PLUGIN_VERSION=$(node -p "require('$OUT/.claude-plugin/plugin.json').version")
           test "$PKG_VERSION" = "$PLUGIN_VERSION"
 
-      - name: Check generated Copilot agent files are up to date
-        run: |
-          pnpm build:copilot
-          git diff --exit-code -- 'agents/*.agent.md'
-
   release:
     name: Release
     needs: [lint, test, claude-plugin-check]
@@ -288,12 +283,10 @@ jobs:
           # changesets/action execs these inputs via @actions/exec with NO shell:
           # the string is split by argStringToArray on whitespace (single quotes
           # survive literally), so each must be a single unquoted command token
-          # that runs a pnpm script. version-packages bumps versions, syncs
-          # plugin.json, THEN regenerates the committed Copilot output
-          # (build:copilot re-derives agents/*.agent.md; the Claude plugin is
-          # materialised at install time with the package version, so nothing
-          # committed needs regenerating) before the action commits, so the
-          # Version Packages PR always passes the drift gates.
+          # that runs a pnpm script. version-packages bumps the package version
+          # and rewrites CHANGELOG.md, and nothing else is committed: the Claude
+          # plugin is materialised at install time with the package version, so
+          # there is no committed output to regenerate.
           version: pnpm version-packages
           # pnpm publish-package when the merged PR is unlabelled, pnpm
           # publish-noop when it carries `no-publish`.

package/AGENTS.md

@@ -4,20 +4,17 @@ Instructions for agents working on this repository.
 
 ## What This Repo Is
 
-A personal Copilot CLI plugin containing custom agents and skills, shipped to Copilot, pi,
-and Claude Code, plus PI extensions and Claude hooks for enhancing the coding agent
-runtime. Changes here affect the behaviour of every agent, skill, and PI extension
-available in the author's coding sessions.
+A personal collection of custom agents and skills, shipped to pi and Claude Code, plus PI
+extensions and Claude hooks for enhancing the coding agent runtime. Changes here affect the
+behaviour of every agent, skill, and PI extension available in the author's coding sessions.
 
 ## Structure
 
 ```
 agent-cortex/
 ├── package.json           # PI package manifest (pi: { extensions, skills }) + pi runtime deps
-├── plugin.json            # GitHub Copilot plugin manifest — agents, skills, MCP servers
 ├── agents/                # Custom agents — canonical composable <name>/ dirs
-│   ├── *.agent.md         #   generated from <name>/ by scripts/build-copilot-agents.mjs
-│   ├── ralph/             #   composable format — see agents/README.md
+│   ├── ralph/             #   composable format (shared agent.md + pi/, claude/) — see agents/README.md
 │   ├── plan/              #   "
 │   ├── ralph-plan/        #   "
 │   └── strategy/          #   "
@@ -44,7 +41,7 @@ agent-cortex/
 ## Versioning
 
 Use `pnpm changeset` for all version bumps. Never edit versions manually.
-`package.json`, `plugin.json`, and `CHANGELOG.md` stay in lockstep automatically.
+`package.json` and `CHANGELOG.md` stay in lockstep automatically.
 See the `style-versioning` skill for the full workflow.
 
 ## Changelog
@@ -69,7 +66,7 @@ Generated automatically by changesets. Do not edit `CHANGELOG.md` manually.
 ## Skill Conventions
 
 - **Skills are portable, not repo documentation.** `skills/` is installed onto arbitrary machines
-  (Copilot, pi, Claude Code), so it describes general practice and the author's portable
+  (pi, Claude Code), so it describes general practice and the author's portable
   preferences — never how this repository is configured or how to work in it. Facts about this
   checkout (branch bases, merge method, signature rules, required checks, release mechanics) belong
   in `AGENTS.md`, `docs/`, or the tracker. Repo-local `.agents/skills/` follows the same rule: a
@@ -88,13 +85,10 @@ Generated automatically by changesets. Do not edit `CHANGELOG.md` manually.
 ## Agent Conventions
 
 - Agents live in composable `<name>/` directories under `agents/`: a shared `agent.md` body plus
-  per-harness subdirectories `pi/`, `copilot/`, `claude/` (frontmatter.json and optional section
-  files) per the spec in `agents/README.md`. `ralph`, `plan`, `ralph-plan`, and `strategy` all use
-  the composable layout. The flat `agents/*.agent.md` files are **generated output** — composed
-  from the canonical directories by the shared `bin/installers/copilot.mjs` code path behind both
-  `agent-cortex install copilot` and `scripts/build-copilot-agents.mjs` (thin wrapper), and
-  committed for Copilot CLI (plugin.json `agents: "agents/"` scans for `*.agent.md`); never edit
-  them by hand. The Claude plugin is materialised by the install-time generator
+  per-harness subdirectories `pi/` and `claude/` (frontmatter.json and optional section files) per
+  the spec in `agents/README.md`. `ralph`, `plan`, `ralph-plan`, and `strategy` all use the
+  composable layout, and no flat agent file is committed — each harness renders its own at install
+  time. The Claude plugin is materialised by the install-time generator
   `bin/installers/claude.mjs`: a plain `agent-cortex install claude` copies it into
   `~/.agent-cortex/claude` (skills copied flat with `{{TOOL:...}}`/`{{PATH:...}}` substituted,
   never symlinked), writes the marketplace manifest at

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # Changelog
 
+## 2.0.0
+
+### Major Changes
+
+- 847ce42: Remove Copilot CLI as a deploy target. `agent-cortex install copilot` is gone (the
+  supported harnesses are now `claude` and `pi`), along with the Copilot plugin manifest
+  `plugin.json`, the `build:copilot` script and its committed `agents/*.agent.md` output,
+  the `agents/*/copilot/` harness dirs, `scripts/sync-plugin-version.sh`, the `postinstall`
+  hook and `scripts/install-instructions.sh` that wrote `~/.copilot/copilot-instructions.md`,
+  and the Copilot column of `token-map.json`.
+
+  `version-packages` is now plain `changeset version`: the release surface is
+  `package.json` + `CHANGELOG.md`, since every plugin is materialised at install time with
+  the package version. Nothing is swept from an existing `~/.copilot` install — remove
+  `~/.copilot/installed-plugins/_direct/agent-cortex` by hand.
+
 ## 1.43.0
 
 ### Minor Changes

package/README.md

@@ -1,21 +1,18 @@
 # agent-cortex
 
-A personal collection of custom agents and skills, shipped to three harnesses from one
-source: the [GitHub Copilot CLI](https://docs.github.com/en/copilot/how-tos/copilot-cli/customize-copilot/plugins-creating),
-pi, and [Claude Code](https://code.claude.com/docs) (as a plugin).
+A personal collection of custom agents and skills, shipped to two harnesses from one
+source: pi and [Claude Code](https://code.claude.com/docs) (as a plugin).
 
 ## Structure
 
 ```
 agent-cortex/
-├── plugin.json               # Copilot plugin manifest
 ├── agents/                   # Canonical agents — composable <name>/ dirs (see agents/README.md)
-│   ├── *.agent.md            #   ralph, ralph-plan, plan, strategy — GENERATED from <name>/ by scripts/build-copilot-agents.mjs
-│   ├── ralph/                #   composable form (shared agent.md + per-harness pi/, copilot/, claude/)
+│   ├── ralph/                #   composable form (shared agent.md + per-harness pi/, claude/)
 │   ├── plan/                 #   "
 │   ├── ralph-plan/           #   "
 │   └── strategy/             #   "
-├── agents-native/            # Claude-only agents with no Copilot equivalent
+├── agents-native/            # Claude-only agents
 │   └── ralph.md              #  the lean Claude Ralph
 ├── skills/                   # Skills (grouped by domain) — shared by all harnesses
 │   ├── engineering/          #  tdd, improve-codebase-architecture, …
@@ -37,23 +34,18 @@ agent-cortex/
 ├── bin/
 │   ├── agent-cortex.mjs      # CLI entrypoint
 │   └── installers/
-│       ├── copilot.mjs       # shared generator: agent-cortex install copilot + scripts/build-copilot-agents.mjs
-│       └── claude.mjs        # materialises ~/.agent-cortex/claude + ~/.claude/settings.json, registers with Claude Code (--output <dir> = generate-only)
-├── scripts/
-│   └── build-copilot-agents.mjs  # thin wrapper over bin/installers/copilot.mjs (regenerates agents/*.agent.md)
+│       ├── claude.mjs        # materialises ~/.agent-cortex/claude + ~/.claude/settings.json, registers with Claude Code (--output <dir> = generate-only)
+│       └── pi.mjs            # stages ~/.agent-cortex/pi + registers it with pi (--output <dir> = stage-only)
 ├── claude/                   # Committed Claude user-settings template (settings.json) — merged into ~/.claude/settings.json
 └── claude-extras/            # Hand-authored Claude plugin extras
     ├── .mcp.json             #  MCP servers (context7, github) — copied into installs
     └── scripts/              #  statusline-command.sh — copied into installs (executable)
 ```
 
-The same `agents/` and `skills/` power three harnesses (Copilot, pi, Claude Code).
-The composable `agents/<name>/` directories are the single source of truth; the flat
-`agents/*.agent.md` files are **generated** by the shared copilot installer
-(`agent-cortex install copilot`, or `scripts/build-copilot-agents.mjs` via
-`pnpm build:copilot` — both run the same `bin/installers/copilot.mjs` code path, so
-install-time and build-time output can never diverge) and committed so Copilot CLI
-(plugin.json `agents: "agents/"`) and pi keep loading the agents — don't hand-edit them.
+The same `agents/` and `skills/` power two harnesses (pi and Claude Code). The composable
+`agents/<name>/` directories are the single source of truth, and no flat agent file is
+committed: `agent-cortex install claude` and `agent-cortex install pi` each render their own
+from the canonical directories, so install-time output can never drift from the sources.
 The `{{TOOL:...}}` / `{{PATH:...}}` tokens written in agent and skill files are resolved
 per harness at install time from `token-map.json`, the single source of truth for
 canonical tool/path/agent names (see `token-map.README.md` and the `contract` section).
@@ -76,15 +68,13 @@ temp-dir install plus structural checks:
 - **Agents** can't be shared files (the frontmatter formats differ), so the materialised
   plugin's `agents/*.md` are composed from the canonical `agents/<name>/` directories' `claude/`
   harness dirs
-  (frontmatter.json + section files), exactly like the Copilot flats are composed from their
-  `copilot/` dirs. Claude only loads agents from a plugin's default `agents/` dir, so the plugin
-  ships them at its own root (default `~/.agent-cortex/claude/agents/`) — isolating them from the
-  Copilot `.agent.md` files.
-- **Claude-native agents** that have no Copilot equivalent live in `agents-native/*.md` and are
-  copied verbatim into the materialised plugin's `agents/`. `ralph` is one: it is reimplemented
-  for Claude around
-  background workers + an independent review gate (the Copilot Ralph's `task`/`read_agent`
-  poll loop has no Claude equivalent), so it can't be mechanically converted.
+  (frontmatter.json + section files). Claude only loads agents from a plugin's default `agents/`
+  dir, so the plugin ships them at its own root (default `~/.agent-cortex/claude/agents/`).
+- **Claude-native agents** that cannot be composed from a shared body live in
+  `agents-native/*.md` and are copied verbatim into the materialised plugin's `agents/`. `ralph`
+  is one: it is reimplemented for Claude around background workers + an independent review gate
+  (Claude's event-driven completion delivery has no `task`/`read_agent` poll loop to reuse), so
+  it can't be mechanically converted.
 - **Manifests** are generated too: the plugin's `.claude-plugin/plugin.json` (its `version`
   tracks `package.json`, so it never goes stale) and `hooks.json` (copied from the canonical
   `hooks/claude/hooks.json` source), plus any support files under `hooks/claude/` bundled into
@@ -94,8 +84,8 @@ temp-dir install plus structural checks:
   extension→hook mapping and the rejections (auto-name, agent-guardrails, skill-stats, subagent, agent-modes).
 
 Edit the sources (`agents/<name>/` composable dirs, `agents-native/*.md`, `skills/**`,
-`hooks/claude/`, `claude-extras/`, `package.json`), never the generated
-`agents/*.agent.md` files or anything under the materialised `~/.agent-cortex/claude`.
+`hooks/claude/`, `claude-extras/`, `package.json`), never anything under the materialised
+`~/.agent-cortex/claude`.
 
 ## CI
 
@@ -117,9 +107,8 @@ validates the Claude plugin **materialiser** instead of diffing a committed mirr
 it runs `node bin/agent-cortex.mjs install claude --output <tmp dir>` and checks the
 result structurally — `plugin.json` version tracks `package.json`, every generated and
 hand-authored piece is present, no literal `{{TOOL:...}}`/`{{PATH:...}}` tokens survive,
-and no symlinks leak into the copied tree. The Copilot drift check
-(`pnpm build:copilot` + `git diff --exit-code -- 'agents/*.agent.md'`) still guards the
-committed flat agent files.
+and no symlinks leak into the copied tree. There is no committed agent file to drift-check:
+the `agents/` tree holds the composable sources only, and both installers render from them.
 
 A separate `changeset-check` job runs on every pull request and fails it unless the
 PR adds a `.changeset/*.md` file. **Publishing is the default and `no-publish` is the
@@ -133,11 +122,10 @@ changeset.
 On pushes to `main`, a `release` job (gated on `lint`, `test`, and
 `claude-plugin-check`) runs changesets to open a `chore: version packages` PR when
 changesets are pending, then publishes to npm once it lands. The version step runs
-`pnpm version-packages` — bumping `package.json`, syncing `plugin.json`, and
-regenerating the committed Copilot agent files (the Claude plugin is materialised at
-install time with the package version, so it has no committed output to regenerate)
-so the drift gates stay green; the publish step runs `pnpm publish-package` (pack +
-provenance publish), or
+`pnpm version-packages` — `changeset version`, which bumps `package.json` and rewrites
+`CHANGELOG.md` and touches nothing else (both plugins are materialised at install time
+with the package version, so there is no committed output to regenerate); the publish
+step runs `pnpm publish-package` (pack + provenance publish), or
 `pnpm publish-noop` when the merged PR carried `no-publish`. Labels are invisible on
 a push event, so the job resolves the PR merged for the pushed commit through the
 GitHub API and reads its labels — no extra secret or scope, since the job already
@@ -262,18 +250,25 @@ templates** for your own pi configuration. They are not installer output: pi's
 `settings.json` and `keybindings.json` are pi's own user config, so
 `agent-cortex install pi` leaves them alone.
 
-### Copilot plugin (separate)
+### Removing a stale Copilot install
 
-```sh
-copilot plugin install jaybeeuu/agent-cortex
-```
-
-Or install a local checkout:
+Copilot CLI is no longer a deploy target: `agent-cortex install copilot` and the
+`plugin.json` manifest are gone, and nothing in this package reads or writes `~/.copilot`
+any more. No installer sweeps an existing install, so a machine that used the old target
+keeps a stale plugin, a cached marketplace, and an instruction block until you remove them
+by hand:
 
 ```sh
-copilot plugin install ./agent-cortex
+rm -rf ~/.copilot/installed-plugins/_direct/agent-cortex
+rm -rf ~/.cache/copilot/marketplaces/https---github-com-jaybeeuu-agent-cortex
+sed -i.bak '/<!-- agent-cortex:start -->/,/<!-- agent-cortex:end -->/d' \
+  ~/.copilot/copilot-instructions.md
 ```
 
+The first two paths are the old install and its marketplace cache. The `sed` deletes only
+the agent-cortex block the removed `postinstall` hook appended to Copilot's own
+instructions file, leaving the rest of that file — and a `.bak` copy — intact.
+
 ### Claude Code plugin (separate)
 
 A plain `agent-cortex install claude` **materialises** the plugin into the home install
@@ -293,10 +288,6 @@ The generate-only `--output <dir>` form is for previewing and CI validation; the
 documented path is the plain install to `~/.agent-cortex/claude`:
 
 ```sh
-pnpm build:copilot   # or: node scripts/build-copilot-agents.mjs (regenerates agents/*.agent.md)
-node bin/agent-cortex.mjs install copilot          # regenerates agents/*.agent.md in place
-node bin/agent-cortex.mjs install copilot --dry-run       # plan only, no writes
-node bin/agent-cortex.mjs install copilot --output /tmp/x # preview the flat files elsewhere
 node bin/agent-cortex.mjs install claude           # materialises ~/.agent-cortex/claude + marketplace manifest AND registers it with Claude Code (user scope, idempotent)
 node bin/agent-cortex.mjs install claude --dry-run       # plan generation + registration, no writes/spawns
 node bin/agent-cortex.mjs install claude --require-register  # fail (non-zero exit) when the claude CLI can't drive registration
@@ -432,14 +423,14 @@ extension→hook audit.
   rejection rationale live in `docs/claude-hooks.md`.
 - Ralph follow-ups: multi-feature epic branches, and a GitHub-trigger routine to auto-resume
   after a PR merge (instead of manual re-invocation).
-- The Copilot/pi Ralph (the 4-stage `run-pipeline-stage` pipeline) is unchanged; those two
+- The pi Ralph (the 4-stage `run-pipeline-stage` pipeline) is unchanged; those two
   ralph-coupled skills (`ralph`, `run-pipeline-stage`) are intentionally not shipped to Claude.
 
 #### Contributing to the Claude plugin
 
 Edit the **sources** — the composable `agents/<name>/` directories (shared `agent.md` +
-per-harness frontmatter/sections, auto-composed by `scripts/build-copilot-agents.mjs` and
-`bin/installers/claude.mjs`), `agents-native/*.md` (Claude-only
+per-harness frontmatter/sections, composed by `bin/installers/claude.mjs`),
+`agents-native/*.md` (Claude-only
 agents like `ralph` — the canonical bodies the installer copies verbatim), `skills/**`,
 `hooks/claude/hooks.json` (hook config), `claude/settings.json` (the user-settings template
 merged into `~/.claude/settings.json`), `claude-extras/` (hand-authored `.mcp.json` and
@@ -449,7 +440,5 @@ version — picked up at install time) — then run
 re-registers it; `--output <dir>` generates a preview only). The only committed file under
 `claude/` is the settings template; `~/.agent-cortex/claude` is generated in full
 (`.claude-plugin/plugin.json`, `agents/`, `skills/`, `hooks.json`, `.mcp.json`, `scripts/`)
-so never edit anything under it. The generated `agents/*.agent.md` files are still
-drift-checked by CI (`git diff --exit-code -- 'agents/*.agent.md'`), and CI validates the
-Claude materialiser (structural checks on a temp-dir install) so sources and installer can
-never silently diverge.
+so never edit anything under it. CI validates the Claude materialiser (structural checks on
+a temp-dir install) so sources and installer can never silently diverge.

package/agents/README.md

@@ -4,7 +4,7 @@ This document defines the canonical format for composable agent directories in a
 
 ## Motivation
 
-The original format used a single `*.agent.md` file per agent, combining harness-agnostic logic with harness-specific configuration. This created duplication when the same agent needed to run on multiple harnesses (PI, Copilot, Claude) with different tool names and polling mechanisms.
+The original format used a single `*.agent.md` file per agent, combining harness-agnostic logic with harness-specific configuration. This created duplication when the same agent needed to run on multiple harnesses (PI, Claude) with different tool names and polling mechanisms.
 
 The composable directory format separates concerns:
 
@@ -21,9 +21,6 @@ agents/
 │   ├── pi/
 │   │   ├── frontmatter.json        # PI-specific metadata
 │   │   └── <section>.md            # Optional: PI-specific sections
-│   ├── copilot/
-│   │   ├── frontmatter.json        # Copilot-specific metadata
-│   │   └── <section>.md            # Optional: Copilot-specific sections
 │   └── claude/
 │       ├── frontmatter.json        # Claude-specific metadata
 │       └── <section>.md            # Optional: Claude-specific sections
@@ -37,9 +34,6 @@ agents/ralph/
 ├── pi/
 │   ├── frontmatter.json            # PI tools: ["bash", "task", "read_agent", "wait_for_agents"]
 │   └── polling.md                  # PI completion: blocking wait_for_agents (no poll timer)
-├── copilot/
-│   ├── frontmatter.json            # Copilot tools: ["bash", "task", "read_agent"]
-│   └── polling.md                  # Copilot completion: sleep-120 poll timer + read_agent
 └── claude/
     ├── frontmatter.json            # Claude tools: ["bash", "task"]
     └── polling.md                  # Claude event-driven (no polling)
@@ -52,8 +46,6 @@ agents/plan/
 ├── agent.md                        # Shared body (planning workflow)
 ├── pi/
 │   └── frontmatter.json            # PI tools
-├── copilot/
-│   └── frontmatter.json            # Copilot tools
 └── claude/
     └── frontmatter.json            # Claude tools
 ```
@@ -143,9 +135,8 @@ When composing the final agent file for a specific harness:
 2. Replace `{{SECTION:name}}` with content from `<harness>/<name>.md`
 3. `{{TOOL:name}}` and `{{PATH:name}}` are resolved against `token-map.json` — the
    canonical tool/path/agent names per harness. `scripts/lib/compose-agent.mjs` (used by
-   `build:copilot` and by `bin/installers/claude.mjs` / `bin/installers/pi.mjs`) resolves them when
-   generating the flat files / installing for claude and pi; pi's `agent-modes` extension does the
-   same at runtime. See the `contract` section of `token-map.json` and
+   `bin/installers/claude.mjs` / `bin/installers/pi.mjs`) resolves them when generating the flat
+   files / installing for claude and pi; pi's `agent-modes` extension does the same at runtime. See the `contract` section of `token-map.json` and
    `token-map.README.md` for the rules.
 
 The pi harness's `agent-modes` extension is a runtime consumer of this format: it
@@ -201,7 +192,6 @@ Agents like `plan`, `ralph-plan`, and `strategy` that have identical behavior ac
 agents/plan/
 ├── agent.md              # Shared body (same for all harnesses)
 ├── pi/frontmatter.json   # PI tools
-├── copilot/frontmatter.json  # Copilot tools
 └── claude/frontmatter.json    # Claude tools
 ```
 
@@ -211,14 +201,12 @@ agents/plan/
 2. Migrate ralph agent first (proves the pattern) — DONE
 3. Migrate plan, ralph-plan, strategy agents — DONE
 4. Update the installer/composer to handle the new format
-5. Remove old `*.agent.md` files — DONE (the flat files are now **generated output**, see below)
+5. Remove old `*.agent.md` files — DONE (the composable directories are the only committed
+   form; every harness composes or renders its own agent files at install time)
 
-All four agents (`ralph`, `plan`, `ralph-plan`, `strategy`) use the composable layout and the
-flat `agents/*.agent.md` files are built from them:
+All four agents (`ralph`, `plan`, `ralph-plan`, `strategy`) use the composable layout, and no
+flat agent file is committed:
 
-- `scripts/build-copilot-agents.mjs` (`pnpm build:copilot`) composes `agents/*.agent.md` from
-  each agent's `copilot/` harness dir — committed for Copilot CLI, which loads `*.agent.md`
-  from `plugin.json`'s `agents: "agents/"` path.
 - `bin/installers/claude.mjs` (plain `agent-cortex install claude` materialises the plugin
   into `~/.agent-cortex/claude` and registers it with Claude Code; `--output <dir>` is its
   generate-only form, used by tests/CI) composes the plugin's
@@ -239,9 +227,7 @@ via `bin/installers/claude.mjs`, the generator behind plain `agent-cortex instal
 `claude/settings.json` into `~/.claude/settings.json`, and registers the plugin with Claude
 Code); the only committed `claude/` file is that settings template (hand-authored extras live
 in `claude-extras/`), and CI validates the materialiser with structural checks on a temp-dir
-install; `copilot` ships via
-`bin/installers/copilot.mjs`, the shared code path behind both `agent-cortex install
-copilot` and `scripts/build-copilot-agents.mjs`; `pi` ships via
+install; `pi` ships via
 `bin/installers/pi.mjs`, which stages a self-contained pi package (manifest, rendered
 agents, token-substituted skills, extensions) at `~/.agent-cortex/pi`.
 
@@ -264,7 +250,7 @@ The validator checks:
 
 - JSON has strict syntax (no comments, no ambiguity)
 - Easier to validate with JSON Schema
-- Consistent with existing tooling (package.json, plugin.json)
+- Consistent with existing tooling (package.json)
 - No need for YAML parser dependency
 
 ### Why separate section files instead of inline sections?

package/agents/ralph/agent.md

@@ -42,7 +42,7 @@ Run once at startup:
 5. Create Ralph's workspace directory: `mkdir -p .agent-cortex/ralph`
 6. Create `.agent-cortex/ralph/state.json` with initial content:
    ```json
-   { "timerShellId": null, "inflight": [] }
+   { "inflight": [] }
    ```
    Then generate the progress file:
    ```bash
@@ -59,7 +59,7 @@ Run once at startup:
    b. Claim the parent bead: `bd update <parent-id> --claim`.
    c. Create the first stage chore bead and dispatch it (see _Creating and dispatching a stage chore_ below).
 8. Record each launched agent in `.agent-cortex/ralph/state.json` (see format below).
-9. Hand over to the completion-detection mechanism in the polling section: it starts the Copilot poll loop, blocks with `wait_for_agents` (PI), or waits for event-driven wake-ups (Claude), and proceeds to **HITL Pause** directly when no agent work was dispatched and HITL gate beads are pending.
+9. Hand over to the completion-detection mechanism in the polling section: it blocks with `wait_for_agents` (PI) or waits for event-driven wake-ups (Claude), and proceeds to **HITL Pause** directly when no agent work was dispatched and HITL gate beads are pending.
 
 ---
 
@@ -101,7 +101,6 @@ All orchestration state is derived from beads:
 
 ```json
 {
-  "timerShellId": "shell-abc",
   "inflight": [
     { "choreId": "xyz-456", "parentId": "abc-123", "title": "Add auth", "agentId": "agent-xyz-456", "logLine": 4 },
     { "choreId": "def-789", "parentId": "ghi-101", "title": "Fix cache", "agentId": "agent-def-789", "logLine": 7 }
@@ -109,7 +108,6 @@ All orchestration state is derived from beads:
 }
 ```
 
-- **timerShellId**: the shellId of the active poll-timer bash process used for completion polling (Copilot; stays `null` on PI, which blocks with `wait_for_agents` instead, and on event-driven harnesses such as Claude).
 - **inflight[].choreId**: the chore bead currently being worked by the subagent.
 - **inflight[].parentId**: the parent feature task bead. Log file is `.agent-cortex/ralph/ralph-<parentId>.log`.
 - **inflight[].logLine**: the next line number to read from the parent's log file (1-based; start at 1). Updated after every poll.
@@ -127,12 +125,12 @@ Update `.agent-cortex/ralph/state.json` after **every** agent completion or disp
 
 ## Event loop
 
-After initialization, Ralph waits for background agents to complete. Completion notifications are delivered by the mechanism documented in the polling section — PI blocks with `wait_for_agents` until a worker completes and its result is returned inline; Copilot uses an active poll timer plus log polling; Claude is event-driven (you are re-invoked automatically when a worker completes, with its result delivered inline). On each completion notification:
+After initialization, Ralph waits for background agents to complete. Completion notifications are delivered by the mechanism documented in the polling section — PI blocks with `wait_for_agents` until a worker completes and its result is returned inline; Claude is event-driven (you are re-invoked automatically when a worker completes, with its result delivered inline). On each completion notification:
 
 ### If a background agent completed
 
-1. **Flush** that bead's log using the log-polling procedure in the polling section to pick up any final lines for the chat summary (PI: flush new log lines as part of handling the `wait_for_agents` result; Copilot: flush to detect completion; Claude: nothing to flush — the result is delivered with the wake-up).
-2. **Read** the completed agent's full output (PI: the result arrives in the `wait_for_agents` response, with `read_agent` as a fallback for a specific result; Copilot: `read_agent`; Claude: the result was delivered inline).
+1. **Flush** that bead's log using the log-polling procedure in the polling section to pick up any final lines for the chat summary (PI: flush new log lines as part of handling the `wait_for_agents` result; Claude: nothing to flush — the result is delivered with the wake-up).
+2. **Read** the completed agent's full output (PI: the result arrives in the `wait_for_agents` response, with `read_agent` as a fallback for a specific result; Claude: the result was delivered inline).
 3. **Re-read** `.agent-cortex/ralph/state.json` to identify the chore bead and parent for that agent ID.
 4. **Parse** the agent's `---REPORT---` block (see report format in the `run-pipeline-stage` skill).
 5. **Close** the completed chore bead: `bd close <chore-id>`.
@@ -188,7 +186,7 @@ Proceed here when no chore beads are in-flight, no `stage:*` chore beads are rea
 
    When you've completed the above actions, prompt me to continue.
    ```
-6. **Stop completely.** Stop the polling mechanism documented in the polling section (Copilot: kill any running timer; PI and Claude: nothing to stop — there is no timer). Do **not** restart or schedule anything. Do **not** start any background processes. Do **not** check bead status again. Do **not** continue the event loop. Output **nothing further** after the summary above. Ralph is now fully idle — it must not act again until the user explicitly re-prompts.
+6. **Stop completely.** Stop the polling mechanism documented in the polling section (PI and Claude: nothing to stop — there is no timer). Do **not** restart or schedule anything. Do **not** start any background processes. Do **not** check bead status again. Do **not** continue the event loop. Output **nothing further** after the summary above. Ralph is now fully idle — it must not act again until the user explicitly re-prompts.
 
 ---
 
@@ -258,5 +256,4 @@ All beads complete.
 - **Never** auto-merge feature or epic PRs — merge decisions are human-controlled.
 - **Never** continue past feature completion until PR `feature/<parent-id> -> epic/<epic-id>` is merged and the child HITL PR gate bead is closed by a human.
 - **Never** continue past epic completion until PR `epic/<epic-id> -> main` is merged.
-- **When a feature hits the HITL PR gate, push and open the PR immediately and report the URL — do not wait for explicit approval to push or create the PR.**
-- **Always** bump the patch version in `plugin.json` as part of any commit that changes agent or skill files.
+- **When a feature hits the HITL PR gate, push and open the PR immediately and report the URL — do not wait for explicit approval to push or create the PR.**

package/agents/ralph/claude/polling.md

@@ -20,7 +20,7 @@ Rules:
 
 Claude Code **re-invokes you automatically when a background worker completes** — the worker's result is delivered to you inline on the wake-up. **Do not poll and do not `sleep`.** React to completions as they arrive.
 
-- There is **no poll timer on Claude**: skip the PI/Copilot timer start and restart steps in initialization, and there is nothing to kill in **HITL Pause** — when you stop, you simply stop. The harness wakes you again when the user re-invokes you.
+- There is **no poll timer anywhere in this pipeline**: nothing in initialization starts one, and there is nothing to kill in **HITL Pause** — when you stop, you simply stop. The harness wakes you again when the user re-invokes you.
 - There is **no log tailing on Claude**: workers' progress lines (`.agent-cortex/ralph/ralph-<parentId>.log`) are written by the workers themselves and surfaced by the harness with the completion — nothing to flush, nothing to poll. Produce the shared chat summaries from the delivered result instead.
 - On each completion, apply the shared handling in the **Event loop** section of agent.md (steps 3–8: correlate the task ID to its bead via `state.json`, parse the REPORT, close the chore, advance the parent, check for newly ready beads, run the shutdown check). `state.json` `logLine` tracking is not used on Claude.
 

package/bin/agent-cortex.mjs

@@ -112,22 +112,6 @@ if (parsed.command === "install") {
       process.exit(1);
     }
   }
-
-  // copilot regenerates the flat agents/*.agent.md files the Copilot plugin
-  // loads via plugin.json ("agents": "agents/") — the same code path
-  // `pnpm build:copilot` runs.
-  if (parsed.harness === "copilot") {
-    const { installCopilot } = await import("./installers/copilot.mjs");
-    try {
-      await installCopilot({ output: parsed.output, dryRun: parsed.dryRun });
-      process.exit(0);
-    } catch (err) {
-      process.stderr.write(`Install failed: ${err.message}\n`);
-      process.exit(1);
-    }
-  }
-
-  process.exit(0);
 }
 
 function printPiSweep({ removed }) {

package/bin/installers/claude.mjs

@@ -97,8 +97,8 @@ const DEFAULT_WARN = (msg) => console.warn(`[claude-installer] ${msg}`);
 // section composition from the poll-loop sources.
 const DEFER = new Set(["ralph"]);
 
-// Ralph-coupled Copilot skills that don't apply to the lean Claude Ralph (and carry dead
-// ~/.copilot orchestration paths). Not copied into the Claude plugin.
+// Ralph-coupled pipeline skills that don't apply to the lean Claude Ralph (its completion
+// handling is event-driven, not the pi orchestrator's). Not copied into the Claude plugin.
 const SKILL_EXCLUDE = new Set(["ralph", "run-pipeline-stage"]);
 
 const NAME_PREFIX = "agent-cortex:";