the-super-power-team 0.12.0 → 0.13.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "team",
3
- "version": "0.12.0",
3
+ "version": "0.13.0",
4
4
  "description": "Eight agents that take a ticket from idea to pull request, with your approval after every step. Nobody in the team commits, pushes or posts — you do.",
5
5
  "author": { "name": "Waleed Al Shaikhli" },
6
6
  "homepage": "https://github.com/al-shaikhli-w/Pit-Crew",
package/README.md CHANGED
@@ -1,3 +1,4 @@
1
+ <!-- Generated from the repository README by scripts/build-npm-readme.js. Edit README.md, not this file. -->
1
2
  <p align="center">
2
3
  <img src="https://raw.githubusercontent.com/al-shaikhli-w/Pit-Crew/master/assets/mark-light.svg" alt="The Super Power Team" width="64" height="64">
3
4
  </p>
@@ -7,7 +8,7 @@
7
8
  <p align="center"><strong>An agent team for Claude Code that takes a ticket from idea to pull request — while you stay in the driver's seat.</strong></p>
8
9
 
9
10
  <p align="center">
10
- <img src="https://img.shields.io/badge/version-0.12.0-155eef?style=flat-square" alt="version 0.12.0">
11
+ <img src="https://img.shields.io/badge/version-0.13.0-155eef?style=flat-square" alt="version 0.13.0">
11
12
  <a href="https://www.npmjs.com/package/the-super-power-team"><img src="https://img.shields.io/npm/v/the-super-power-team?style=flat-square&color=155eef&label=npm" alt="npm package"></a>
12
13
  <img src="https://img.shields.io/badge/Claude%20Code-plugin-155eef?style=flat-square" alt="Claude Code plugin">
13
14
  <a href="https://github.com/al-shaikhli-w/Pit-Crew/blob/master/LICENSE"><img src="https://img.shields.io/badge/license-MIT-155eef?style=flat-square" alt="MIT license"></a>
@@ -48,7 +49,8 @@ Start with the [Quick start](#quick-start) below.
48
49
  | **Where it keeps its work** | Plain markdown files in `.claude/team/` inside your project. |
49
50
  | **Trackers** | Linear, Jira, Notion, GitHub Issues, any connected tool, or a local board. |
50
51
  | **Runs on** | Windows, macOS, Linux — terminal, desktop app or IDE extension. |
51
- | **Install** | `/plugin marketplace add al-shaikhli-w/Pit-Crew` then `/plugin install team@my-super-team` |
52
+ | **Install** | `npx the-super-power-team` |
53
+ | **Update** | `npx the-super-power-team@latest` |
52
54
  | **npm** | [`the-super-power-team`](https://www.npmjs.com/package/the-super-power-team) |
53
55
  | **License** | MIT |
54
56
 
@@ -101,33 +103,47 @@ the crew does the work.
101
103
 
102
104
  ## Quick start
103
105
 
104
- **Requirements:** Claude Code (terminal, desktop app or IDE extension), `bash`
105
- (on Windows: Git for Windows, which Claude Code normally uses anyway), and
106
- [`gh`](https://cli.github.com/) signed in for pull-request rounds. Cloud
107
- sessions do not load local plugins.
106
+ **Requirements:**
108
107
 
109
- Install the plugin in Claude Code:
108
+ | You need | Why |
109
+ | --- | --- |
110
+ | [Node.js](https://nodejs.org/) 18 or newer | Runs the one-line installer (`npx`). |
111
+ | [Claude Code](https://claude.com/claude-code) | Terminal, desktop app or IDE extension. Cloud sessions do not load local plugins. |
112
+ | `bash` | Runs the dashboard hooks. On Windows: Git for Windows, which Claude Code normally uses anyway. |
113
+ | [`gh`](https://cli.github.com/) signed in | Only for pull-request rounds (`/team-work pr`). |
110
114
 
111
- ```text
112
- /plugin marketplace add al-shaikhli-w/Pit-Crew
113
- /plugin install team@my-super-team
114
- ```
115
+ ### 1. Install
115
116
 
116
- <details>
117
- <summary><strong>Prefer npm?</strong> The same plugin files are published as <code>the-super-power-team</code>.</summary>
117
+ Run this in any terminal:
118
118
 
119
119
  ```bash
120
- npm install the-super-power-team
120
+ npx the-super-power-team
121
121
  ```
122
122
 
123
- The package holds the plugin folder (`.claude-plugin`, `agents`, `skills`,
124
- `hooks`). Claude Code loads plugins through a marketplace, so the marketplace
125
- commands above remain the recommended way to install and update. Use the npm
126
- package to pin a version, mirror it internally, or inspect the files.
123
+ That is the whole install. The installer:
124
+
125
+ 1. copies the plugin to `~/.claude/the-super-power-team/`;
126
+ 2. registers it with Claude Code as `team@the-super-power-team`;
127
+ 3. tells you what to do next.
128
+
129
+ No git, no GitHub account and no `/plugin` commands needed.
130
+
131
+ <details>
132
+ <summary>The <code>claude</code> command is not on your PATH?</summary>
133
+
134
+ The installer still copies the files, then prints two commands. Paste them
135
+ into Claude Code:
136
+
137
+ ```text
138
+ /plugin marketplace add ~/.claude/the-super-power-team
139
+ /plugin install team@the-super-power-team
140
+ ```
127
141
 
128
142
  </details>
129
143
 
130
- Start a new session in your project, then set it up once:
144
+ ### 2. Set up your project
145
+
146
+ Start a new Claude Code session in your project, then set it up once:
131
147
 
132
148
  ```text
133
149
  /team-setup
@@ -173,29 +189,29 @@ Learn these three commands first:
173
189
 
174
190
  ```text
175
191
  /team-work ABC-123
176
- │
177
- ▼
178
- 1 · product-manager ── requirements ─────────────── you approve ◄─┐
179
- │ │ not OK
180
- 2 · researcher ─────── feasibility, code first ──── you approve ──┘
181
- │
182
- 3 · project-manager ── plan ──────────────────────── you approve
183
- │
184
- ├── you create the branch (the team gives you the commands)
185
- │
186
- 4 · developer-lead ─── one task at a time ────────── you approve each task ◄──┐
187
- │ │
188
- 5 · qa-engineer ────── CI · local review · code review · security ─ FAIL ─────┤
189
- │ PASS │
190
- 5b· reviewer ───────── sees only requirements + diff ─ changes ───────────────┘
191
- │ PASS
192
- 6 · PR title + commit message
193
- │
194
- ▼
195
- you commit, push and open the PR
192
+ │
193
+ ▼
194
+ 1 product-manager requirements ✋ approve
195
+ │
196
+ 2 researcher feasibility ✋ approve
197
+ │ not feasible → 1
198
+ 3 project-manager plan ✋ approve
199
+ │
200
+ ├─ you create the branch
201
+ │
202
+ 4 developer-lead one task at a time ✋ each task
203
+ │
204
+ 5 qa-engineer CI, reviews, security
205
+ │ FAIL → 4
206
+ 5b reviewer requirements + diff
207
+ │ changes → 4
208
+ 6 hand-over PR title + commit
209
+ │
210
+ ▼
211
+ you commit, push and open the PR
196
212
  ```
197
213
 
198
- Every diamond is a stop. Each step has a narrow job:
214
+ Every ✋ is a stop: nothing moves on until you approve. Each step has a narrow job:
199
215
 
200
216
  | Step | Who | Saved as | You do |
201
217
  | --- | --- | --- | --- |
@@ -424,27 +440,33 @@ back.
424
440
 
425
441
  ## Status and updates
426
442
 
427
- Update the plugin, then the crew's files in each project:
443
+ | Task | Command |
444
+ | --- | --- |
445
+ | **Update to the newest version** | `npx the-super-power-team@latest` |
446
+ | **Install a specific version** | `npx the-super-power-team@0.13.0` |
447
+ | **See which version you have** | `claude plugin list` |
448
+ | **Uninstall** | `npx the-super-power-team uninstall` |
449
+ | **Help** | `npx the-super-power-team help` |
428
450
 
429
- ```bash
430
- claude plugin marketplace update my-super-team
431
- claude plugin update team@my-super-team
432
- ```
451
+ After an update, start a new session and run `/team-update` in each project.
452
+ It shows what changed — new profile fields, the dashboard page, new sections
453
+ for your own agents — and applies only what you approve. Your project
454
+ documents and ticket work are never touched. `/team-doctor` warns when the
455
+ files are older than the plugin.
433
456
 
434
- Start a new session and run `/team-update`. It shows what changed — new
435
- profile fields, the dashboard page, new sections for your own agents — and
436
- applies only what you approve. Your project documents and ticket work are never
437
- touched. `/team-doctor` warns when the files are older than the plugin.
457
+ Uninstalling removes the plugin and `~/.claude/the-super-power-team/`; the
458
+ `.claude/team/` files in your projects stay.
438
459
 
439
- Auto-update is off for community marketplaces; you can turn it on in `/plugin`
440
- under Marketplaces.
460
+ See what changed in each version in the [Changelog](https://github.com/al-shaikhli-w/Pit-Crew/blob/master/CHANGELOG.md).
441
461
 
442
462
  ### Troubleshooting
443
463
 
444
464
  | Problem | Fix |
445
465
  | --- | --- |
446
466
  | Something does not work | `/team-doctor`, then `/team-doctor fix` |
447
- | `/team-work` is unknown | Run `/plugin`, check that `team` is installed and enabled, start a new session |
467
+ | `npx` is not found | Install [Node.js](https://nodejs.org/) 18 or newer, open a new terminal |
468
+ | `/team-work` is unknown | Run `npx the-super-power-team` again, then start a new session; `claude plugin list` should show `team@the-super-power-team` |
469
+ | Commands appear twice | You also have the older GitHub install: `claude plugin uninstall team@my-super-team` |
448
470
  | An agent cannot read tickets | Connect your tracker (`/mcp`), or set it to `GitHub Issues` or `none` in `.claude/team/team.md` |
449
471
  | An agent uses an old command or path | `/team-work sync` |
450
472
  | Crew files show up in `git status` | Run `/team-setup` again and choose a git option, or add `.claude/team/` to `.git/info/exclude` |
package/bin/install.js ADDED
@@ -0,0 +1,199 @@
1
+ #!/usr/bin/env node
2
+ // The Super Power Team — npm installer for the Claude Code plugin.
3
+ //
4
+ // npx the-super-power-team install, or update to this version
5
+ // npx the-super-power-team uninstall remove the plugin and its files
6
+ // npx the-super-power-team help show this help
7
+ //
8
+ // Claude Code installs plugins from marketplaces. This script copies the
9
+ // plugin from the npm package into a local marketplace folder in
10
+ // ~/.claude/the-super-power-team and registers it with the `claude` CLI.
11
+ // No git, GitHub account or /plugin commands needed.
12
+
13
+ 'use strict';
14
+
15
+ const fs = require('fs');
16
+ const os = require('os');
17
+ const path = require('path');
18
+ const { spawnSync } = require('child_process');
19
+
20
+ const pkg = require('../package.json');
21
+
22
+ const MARKETPLACE = 'the-super-power-team';
23
+ const PLUGIN = 'team';
24
+ const PLUGIN_ID = `${PLUGIN}@${MARKETPLACE}`;
25
+ const OLD_PLUGIN_ID = 'team@my-super-team';
26
+ const PKG_ROOT = path.resolve(__dirname, '..');
27
+ const PLUGIN_PARTS = ['.claude-plugin', 'agents', 'skills', 'hooks'];
28
+ const HOME_DIR = path.join(os.homedir(), '.claude', MARKETPLACE);
29
+ const PLUGIN_DIR = path.join(HOME_DIR, 'plugins', PLUGIN);
30
+
31
+ const isTTY = process.stdout.isTTY;
32
+ const c = (code, s) => (isTTY ? `\x1b[${code}m${s}\x1b[0m` : s);
33
+ const bold = (s) => c(1, s);
34
+ const dim = (s) => c(2, s);
35
+ const green = (s) => c(32, s);
36
+ const yellow = (s) => c(33, s);
37
+ const red = (s) => c(31, s);
38
+
39
+ const step = (s) => console.log(`${green('›')} ${s}`);
40
+ const warn = (s) => console.log(`${yellow('!')} ${s}`);
41
+ const fail = (s) => {
42
+ console.error(`${red('✗')} ${s}`);
43
+ process.exit(1);
44
+ };
45
+
46
+ function claude(args, { quiet = false } = {}) {
47
+ const r = spawnSync('claude', args, {
48
+ encoding: 'utf8',
49
+ shell: process.platform === 'win32',
50
+ stdio: quiet ? 'pipe' : ['ignore', 'pipe', 'pipe'],
51
+ });
52
+ return { ok: r.status === 0, out: (r.stdout || '').trim(), err: (r.stderr || r.error?.message || '').trim() };
53
+ }
54
+
55
+ function claudeJson(args) {
56
+ const r = claude([...args, '--json'], { quiet: true });
57
+ if (!r.ok) return [];
58
+ try {
59
+ return JSON.parse(r.out);
60
+ } catch {
61
+ return [];
62
+ }
63
+ }
64
+
65
+ function hasClaude() {
66
+ return claude(['--version'], { quiet: true }).ok;
67
+ }
68
+
69
+ function copyPlugin() {
70
+ fs.rmSync(PLUGIN_DIR, { recursive: true, force: true });
71
+ fs.mkdirSync(PLUGIN_DIR, { recursive: true });
72
+ for (const part of PLUGIN_PARTS) {
73
+ const from = path.join(PKG_ROOT, part);
74
+ if (!fs.existsSync(from)) fail(`Package is incomplete: missing ${part}`);
75
+ fs.cpSync(from, path.join(PLUGIN_DIR, part), { recursive: true });
76
+ }
77
+
78
+ const manifest = {
79
+ name: MARKETPLACE,
80
+ owner: { name: typeof pkg.author === 'string' ? pkg.author : 'The Super Power Team' },
81
+ description: 'The Super Power Team, installed from npm.',
82
+ plugins: [
83
+ {
84
+ name: PLUGIN,
85
+ source: `./plugins/${PLUGIN}`,
86
+ version: pkg.version,
87
+ description: pkg.description,
88
+ },
89
+ ],
90
+ };
91
+ fs.mkdirSync(path.join(HOME_DIR, '.claude-plugin'), { recursive: true });
92
+ fs.writeFileSync(
93
+ path.join(HOME_DIR, '.claude-plugin', 'marketplace.json'),
94
+ JSON.stringify(manifest, null, 2) + '\n'
95
+ );
96
+ }
97
+
98
+ function printManual() {
99
+ console.log(`
100
+ ${bold('Finish in Claude Code')} ${dim('(the `claude` command was not found on your PATH)')}
101
+
102
+ /plugin marketplace add ${HOME_DIR}
103
+ /plugin install ${PLUGIN_ID}
104
+
105
+ Then start a new session and run ${bold('/team-setup')}.`);
106
+ }
107
+
108
+ function install() {
109
+ console.log(`\n${bold('The Super Power Team')} ${dim('v' + pkg.version)}\n`);
110
+
111
+ step(`Copying the plugin to ${HOME_DIR}`);
112
+ copyPlugin();
113
+
114
+ if (!hasClaude()) {
115
+ printManual();
116
+ return;
117
+ }
118
+
119
+ const marketplaces = claudeJson(['plugin', 'marketplace', 'list']);
120
+ const known = marketplaces.some((m) => m.name === MARKETPLACE);
121
+
122
+ if (known) {
123
+ step('Refreshing the marketplace');
124
+ const r = claude(['plugin', 'marketplace', 'update', MARKETPLACE]);
125
+ if (!r.ok) fail(`Could not refresh the marketplace:\n${r.err || r.out}`);
126
+ } else {
127
+ step('Adding the marketplace to Claude Code');
128
+ const r = claude(['plugin', 'marketplace', 'add', HOME_DIR]);
129
+ if (!r.ok) fail(`Could not add the marketplace:\n${r.err || r.out}`);
130
+ }
131
+
132
+ const plugins = claudeJson(['plugin', 'list']);
133
+ const installed = plugins.find((p) => p.id === PLUGIN_ID);
134
+ const verb = installed ? 'update' : 'install';
135
+
136
+ step(installed ? `Updating ${PLUGIN_ID} (was ${installed.version})` : `Installing ${PLUGIN_ID}`);
137
+ const r = claude(['plugin', verb, PLUGIN_ID]);
138
+ if (!r.ok) fail(`Could not ${verb} the plugin:\n${r.err || r.out}`);
139
+
140
+ if (plugins.some((p) => p.id === OLD_PLUGIN_ID)) {
141
+ warn(
142
+ `The GitHub version (${OLD_PLUGIN_ID}) is also installed. Remove it to avoid duplicate commands:\n` +
143
+ ` claude plugin uninstall ${OLD_PLUGIN_ID}`
144
+ );
145
+ }
146
+
147
+ console.log(`
148
+ ${green('✓')} ${bold(installed ? 'Updated.' : 'Installed.')}
149
+
150
+ Next:
151
+ 1. Start a new Claude Code session in your project.
152
+ 2. Run ${bold(installed ? '/team-update' : '/team-setup')}${installed ? ' to bring the project files up to date.' : ' once.'}
153
+ 3. Run ${bold('/team-work')} to start.
154
+ `);
155
+ }
156
+
157
+ function uninstall() {
158
+ console.log(`\n${bold('The Super Power Team')} — uninstall\n`);
159
+ if (hasClaude()) {
160
+ const plugins = claudeJson(['plugin', 'list']);
161
+ if (plugins.some((p) => p.id === PLUGIN_ID)) {
162
+ step(`Uninstalling ${PLUGIN_ID}`);
163
+ const r = claude(['plugin', 'uninstall', PLUGIN_ID]);
164
+ if (!r.ok) warn(r.err || r.out);
165
+ }
166
+ const marketplaces = claudeJson(['plugin', 'marketplace', 'list']);
167
+ if (marketplaces.some((m) => m.name === MARKETPLACE)) {
168
+ step('Removing the marketplace');
169
+ const r = claude(['plugin', 'marketplace', 'remove', MARKETPLACE]);
170
+ if (!r.ok) warn(r.err || r.out);
171
+ }
172
+ } else {
173
+ warn('`claude` not found. In Claude Code, run:');
174
+ console.log(` /plugin uninstall ${PLUGIN_ID}\n /plugin marketplace remove ${MARKETPLACE}`);
175
+ }
176
+ step(`Deleting ${HOME_DIR}`);
177
+ fs.rmSync(HOME_DIR, { recursive: true, force: true });
178
+ console.log(`\n${green('✓')} Removed. Your projects' .claude/team/ files were not touched.\n`);
179
+ }
180
+
181
+ function help() {
182
+ console.log(`
183
+ ${bold('The Super Power Team')} ${dim('v' + pkg.version)}
184
+
185
+ Usage:
186
+ npx the-super-power-team Install, or update to this version
187
+ npx the-super-power-team@latest Update to the newest version
188
+ npx the-super-power-team uninstall Remove the plugin
189
+ npx the-super-power-team help Show this help
190
+
191
+ Plugin files: ${HOME_DIR}
192
+ `);
193
+ }
194
+
195
+ const cmd = (process.argv[2] || 'install').toLowerCase();
196
+ if (cmd === 'install' || cmd === 'update') install();
197
+ else if (cmd === 'uninstall' || cmd === 'remove') uninstall();
198
+ else if (cmd === 'help' || cmd === '--help' || cmd === '-h') help();
199
+ else fail(`Unknown command "${cmd}". Run: npx the-super-power-team help`);
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "the-super-power-team",
3
- "version": "0.12.0",
3
+ "version": "0.13.0",
4
4
  "description": "The Super Power Team: eight Claude Code agents that take a ticket from idea to pull request, with your approval after every step.",
5
5
  "license": "MIT",
6
6
  "author": "Waleed Al Shaikhli",
@@ -12,6 +12,15 @@
12
12
  "bugs": {
13
13
  "url": "https://github.com/al-shaikhli-w/Pit-Crew/issues"
14
14
  },
15
+ "bin": {
16
+ "the-super-power-team": "bin/install.js"
17
+ },
18
+ "engines": {
19
+ "node": ">=18"
20
+ },
21
+ "scripts": {
22
+ "prepublishOnly": "node ../../scripts/build-npm-readme.js"
23
+ },
15
24
  "keywords": [
16
25
  "claude-code",
17
26
  "claude-code-plugin",
@@ -25,5 +34,12 @@
25
34
  "jira",
26
35
  "github"
27
36
  ],
28
- "files": [".claude-plugin", "agents", "skills", "hooks", "README.md"]
37
+ "files": [
38
+ ".claude-plugin",
39
+ "agents",
40
+ "skills",
41
+ "hooks",
42
+ "bin",
43
+ "README.md"
44
+ ]
29
45
  }
@@ -16,13 +16,14 @@ The plugin itself is updated by Claude Code, not by this skill. This skill only
16
16
  - **Installed:** `version` in this plugin's `.claude-plugin/plugin.json`, two folders up from this skill.
17
17
  - **Project:** `Team version` in `team.md`. Missing means the project was set up before 0.11.0.
18
18
  - Same version and argument is not `check`: still run the comparison below — files can drift by hand — but say the versions match.
19
- - Project newer than installed: say the plugin is older than this project's files, give the commands to update it, and stop:
19
+ - Project newer than installed: say the plugin is older than this project's files, give the command to update it, and stop:
20
20
 
21
21
  ```text
22
- claude plugin marketplace update my-super-team
23
- claude plugin update team@my-super-team
22
+ npx the-super-power-team@latest
24
23
  ```
25
24
 
25
+ If `claude plugin list` shows `team@my-super-team` (the older GitHub install) instead, the commands are `claude plugin marketplace update my-super-team` and `claude plugin update team@my-super-team`.
26
+
26
27
  Then a new session, so Claude Code loads the new agents and skills.
27
28
 
28
29
  ## 2. Compare — read only