@givolt/i3-composer-agent 2.1.0 → 2.1.1

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.
Files changed (11) hide show
  1. package/.agents/plugins/marketplace.json +1 -1
  2. package/.claude-plugin/marketplace.json +1 -1
  3. package/.claude-plugin/plugin.json +1 -1
  4. package/.codex-plugin/plugin.json +1 -1
  5. package/README.md +12 -5
  6. package/bin/i3-composer-agent.cjs +5 -4
  7. package/bin/wizard.cjs +1 -0
  8. package/docs/codebuddy-setup.md +6 -1
  9. package/docs/workbuddy-setup.md +50 -36
  10. package/package.json +1 -1
  11. package/plugin.json +1 -1
package/.agents/plugins/marketplace.json CHANGED
@@ -6,7 +6,7 @@
6
6
  "plugins": [
7
7
  {
8
8
  "name": "i3-composer-agent",
9
- "version": "2.1.0",
9
+ "version": "2.1.1",
10
10
  "description": "Production-grade engineering skills for AI coding agents covering the development lifecycle from spec to ship.",
11
11
  "source": {
12
12
  "source": "local",
package/.claude-plugin/marketplace.json CHANGED
@@ -8,7 +8,7 @@
8
8
  "plugins": [
9
9
  {
10
10
  "name": "i3-composer-agent",
11
- "version": "2.1.0",
11
+ "version": "2.1.1",
12
12
  "source": "./",
13
13
  "description": "Production-grade engineering skills for AI coding agents covering the development lifecycle from spec to ship.",
14
14
  "homepage": "https://github.com/49780522/i3-composer-agent",
package/.claude-plugin/plugin.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "i3-composer-agent",
3
- "version": "2.1.0",
3
+ "version": "2.1.1",
4
4
  "description": "Production-grade engineering skills for AI coding agents covering the development lifecycle from spec to ship.",
5
5
  "author": {
6
6
  "name": "Givolt"
package/.codex-plugin/plugin.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "i3-composer-agent",
3
- "version": "2.1.0",
3
+ "version": "2.1.1",
4
4
  "description": "Production-grade engineering skills for AI coding agents covering the development lifecycle from spec to ship.",
5
5
  "author": {
6
6
  "name": "Givolt"
package/README.md CHANGED
@@ -1,4 +1,4 @@
1
- # i3 Composer Agent v2.1.0
1
+ # i3 Composer Agent v2.1.1
2
2
 
3
3
  **Intelligence. Integration. Innovation.**
4
4
 
@@ -13,7 +13,8 @@ Run in the project where you want to use the skills:
13
13
  npx @givolt/i3-composer-agent
14
14
  # Preselect a tool; the wizard still allows multiple selections:
15
15
  npx @givolt/i3-composer-agent --codebuddy
16
- npx @givolt/i3-composer-agent --workbuddy
16
+ # WorkBuddy desktop: use global scope for Skills discovery:
17
+ npx @givolt/i3-composer-agent --workbuddy --scope global
17
18
  ```
18
19
 
19
20
  The interactive terminal wizard offers multiple tools, project or global scope,
@@ -25,7 +26,7 @@ the choices. Directory presets are not an execution test of every host.
25
26
 
26
27
  Every selected tool receives all 25 skills and shared references.
27
28
  CodeBuddy, WorkBuddy and Claude Code also receive 9 short command workflows
28
- and 4 persona files. Other tools use their native skill support;
29
+ and 4 Agent role definitions. Other tools use their native skill support;
29
30
  short lifecycle commands depend on the host. Shared destinations are installed
30
31
  once. A standard MIT license accompanies the shared references.
31
32
  Reload the IDE window or start a new session after installation. See
@@ -36,9 +37,8 @@ For an explicit installation without prompts:
36
37
 
37
38
  ```bash
38
39
  npx @givolt/i3-composer-agent --agents codebuddy,codex --scope project --yes
39
- npx @givolt/i3-composer-agent --workbuddy --scope project --yes
40
- npx @givolt/i3-composer-agent --agents codebuddy,workbuddy --scope project --yes
41
40
  npx @givolt/i3-composer-agent --workbuddy --scope global --yes
41
+ npx @givolt/i3-composer-agent --agents codebuddy,workbuddy --scope global --yes
42
42
  npx @givolt/i3-composer-agent --claude --scope global --yes
43
43
  npx @givolt/i3-composer-agent --codebuddy --scope project --dry-run
44
44
  ```
@@ -47,6 +47,13 @@ CodeBuddy and WorkBuddy share one project installation under `.codebuddy/`.
47
47
  Existing `.workbuddy/` project settings are preserved. Global installations use
48
48
  separate `~/.codebuddy/` and `~/.workbuddy/` directories.
49
49
 
50
+ **WorkBuddy desktop: global installation is recommended.** In WorkBuddy 5.7.7,
51
+ project Commands are discoverable, but the desktop Skills list scans
52
+ `.workbuddy/skills/` rather than the shared `.codebuddy/skills/` destination.
53
+ Use `--workbuddy --scope global` for Skills list and input completion.
54
+ For both clients, you can install CodeBuddy at project scope and WorkBuddy at
55
+ global scope, or install both globally. See [WorkBuddy setup](docs/workbuddy-setup.md).
56
+
50
57
  Unchanged manifest-owned assets from the same version and scope are reused;
51
58
  adding a client merges its ID into the shared installation manifest. Modified
52
59
  files, unowned collisions and version upgrades require confirmation; use
package/bin/i3-composer-agent.cjs CHANGED
@@ -18,8 +18,8 @@ Install engineering skills with a multi-tool installation wizard.
18
18
  Usage:
19
19
  npx ${pkg.name}
20
20
  npx ${pkg.name} --codebuddy
21
- npx ${pkg.name} --workbuddy
22
- npx ${pkg.name} --agents codebuddy,workbuddy --scope project --yes
21
+ npx ${pkg.name} --workbuddy --scope global
22
+ npx ${pkg.name} --agents codebuddy,workbuddy --scope global --yes
23
23
  npx ${pkg.name} --agents codebuddy,codex --scope project --yes
24
24
  npx ${pkg.name} --prepare --claude --dir <directory>
25
25
  npx ${pkg.name} --extract --dir <directory>
@@ -27,7 +27,7 @@ Usage:
27
27
  Options:
28
28
  --agents <ids> Comma-separated tool IDs; multiple tools are supported
29
29
  --codebuddy Preselect CodeBuddy desktop IDE / CodeBuddy Code
30
- --workbuddy Preselect WorkBuddy (shared project / independent global)
30
+ --workbuddy Preselect WorkBuddy (global scope recommended)
31
31
  --codex Preselect Codex
32
32
  --claude Preselect Claude Code
33
33
  --scope <scope> project or global (or use --global / --local)
@@ -42,7 +42,8 @@ Options:
42
42
  --help Show this help
43
43
 
44
44
  The terminal wizard selects tools and scope, then installs native skill files.
45
- CodeBuddy, WorkBuddy and Claude Code also receive short commands and personas.
45
+ CodeBuddy, WorkBuddy and Claude Code also receive short commands and Agent roles.
46
+ WorkBuddy desktop: use global scope for Skills list and input completion.
46
47
  Other tools receive skills and references; command availability is host-specific.
47
48
  Use --prepare for complete plugins, including hooks and host registration.
48
49
  `;
package/bin/wizard.cjs CHANGED
@@ -39,6 +39,7 @@ async function choose(options, identity) {
39
39
  if (!agents.length) { agents = undefined; console.log('Choose at least one tool.'); }
40
40
  } catch (error) { console.log(error.message); }
41
41
  }
42
+ if (agents.includes('workbuddy')) console.log('WorkBuddy desktop: global installation is recommended for Skills list and input completion. Project Skills may be absent from the Skills list.');
42
43
  let scope = options.scope;
43
44
  while (!scope) {
44
45
  const input = await ask('Installation scope: 1. Project (current project), 2. Global (all projects) [1] (q cancels): ');
package/docs/codebuddy-setup.md CHANGED
@@ -40,7 +40,7 @@ For multiple tools or a noninteractive installation:
40
40
 
41
41
  ```bash
42
42
  npx @givolt/i3-composer-agent --agents codebuddy,codex --scope project --yes
43
- npx @givolt/i3-composer-agent --agents codebuddy,workbuddy --scope project --yes
43
+ npx @givolt/i3-composer-agent --agents codebuddy,workbuddy --scope global --yes
44
44
  npx @givolt/i3-composer-agent --codebuddy --scope global --yes
45
45
  ```
46
46
 
@@ -49,6 +49,11 @@ client first and adding the other at the same package version reuses unmodified
49
49
  owned files and merges the client IDs. Global WorkBuddy files use
50
50
  `~/.workbuddy/`, independently of `~/.codebuddy/`. See [WorkBuddy setup](workbuddy-setup.md).
51
51
 
52
+ For WorkBuddy desktop, global installation is recommended because WorkBuddy
53
+ 5.7.7 does not list the shared `.codebuddy/skills/` project Skills. You can keep
54
+ CodeBuddy at project scope and install WorkBuddy separately with
55
+ `--workbuddy --scope global`.
56
+
52
57
  CodeBuddy documents [IDE skills](https://www.codebuddy.cn/docs/ide/Features/Skills)
53
58
  and [IDE custom commands](https://www.codebuddy.cn/docs/ide/User-guide/Slash-Commands).
54
59
  The directory layout follows its [configuration directory reference](https://www.codebuddy.cn/docs/cli/codebuddy-dir).
package/docs/workbuddy-setup.md CHANGED
@@ -1,51 +1,40 @@
1
1
  # Using i3 Composer Agent with WorkBuddy
2
2
 
3
- ## Native installation
3
+ ## Recommended global installation
4
4
 
5
- Run inside your project:
5
+ Install WorkBuddy assets in its user configuration directory:
6
6
 
7
7
  ```bash
8
- npx @givolt/i3-composer-agent --workbuddy
8
+ npx @givolt/i3-composer-agent --workbuddy --scope global
9
9
  ```
10
10
 
11
- The terminal wizard preselects WorkBuddy and lets you add other clients before
12
- choosing project or global scope. For explicit installation:
11
+ The terminal wizard preselects WorkBuddy and confirms the global installation.
12
+ For installation without prompts:
13
13
 
14
14
  ```bash
15
- npx @givolt/i3-composer-agent --workbuddy --scope project --yes
16
- npx @givolt/i3-composer-agent --agents codebuddy,workbuddy --scope project --yes
17
15
  npx @givolt/i3-composer-agent --workbuddy --scope global --yes
16
+ npx @givolt/i3-composer-agent --agents codebuddy,workbuddy --scope global --yes
18
17
  ```
19
18
 
20
- | Selected clients | Project files | Global files |
21
- | --- | --- | --- |
22
- | CodeBuddy | `.codebuddy/` | `~/.codebuddy/` |
23
- | WorkBuddy | `.codebuddy/` | `~/.workbuddy/` |
24
- | CodeBuddy and WorkBuddy | One shared `.codebuddy/` installation | One installation in each client's directory |
25
-
26
- WorkBuddy natively discovers project Commands, Skills and personas in
27
- `.codebuddy/`. If your project already has `.workbuddy/`, i3 preserves its
28
- contents and adds `.codebuddy/` for the shared native files. Both directories may
29
- therefore exist in the same workspace.
19
+ Global WorkBuddy installation includes:
30
20
 
31
- Project installation includes:
21
+ - `~/.workbuddy/skills/`: all 25 Skills with their existing `i3-` IDs.
22
+ - `~/.workbuddy/commands/`: all 9 short `/i3-*` workflows.
23
+ - `~/.workbuddy/agents/`: all 4 Agents (role definitions).
24
+ - `~/.workbuddy/references/`: shared references and the standard MIT license.
25
+ - `~/.workbuddy/docs/agents.md`: Agent role documentation.
26
+ - `~/.workbuddy/.i3-composer-agent.json`: managed asset and client records.
32
27
 
33
- - `.codebuddy/skills/`: all 25 Skills with their existing `i3-` IDs.
34
- - `.codebuddy/commands/`: all 9 short `/i3-*` workflows.
35
- - `.codebuddy/agents/`: all 4 persona prompts.
36
- - `.codebuddy/references/`: shared references and the standard MIT license.
37
- - `.codebuddy/docs/agents.md`: persona documentation.
38
- - `.codebuddy/.i3-composer-agent.json`: managed asset and client records.
39
-
40
- Global WorkBuddy installation uses the same layout under `~/.workbuddy/`.
41
28
  If you use a separate WorkBuddy profile, set `WORKBUDDY_CONFIG_DIR` to its
42
29
  configuration directory when installing. The installer does not borrow
43
30
  `CODEBUDDY_CONFIG_DIR` for WorkBuddy. Open the corresponding profile in the host.
44
31
 
45
32
  ## Discovery and invocation
46
33
 
47
- Open the project in WorkBuddy and start a new chat after installation. Type `/`
48
- to inspect the project Commands, and inspect the Skills list. Examples:
34
+ Open your project in WorkBuddy and start a new chat after installation. Type `/`
35
+ to inspect Commands, and open the Skills list. Global installation resolves the
36
+ desktop Skills list issue observed in WorkBuddy 5.7.7 and confirmed by user testing.
37
+ Examples:
49
38
 
50
39
  ```text
51
40
  /i3-spec
@@ -63,30 +52,55 @@ so they work for either client. `/i3-ship` uses native subagents when available
63
52
  and reads the installed persona prompts sequentially otherwise. Skill content,
64
53
  `$ARGUMENTS`, workflow approval gates, and relative reference links are retained.
65
54
 
66
- The [WorkBuddy project documentation](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Project)
67
- describes these native project directories. The [task-bar command documentation](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Task-Bar)
55
+ The [task-bar command documentation](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Task-Bar)
68
56
  describes command discovery, and the [CLI command documentation](https://www.codebuddy.cn/docs/cli/slash-commands)
69
57
  describes Markdown commands and `$ARGUMENTS`.
70
58
 
59
+ ## Project installation and mixed clients
60
+
61
+ | Selected clients | Project files | Global files |
62
+ | --- | --- | --- |
63
+ | CodeBuddy | `.codebuddy/` | `~/.codebuddy/` |
64
+ | WorkBuddy | `.codebuddy/` (desktop Skills list limitation) | `~/.workbuddy/` (recommended) |
65
+ | CodeBuddy and WorkBuddy | One shared `.codebuddy/` installation | One installation in each client's directory |
66
+
67
+ Project installation remains available for shared `.codebuddy/` assets. However,
68
+ WorkBuddy 5.7.7 scans `.workbuddy/skills/` for its desktop Skills list, so Skills
69
+ installed at `.codebuddy/skills/` do not appear there even though Commands are
70
+ discoverable. The [WorkBuddy project documentation](https://www.codebuddy.cn/docs/workbuddy/From-Beginner-to-Expert-Guide/Function-Description/Project)
71
+ describes `.codebuddy/` paths; that documentation does not establish desktop
72
+ Skills list compatibility for this host version.
73
+
74
+ For CodeBuddy at project scope and WorkBuddy at global scope, run:
75
+
76
+ ```bash
77
+ npx @givolt/i3-composer-agent --codebuddy --scope project --yes
78
+ npx @givolt/i3-composer-agent --workbuddy --scope global --yes
79
+ ```
80
+
81
+ Existing `.workbuddy/` project settings are preserved. A shared project
82
+ installation may add `.codebuddy/`, so both directories can exist in a workspace.
83
+
71
84
  ## Adding a second client or upgrading
72
85
 
73
- Either client can be installed first. Installing the other at the same package
74
- version and scope reuses unmodified manifest-owned files and merges the client
75
- IDs. It does not create a second project copy. Missing files are restored;
86
+ When both clients use project scope, either can be installed first. Installing
87
+ the other at the same package version and scope reuses unmodified manifest-owned
88
+ files and merges the client IDs. It does not create a second project copy. Global
89
+ installations remain independent. Missing files are restored;
76
90
  unrelated settings and custom command filenames are preserved.
77
91
 
78
92
  Review an upgrade or conflict before replacing files:
79
93
 
80
94
  ```bash
81
- npx @givolt/i3-composer-agent --workbuddy --scope project --dry-run
82
- npx @givolt/i3-composer-agent --workbuddy --scope project --yes --force
95
+ npx @givolt/i3-composer-agent --workbuddy --scope global --dry-run
96
+ npx @givolt/i3-composer-agent --workbuddy --scope global --yes --force
83
97
  ```
84
98
 
85
99
  Modified assets, unowned filename collisions and different versions require
86
100
  confirmation or `--force`. Successful replacements remove old files and managed
87
101
  historical backups. If installation fails, the previous files are restored.
88
102
 
89
- Native installation provides Commands, Skills and personas. It does not register
103
+ Native installation provides Commands, Skills and Agent role definitions. It does not register
90
104
  a WorkBuddy plugin or enable plugin hooks; `--prepare --workbuddy` is unsupported.
91
105
  File installation and command discovery are separate from model execution and
92
106
  workflow acceptance in the host.
package/package.json CHANGED
@@ -98,7 +98,7 @@
98
98
  "LICENSE"
99
99
  ]
100
100
  },
101
- "version": "2.1.0",
101
+ "version": "2.1.1",
102
102
  "repository": {
103
103
  "type": "git",
104
104
  "url": "https://github.com/49780522/i3-composer-agent.git"
package/plugin.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "i3-composer-agent",
3
- "version": "2.1.0",
3
+ "version": "2.1.1",
4
4
  "description": "Production-grade engineering skills for AI coding agents covering the development lifecycle from spec to ship.",
5
5
  "homepage": "https://github.com/49780522/i3-composer-agent",
6
6
  "repository": "https://github.com/49780522/i3-composer-agent"