From 589621378072db7f68662fd32f75bde442284b6e Mon Sep 17 00:00:00 2001 From: Giancarmine Salucci Date: Thu, 10 Sep 2026 01:27:47 +0200 Subject: [PATCH] docs: clarify plugin agents are namespaced (redsen-lean-harness:conductor) outside this repo --- README.md | 6 ++++++ docs/QUICKSTART.md | 6 ++++++ 2 files changed, 12 insertions(+) diff --git a/README.md b/README.md index b075847..9559b38 100644 --- a/README.md +++ b/README.md @@ -127,6 +127,12 @@ Then, in Copilot CLI or VS Code Copilot: @conductor build a rate limiter for the public API ``` +> **Agent name note:** inside this repo (or any repo where the harness lives natively in +> `.github/agents`), `@conductor` works unprefixed. Once installed as a *plugin* into another +> project, Copilot CLI namespaces plugin agents to avoid name collisions — use +> `@redsen-lean-harness:conductor` (tab-complete via `/agent` shows the full list). Skills +> (`/fast-track`, `/design`, etc.) are not namespaced and work either way. + For a small brownfield change, skip the ceremony: ``` diff --git a/docs/QUICKSTART.md b/docs/QUICKSTART.md index b70796f..c8fabdb 100644 --- a/docs/QUICKSTART.md +++ b/docs/QUICKSTART.md @@ -109,6 +109,12 @@ size of the change. @conductor build a rate limiter for the public API ``` +> **Agent name note:** inside this repo (or any repo where the harness lives natively in +> `.github/agents`), `@conductor` works unprefixed. Once installed as a *plugin* into another +> project, Copilot CLI namespaces plugin agents to avoid name collisions — use +> `@redsen-lean-harness:conductor` (tab-complete via `/agent` shows the full list). Skills +> (`/fast-track`, `/design`, etc.) are not namespaced and work either way. + This runs the whole pipeline: `interrogator` asks clarifying questions with recommended answers (you must answer before it proceeds — this is a deliberate gate), `architect` writes the spec and acceptance criteria, `splitter` breaks it into lanes, `builder`/`verifier` run the