From 4632bfbdf64db3a93c9a80f6ada5bb5c6befd13b Mon Sep 17 00:00:00 2001
From: =?UTF-8?q?Niccol=C3=B2=20Olivieri=20Achille?=
 <niccolo.olivieri@bepower.com>
Date: Wed, 14 Oct 2026 12:01:01 +0200
Subject: [PATCH] feat(agents)!: :recycle: adopt potr- namespace for crew
 templates

Rename the four distributable Kiro agent templates to the potr- namespace,
consistently across specs, prompts, skills, CLI, tests and docs:
bepower-setup       -> potr-setup
functional-analyst  -> potr-functional-analyst
upgrade-guardian    -> potr-upgrade-guardian
rev-eng             -> potr-rev-eng

- git mv all agent/prompt files and the upgrade-guardian skill +
functional-analyst resources dirs (history preserved)
- update "name"/prompt/resources paths inside each spec
- update CREW_AGENTS and all copy paths/logs in init-crew.ts / init-kiro.ts
so members register under the new names
- update test assertions and README / hooks docs

CHANGELOG and version bump handled by release-please; dist/ regenerated
via build (gitignored).

BREAKING CHANGE: crew agent templates renamed to the potr- namespace;
the previous names (bepower-setup, functional-analyst, upgrade-guardian,
rev-eng) no longer resolve.
---
 README.md                                     | 24 +++++-----
 cli/commands/init-crew.ts                     |  7 ++-
 cli/commands/init-kiro.ts                     | 44 ++++++++++---------
 ...lyst.json => potr-functional-analyst.json} |  6 +--
 .../{rev-eng.json => potr-rev-eng.json}       |  4 +-
 .../{bepower-setup.json => potr-setup.json}   |  4 +-
 ...ardian.json => potr-upgrade-guardian.json} |  4 +-
 kiro/hooks/README.md                          |  6 +--
 ...-analyst.md => potr-functional-analyst.md} |  0
 kiro/prompts/{rev-eng.md => potr-rev-eng.md}  |  4 +-
 .../{bepower-setup.md => potr-setup.md}       |  4 +-
 ...e-guardian.md => potr-upgrade-guardian.md} |  8 ++--
 .../template-analisi-funzionale.md            |  0
 .../template-matrice-funzionale.md            |  0
 .../template-steering-architecture.md         |  0
 .../template-steering-domain.md               |  0
 .../template-steering-roles.md                |  0
 .../SKILL.md                                  |  4 +-
 test/init-crew.test.ts                        | 12 ++++-
 test/init-kiro.test.ts                        | 18 ++++----
 20 files changed, 82 insertions(+), 67 deletions(-)
 rename kiro/agents/{functional-analyst.json => potr-functional-analyst.json} (82%)
 rename kiro/agents/{rev-eng.json => potr-rev-eng.json} (94%)
 rename kiro/agents/{bepower-setup.json => potr-setup.json} (90%)
 rename kiro/agents/{upgrade-guardian.json => potr-upgrade-guardian.json} (92%)
 rename kiro/prompts/{functional-analyst.md => potr-functional-analyst.md} (100%)
 rename kiro/prompts/{rev-eng.md => potr-rev-eng.md} (97%)
 rename kiro/prompts/{bepower-setup.md => potr-setup.md} (92%)
 rename kiro/prompts/{upgrade-guardian.md => potr-upgrade-guardian.md} (84%)
 rename kiro/resources/{functional-analyst => potr-functional-analyst}/template-analisi-funzionale.md (100%)
 rename kiro/resources/{functional-analyst => potr-functional-analyst}/template-matrice-funzionale.md (100%)
 rename kiro/resources/{functional-analyst => potr-functional-analyst}/template-steering-architecture.md (100%)
 rename kiro/resources/{functional-analyst => potr-functional-analyst}/template-steering-domain.md (100%)
 rename kiro/resources/{functional-analyst => potr-functional-analyst}/template-steering-roles.md (100%)
 rename kiro/skills/{upgrade-guardian => potr-upgrade-guardian}/SKILL.md (98%)

diff --git a/README.md b/README.md
index 0b72fd3..b9df2aa 100644
--- a/README.md
+++ b/README.md
@@ -108,7 +108,7 @@ At the end it offers an interactive opt-in — **"Also initialize KiroCrew? (y/N
 What it installs:
 1. `~/.kiro/agents/*.json` — the four agent specs (also valid KiroCrew templates)
 2. `~/.kiro/prompts/*.md` — their system prompts
-3. `~/.kiro/skills/` — workflow skills (incl. the `upgrade-guardian` skill)
+3. `~/.kiro/skills/` — workflow skills (incl. the `potr-upgrade-guardian` skill)
 4. `~/.kiro/hooks/` — safety-gate, barrel-export, etc.
 5. `~/.kiro/steering/` — shared steering docs
 
@@ -196,10 +196,10 @@ These agents are distributed by `dev init-kiro` for use across all BePower proje
 
 | Agent | Description |
 |-------|-------------|
-| `bepower-setup` | Analyzes a project and generates optimal `.kiro/` configuration (steering, agent, prompt, skills) |
-| `functional-analyst` | Interactive functional analysis — collects requirements through conversation, produces approval docs and technical briefs (Italian-first) |
-| `upgrade-guardian` | Assesses the safety of a dependency/framework upgrade in an isolated worktree and returns a reasoned **LOW/MEDIUM/HIGH** risk verdict with real breaking-change analysis, project impact and verification |
-| `rev-eng` | Reverse-engineers a target web app's internal API via Playwright and documents it for a TypeScript client |
+| `potr-setup` | Analyzes a project and generates optimal `.kiro/` configuration (steering, agent, prompt, skills) |
+| `potr-functional-analyst` | Interactive functional analysis — collects requirements through conversation, produces approval docs and technical briefs (Italian-first) |
+| `potr-upgrade-guardian` | Assesses the safety of a dependency/framework upgrade in an isolated worktree and returns a reasoned **LOW/MEDIUM/HIGH** risk verdict with real breaking-change analysis, project impact and verification |
+| `potr-rev-eng` | Reverse-engineers a target web app's internal API via Playwright and documents it for a TypeScript client |
 
 ## Using the Agents
 
@@ -212,7 +212,7 @@ Pass the agent name to `kiro-cli chat`:
 ```bash
 # in the repo you want it to work on
 cd ~/projects/bepower/bep-cdk
-kiro-cli chat --agent upgrade-guardian
+kiro-cli chat --agent potr-upgrade-guardian
 ```
 
 Then start the conversation by telling it what to assess, e.g.:
@@ -223,7 +223,7 @@ The agent reads the project context (`README.md`, `AGENTS.md` if present, `packa
 
 ### In the KiroCrew dashboard
 
-After `dev init-crew` the agents appear as **members in the dashboard's agent picker**. Open a new chat, pick `upgrade-guardian` (or `rev-eng`), and start the conversation the same way — the result (e.g. an upgrade safety report) is rendered inline, with each member keeping its own dedicated memory.
+After `dev init-crew` the agents appear as **members in the dashboard's agent picker**. Open a new chat, pick `potr-upgrade-guardian` (or `potr-rev-eng`), and start the conversation the same way — the result (e.g. an upgrade safety report) is rendered inline, with each member keeping its own dedicated memory.
 
 ### How to start the conversation
 
@@ -231,12 +231,12 @@ These agents are **task-driven**, not chatty — open with the concrete thing yo
 
 | Agent | A good opening message |
 |-------|------------------------|
-| `upgrade-guardian` | _"Assess upgrading `<package>` from `<x>` to `<y>` in this repo. Is it safe to merge?"_ |
-| `rev-eng` | _"Reverse-engineer the API of `<url>` and document the endpoints for a TypeScript client."_ |
-| `bepower-setup` | _"Analyze this project and generate the `.kiro/` configuration for it."_ |
-| `functional-analyst` | _"Raccogliamo i requisiti per `<feature>`."_ (Italian-first) |
+| `potr-upgrade-guardian` | _"Assess upgrading `<package>` from `<x>` to `<y>` in this repo. Is it safe to merge?"_ |
+| `potr-rev-eng` | _"Reverse-engineer the API of `<url>` and document the endpoints for a TypeScript client."_ |
+| `potr-setup` | _"Analyze this project and generate the `.kiro/` configuration for it."_ |
+| `potr-functional-analyst` | _"Raccogliamo i requisiti per `<feature>`."_ (Italian-first) |
 
-The agent does the rest — reads context, analyzes, and returns a verdict or document. For `upgrade-guardian` the output is a safety report with a LOW/MEDIUM/HIGH verdict and a **suggested** (never executed) commit message; you decide whether to apply it.
+The agent does the rest — reads context, analyzes, and returns a verdict or document. For `potr-upgrade-guardian` the output is a safety report with a LOW/MEDIUM/HIGH verdict and a **suggested** (never executed) commit message; you decide whether to apply it.
 
 ## Architecture
 
diff --git a/cli/commands/init-crew.ts b/cli/commands/init-crew.ts
index dff93b4..35c747d 100644
--- a/cli/commands/init-crew.ts
+++ b/cli/commands/init-crew.ts
@@ -13,7 +13,12 @@ const execAsync = promisify(exec);
  * from the same `~/.kiro/agents/` directory, so each one only needs a crew
  * member bound to it (`kirocrew agent create --kiro-agent <template>`).
  */
-const CREW_AGENTS = ['upgrade-guardian', 'rev-eng', 'bepower-setup', 'functional-analyst'] as const;
+const CREW_AGENTS = [
+  'potr-upgrade-guardian',
+  'potr-rev-eng',
+  'potr-setup',
+  'potr-functional-analyst',
+] as const;
 
 const CREW_WORKSPACE = 'default';
 
diff --git a/cli/commands/init-kiro.ts b/cli/commands/init-kiro.ts
index 9fd5efc..bd81a34 100644
--- a/cli/commands/init-kiro.ts
+++ b/cli/commands/init-kiro.ts
@@ -34,37 +34,37 @@ export const initKiro = new Command()
 
       // Agents
       await mkdir(join(kiroDir, 'agents'), { recursive: true });
+      await cp(join(paths.kiro, 'agents/potr-setup.json'), join(kiroDir, 'agents/potr-setup.json'));
       await cp(
-        join(paths.kiro, 'agents/bepower-setup.json'),
-        join(kiroDir, 'agents/bepower-setup.json'),
+        join(paths.kiro, 'agents/potr-functional-analyst.json'),
+        join(kiroDir, 'agents/potr-functional-analyst.json'),
       );
       await cp(
-        join(paths.kiro, 'agents/functional-analyst.json'),
-        join(kiroDir, 'agents/functional-analyst.json'),
+        join(paths.kiro, 'agents/potr-upgrade-guardian.json'),
+        join(kiroDir, 'agents/potr-upgrade-guardian.json'),
       );
       await cp(
-        join(paths.kiro, 'agents/upgrade-guardian.json'),
-        join(kiroDir, 'agents/upgrade-guardian.json'),
+        join(paths.kiro, 'agents/potr-rev-eng.json'),
+        join(kiroDir, 'agents/potr-rev-eng.json'),
       );
-      await cp(join(paths.kiro, 'agents/rev-eng.json'), join(kiroDir, 'agents/rev-eng.json'));
 
       // Prompts
       await mkdir(join(kiroDir, 'prompts'), { recursive: true });
+      await cp(join(paths.kiro, 'prompts/potr-setup.md'), join(kiroDir, 'prompts/potr-setup.md'));
       await cp(
-        join(paths.kiro, 'prompts/bepower-setup.md'),
-        join(kiroDir, 'prompts/bepower-setup.md'),
+        join(paths.kiro, 'prompts/potr-functional-analyst.md'),
+        join(kiroDir, 'prompts/potr-functional-analyst.md'),
       );
       await cp(
-        join(paths.kiro, 'prompts/functional-analyst.md'),
-        join(kiroDir, 'prompts/functional-analyst.md'),
+        join(paths.kiro, 'prompts/potr-upgrade-guardian.md'),
+        join(kiroDir, 'prompts/potr-upgrade-guardian.md'),
       );
       await cp(
-        join(paths.kiro, 'prompts/upgrade-guardian.md'),
-        join(kiroDir, 'prompts/upgrade-guardian.md'),
+        join(paths.kiro, 'prompts/potr-rev-eng.md'),
+        join(kiroDir, 'prompts/potr-rev-eng.md'),
       );
-      await cp(join(paths.kiro, 'prompts/rev-eng.md'), join(kiroDir, 'prompts/rev-eng.md'));
 
-      // Resources (functional-analyst templates)
+      // Resources (potr-functional-analyst templates)
       await cp(join(paths.kiro, 'resources'), join(kiroDir, 'resources'), { recursive: true });
 
       // Skills (bepower-dev workflow skills)
@@ -82,16 +82,18 @@ export const initKiro = new Command()
 
       console.log('✓ Kiro agents installed globally');
       console.log(`\n  Agents:`);
-      console.log(`    ${join(kiroDir, 'agents/bepower-setup.json')}`);
-      console.log(`    ${join(kiroDir, 'agents/functional-analyst.json')}`);
+      console.log(`    ${join(kiroDir, 'agents/potr-setup.json')}`);
+      console.log(`    ${join(kiroDir, 'agents/potr-functional-analyst.json')}`);
       console.log(`  Prompts: ${join(kiroDir, 'prompts/')}`);
       console.log(`  Skills:  ${skillsDest}/`);
       console.log(`  Hooks:   ${join(kiroDir, 'hooks/')}`);
       console.log('\nAvailable agents:');
-      console.log('  • bepower-setup — Generate .kiro/ config for a project');
-      console.log('  • functional-analyst — Interactive requirements gathering (Italian)');
-      console.log('  • upgrade-guardian — Assess dependency/framework upgrade safety (read-only)');
-      console.log('  • rev-eng — Reverse-engineer a web app API via Playwright (read-only)');
+      console.log('  • potr-setup — Generate .kiro/ config for a project');
+      console.log('  • potr-functional-analyst — Interactive requirements gathering (Italian)');
+      console.log(
+        '  • potr-upgrade-guardian — Assess dependency/framework upgrade safety (read-only)',
+      );
+      console.log('  • potr-rev-eng — Reverse-engineer a web app API via Playwright (read-only)');
 
       // Offer to also wire these agents into KiroCrew (dashboard members).
       // Only prompts on an interactive TTY; non-interactive runs skip silently.
diff --git a/kiro/agents/functional-analyst.json b/kiro/agents/potr-functional-analyst.json
similarity index 82%
rename from kiro/agents/functional-analyst.json
rename to kiro/agents/potr-functional-analyst.json
index 63c8f9f..6385f56 100644
--- a/kiro/agents/functional-analyst.json
+++ b/kiro/agents/potr-functional-analyst.json
@@ -1,8 +1,8 @@
 {
-  "name": "functional-analyst",
+  "name": "potr-functional-analyst",
   "description": "Agente di analisi funzionale — raccoglie requisiti, produce documentazione per approvazione e brief tecnico per il team dev",
-  "prompt": "file://../prompts/functional-analyst.md",
-  "resources": ["file://kiro/resources/functional-analyst/*.md"],
+  "prompt": "file://../prompts/potr-functional-analyst.md",
+  "resources": ["file://kiro/resources/potr-functional-analyst/*.md"],
   "tools": [
     "read",
     "write",
diff --git a/kiro/agents/rev-eng.json b/kiro/agents/potr-rev-eng.json
similarity index 94%
rename from kiro/agents/rev-eng.json
rename to kiro/agents/potr-rev-eng.json
index b669d6f..359c04e 100644
--- a/kiro/agents/rev-eng.json
+++ b/kiro/agents/potr-rev-eng.json
@@ -1,7 +1,7 @@
 {
-  "name": "rev-eng",
+  "name": "potr-rev-eng",
   "description": "Generic reverse-engineering agent — discovers a target web app's internal API via Playwright browser automation and documents it for a TypeScript client. Read-only: never commits, pushes, publishes, or mutates project source outside the docs API folder.",
-  "prompt": "file://../prompts/rev-eng.md",
+  "prompt": "file://../prompts/potr-rev-eng.md",
   "resources": [
     "file://README.md",
     "file://AGENTS*.md",
diff --git a/kiro/agents/bepower-setup.json b/kiro/agents/potr-setup.json
similarity index 90%
rename from kiro/agents/bepower-setup.json
rename to kiro/agents/potr-setup.json
index 8f6d96a..93e8b43 100644
--- a/kiro/agents/bepower-setup.json
+++ b/kiro/agents/potr-setup.json
@@ -1,7 +1,7 @@
 {
-  "name": "bepower-setup",
+  "name": "potr-setup",
   "description": "Agent that analyzes a project and generates optimal .kiro/ configuration (steering, agent, prompt, skills)",
-  "prompt": "file://../prompts/bepower-setup.md",
+  "prompt": "file://../prompts/potr-setup.md",
   "resources": ["skill://.kiro/skills/**/SKILL.md"],
   "tools": [
     "read",
diff --git a/kiro/agents/upgrade-guardian.json b/kiro/agents/potr-upgrade-guardian.json
similarity index 92%
rename from kiro/agents/upgrade-guardian.json
rename to kiro/agents/potr-upgrade-guardian.json
index 328ad3b..28d2a90 100644
--- a/kiro/agents/upgrade-guardian.json
+++ b/kiro/agents/potr-upgrade-guardian.json
@@ -1,7 +1,7 @@
 {
-  "name": "upgrade-guardian",
+  "name": "potr-upgrade-guardian",
   "description": "Assesses the safety of a dependency/framework upgrade in an isolated worktree. Read-only: analyzes real breaking changes, project impact and verification, then returns a reasoned LOW/MEDIUM/HIGH risk verdict. Never commits, pushes, publishes, or opens PRs.",
-  "prompt": "file://../prompts/upgrade-guardian.md",
+  "prompt": "file://../prompts/potr-upgrade-guardian.md",
   "resources": [
     "file://README.md",
     "file://AGENTS*.md",
diff --git a/kiro/hooks/README.md b/kiro/hooks/README.md
index b6091bf..fcfbe68 100644
--- a/kiro/hooks/README.md
+++ b/kiro/hooks/README.md
@@ -41,9 +41,9 @@ They are **kept, not deleted**, pending a decision on whether to archive them:
 ## Agent distribution decision
 
 - **All agents ship to everyone.** No conditional selection; consistent with how
-  `init-kiro` copies the whole `kiro/` payload. `upgrade-guardian` and the generic
-  `rev-eng` are distributed globally like `bepower-setup` and `functional-analyst`.
-- **`rev-eng` stays global**, not scaffolded conditionally on "is this an
+  `init-kiro` copies the whole `kiro/` payload. `potr-upgrade-guardian` and the generic
+  `potr-rev-eng` are distributed globally like `potr-setup` and `potr-functional-analyst`.
+- **`potr-rev-eng` stays global**, not scaffolded conditionally on "is this an
   api-client project". It self-contextualizes at runtime; if the project has no
   target to reverse-engineer, the agent simply has nothing to do — no conditional
   install logic is needed.
diff --git a/kiro/prompts/functional-analyst.md b/kiro/prompts/potr-functional-analyst.md
similarity index 100%
rename from kiro/prompts/functional-analyst.md
rename to kiro/prompts/potr-functional-analyst.md
diff --git a/kiro/prompts/rev-eng.md b/kiro/prompts/potr-rev-eng.md
similarity index 97%
rename from kiro/prompts/rev-eng.md
rename to kiro/prompts/potr-rev-eng.md
index 1974b05..0a35a19 100644
--- a/kiro/prompts/rev-eng.md
+++ b/kiro/prompts/potr-rev-eng.md
@@ -1,6 +1,6 @@
-# rev-eng — Generic API Reverse-Engineering Agent
+# potr-rev-eng — Generic API Reverse-Engineering Agent
 
-You are the **rev-eng** agent. Your job is to discover and document a target web
+You are the **potr-rev-eng** agent. Your job is to discover and document a target web
 application's internal API by driving it with Playwright and intercepting network
 traffic, so a `dev` agent can implement a typed TypeScript client from your docs.
 
diff --git a/kiro/prompts/bepower-setup.md b/kiro/prompts/potr-setup.md
similarity index 92%
rename from kiro/prompts/bepower-setup.md
rename to kiro/prompts/potr-setup.md
index cc7273b..88045fb 100644
--- a/kiro/prompts/bepower-setup.md
+++ b/kiro/prompts/potr-setup.md
@@ -1,6 +1,6 @@
-# bepower-setup — Kiro Configuration Agent
+# potr-setup — Kiro Configuration Agent
 
-You are the **bepower-setup agent**. Your job is to analyze a BePower project and generate the optimal `.kiro/` configuration for it.
+You are the **potr-setup agent**. Your job is to analyze a BePower project and generate the optimal `.kiro/` configuration for it.
 
 ## What You Do
 
diff --git a/kiro/prompts/upgrade-guardian.md b/kiro/prompts/potr-upgrade-guardian.md
similarity index 84%
rename from kiro/prompts/upgrade-guardian.md
rename to kiro/prompts/potr-upgrade-guardian.md
index 1ac4b3a..a3708e8 100644
--- a/kiro/prompts/upgrade-guardian.md
+++ b/kiro/prompts/potr-upgrade-guardian.md
@@ -1,7 +1,7 @@
-# upgrade-guardian — Dependency Upgrade Safety Agent (thin wrapper)
+# potr-upgrade-guardian — Dependency Upgrade Safety Agent (thin wrapper)
 
-You are the **upgrade-guardian** agent. You are a thin, read-only wrapper: the
-substance of your job lives in the **`upgrade-guardian` skill**. Your role is to
+You are the **potr-upgrade-guardian** agent. You are a thin, read-only wrapper: the
+substance of your job lives in the **`potr-upgrade-guardian` skill**. Your role is to
 provide the identity, the read-only guarantees, and to load and execute that skill.
 
 ## FIRST operative step — read the project context
@@ -14,7 +14,7 @@ real files — never assume. This is the first line of work, not an implicit one
 
 ## Then — load and run the skill
 
-Load the **`upgrade-guardian`** skill (via `skill_search`) and follow it end to
+Load the **`potr-upgrade-guardian`** skill (via `skill_search`) and follow it end to
 end. Do **not** reproduce its playbook here — the skill is the single source of
 truth for:
 - semver-scaled depth (patch / minor / major),
diff --git a/kiro/resources/functional-analyst/template-analisi-funzionale.md b/kiro/resources/potr-functional-analyst/template-analisi-funzionale.md
similarity index 100%
rename from kiro/resources/functional-analyst/template-analisi-funzionale.md
rename to kiro/resources/potr-functional-analyst/template-analisi-funzionale.md
diff --git a/kiro/resources/functional-analyst/template-matrice-funzionale.md b/kiro/resources/potr-functional-analyst/template-matrice-funzionale.md
similarity index 100%
rename from kiro/resources/functional-analyst/template-matrice-funzionale.md
rename to kiro/resources/potr-functional-analyst/template-matrice-funzionale.md
diff --git a/kiro/resources/functional-analyst/template-steering-architecture.md b/kiro/resources/potr-functional-analyst/template-steering-architecture.md
similarity index 100%
rename from kiro/resources/functional-analyst/template-steering-architecture.md
rename to kiro/resources/potr-functional-analyst/template-steering-architecture.md
diff --git a/kiro/resources/functional-analyst/template-steering-domain.md b/kiro/resources/potr-functional-analyst/template-steering-domain.md
similarity index 100%
rename from kiro/resources/functional-analyst/template-steering-domain.md
rename to kiro/resources/potr-functional-analyst/template-steering-domain.md
diff --git a/kiro/resources/functional-analyst/template-steering-roles.md b/kiro/resources/potr-functional-analyst/template-steering-roles.md
similarity index 100%
rename from kiro/resources/functional-analyst/template-steering-roles.md
rename to kiro/resources/potr-functional-analyst/template-steering-roles.md
diff --git a/kiro/skills/upgrade-guardian/SKILL.md b/kiro/skills/potr-upgrade-guardian/SKILL.md
similarity index 98%
rename from kiro/skills/upgrade-guardian/SKILL.md
rename to kiro/skills/potr-upgrade-guardian/SKILL.md
index 7b644fb..43a3fc2 100644
--- a/kiro/skills/upgrade-guardian/SKILL.md
+++ b/kiro/skills/potr-upgrade-guardian/SKILL.md
@@ -1,5 +1,5 @@
 ---
-name: upgrade-guardian
+name: potr-upgrade-guardian
 description: "Assess whether a dependency/framework upgrade is safe. Read-only worktree analysis of breaking changes, project impact, and verification, ending in a LOW/MEDIUM/HIGH verdict. Reusable by any agent via skill_search. Use before applying any dependency bump."
 ---
 
@@ -8,7 +8,7 @@ description: "Assess whether a dependency/framework upgrade is safe. Read-only w
 **Cognitive mode: Release-Safety Engineer (read-only)**
 
 This SKILL is the **core logic** of upgrade safety assessment. Any agent can load
-it on demand (`skill_search`); the `upgrade-guardian` agent is only a thin
+it on demand (`skill_search`); the `potr-upgrade-guardian` agent is only a thin
 read-only wrapper around it. An upgrade is a claim ("this is safe") until proven —
 prove it in isolation, then hand a reasoned verdict to the human. Never mutate the repo.
 
diff --git a/test/init-crew.test.ts b/test/init-crew.test.ts
index f80e0e2..99480d1 100644
--- a/test/init-crew.test.ts
+++ b/test/init-crew.test.ts
@@ -42,7 +42,12 @@ describe('init-crew command', () => {
     const ran = await bootstrapCrew();
 
     expect(ran).toBe(true);
-    expect(created).toEqual(['upgrade-guardian', 'rev-eng', 'bepower-setup', 'functional-analyst']);
+    expect(created).toEqual([
+      'potr-upgrade-guardian',
+      'potr-rev-eng',
+      'potr-setup',
+      'potr-functional-analyst',
+    ]);
   });
 
   it('skips members that already exist (idempotent)', async () => {
@@ -50,7 +55,10 @@ describe('init-crew command', () => {
     mockExec((cmd) => {
       if (cmd.includes('--version')) return { stdout: 'kirocrew 1.0.0' };
       if (cmd.includes('agent list')) {
-        return { stdout: 'NAME\nupgrade-guardian\nrev-eng\nbepower-setup\nfunctional-analyst\n' };
+        return {
+          stdout:
+            'NAME\npotr-upgrade-guardian\npotr-rev-eng\npotr-setup\npotr-functional-analyst\n',
+        };
       }
       if (cmd.includes('agent create')) {
         created.push(/--name '?([^' ]+)'?/.exec(cmd)?.[1] ?? '');
diff --git a/test/init-kiro.test.ts b/test/init-kiro.test.ts
index 7e31d9f..e89daef 100644
--- a/test/init-kiro.test.ts
+++ b/test/init-kiro.test.ts
@@ -34,19 +34,19 @@ describe('init-kiro command', () => {
     const kiroDir = join(tempDir, '.kiro');
 
     // Agents
-    expect(await fileExists(join(kiroDir, 'agents/bepower-setup.json'))).toBe(true);
-    expect(await fileExists(join(kiroDir, 'agents/functional-analyst.json'))).toBe(true);
-    expect(await fileExists(join(kiroDir, 'agents/upgrade-guardian.json'))).toBe(true);
-    expect(await fileExists(join(kiroDir, 'agents/rev-eng.json'))).toBe(true);
+    expect(await fileExists(join(kiroDir, 'agents/potr-setup.json'))).toBe(true);
+    expect(await fileExists(join(kiroDir, 'agents/potr-functional-analyst.json'))).toBe(true);
+    expect(await fileExists(join(kiroDir, 'agents/potr-upgrade-guardian.json'))).toBe(true);
+    expect(await fileExists(join(kiroDir, 'agents/potr-rev-eng.json'))).toBe(true);
 
     // Prompts
-    expect(await fileExists(join(kiroDir, 'prompts/bepower-setup.md'))).toBe(true);
-    expect(await fileExists(join(kiroDir, 'prompts/functional-analyst.md'))).toBe(true);
-    expect(await fileExists(join(kiroDir, 'prompts/upgrade-guardian.md'))).toBe(true);
-    expect(await fileExists(join(kiroDir, 'prompts/rev-eng.md'))).toBe(true);
+    expect(await fileExists(join(kiroDir, 'prompts/potr-setup.md'))).toBe(true);
+    expect(await fileExists(join(kiroDir, 'prompts/potr-functional-analyst.md'))).toBe(true);
+    expect(await fileExists(join(kiroDir, 'prompts/potr-upgrade-guardian.md'))).toBe(true);
+    expect(await fileExists(join(kiroDir, 'prompts/potr-rev-eng.md'))).toBe(true);
 
     // Resources
-    expect(await fileExists(join(kiroDir, 'resources/functional-analyst'))).toBe(true);
+    expect(await fileExists(join(kiroDir, 'resources/potr-functional-analyst'))).toBe(true);
 
     // Skills
     expect(await fileExists(join(kiroDir, 'skills/bepower-dev'))).toBe(true);