@event4u/agent-config 2.0.0 → 2.1.0

package/.agent-src/commands/fix/{pr-bots.md → pr-bot-comments.md}

@@ -1,7 +1,7 @@
 ---
-name: fix:pr-bots
+name: fix:pr-bot-comments
 cluster: fix
-sub: pr-bots
+sub: pr-bot-comments
 skills: [php-coder, quality-tools]
 description: Fix and reply to bot review comments (Copilot, Augment, Greptile, etc.) on a GitHub PR
 disable-model-invocation: true
@@ -11,7 +11,7 @@ suggestion:
   trigger_context: "open PR with bot review comments unresolved"
 ---
 
-# /fix pr-bots
+# /fix pr-bot-comments
 ## Input
 
 The user may or may not provide a PR URL.

package/.agent-src/commands/fix/{pr.md → pr-comments.md}

@@ -1,7 +1,7 @@
 ---
-name: fix:pr
+name: fix:pr-comments
 cluster: fix
-sub: pr
+sub: pr-comments
 skills: [php-coder]
 description: Fix and reply to all open review comments (bots + human reviewers) on a GitHub PR
 disable-model-invocation: true
@@ -11,8 +11,8 @@ suggestion:
   trigger_context: "open PR with unresolved comments (bot + human)"
 ---
 
-# /fix pr
-This command runs `/fix pr-bots` and `/fix pr-developers` in sequence on the same PR.
+# /fix pr-comments
+This command runs `/fix pr-bot-comments` and `/fix pr-developer-comments` in sequence on the same PR.
 
 ## Input
 
@@ -45,14 +45,14 @@ The chosen mode applies to **both** phases.
 
 ### Phase 1: Bot comments
 
-Follow the full `/fix pr-bots` instructions (see `commands/fix/pr-bots.md`).
+Follow the full `/fix pr-bot-comments` instructions (see `commands/fix/pr-bot-comments.md`).
 Use the already-confirmed PR and mode — do not ask again.
 
 Report when done: "Bot comments done. Continuing with reviewer comments..."
 
 ### Phase 2: Developer comments
 
-Follow the full `/fix pr-developers` instructions (see `commands/fix/pr-developers.md`).
+Follow the full `/fix pr-developer-comments` instructions (see `commands/fix/pr-developer-comments.md`).
 Use the same PR and mode.
 
 ### After both phases

package/.agent-src/commands/fix/{pr-developers.md → pr-developer-comments.md}

@@ -1,7 +1,7 @@
 ---
-name: fix:pr-developers
+name: fix:pr-developer-comments
 cluster: fix
-sub: pr-developers
+sub: pr-developer-comments
 skills: [php-coder]
 description: Fix and reply to human reviewer comments on a GitHub PR
 disable-model-invocation: true
@@ -11,7 +11,7 @@ suggestion:
   trigger_context: "open PR with unresolved human-reviewer comments"
 ---
 
-# /fix pr-developers
+# /fix pr-developer-comments
 ## Input
 
 The user may or may not provide a PR URL.

package/.agent-src/commands/fix.md

@@ -22,9 +22,9 @@ with a single entry point + sub-command dispatch.
 | `/fix refs` | `commands/fix/refs.md` | Find and fix broken cross-references in `.augment/` and `agents/` |
 | `/fix portability` | `commands/fix/portability.md` | Find and fix project-specific references in shared `.augment/` files |
 | `/fix seeder` | `commands/fix/seeder.md` | Scan seeder data files for broken FK references |
-| `/fix pr` | `commands/fix/pr.md` | Fix and reply to **all** open review comments (bots + humans) |
-| `/fix pr-bots` | `commands/fix/pr-bots.md` | Fix and reply to **bot** review comments only |
-| `/fix pr-developers` | `commands/fix/pr-developers.md` | Fix and reply to **human** reviewer comments only |
+| `/fix pr-comments` | `commands/fix/pr-comments.md` | Fix and reply to **all** open review comments (bots + humans) |
+| `/fix pr-bot-comments` | `commands/fix/pr-bot-comments.md` | Fix and reply to **bot** review comments only |
+| `/fix pr-developer-comments` | `commands/fix/pr-developer-comments.md` | Fix and reply to **human** reviewer comments only |
 
 Sub-command names match the locked contract in
 [`docs/contracts/command-clusters.md`](../docs/contracts/command-clusters.md).
@@ -41,9 +41,9 @@ Sub-command names match the locked contract in
    > 2. refs — fix broken cross-refs in agent docs
    > 3. portability — purge project-specific refs from shared package
    > 4. seeder — scan seeders for broken FK references
-   > 5. pr — address all open review comments
-   > 6. pr-bots — address bot reviewer comments only
-   > 7. pr-developers — address human reviewer comments only
+   > 5. pr-comments — address all open review comments
+   > 6. pr-bot-comments — address bot reviewer comments only
+   > 7. pr-developer-comments — address human reviewer comments only
 
 ## Rules
 

package/.agent-src/contexts/communication/rules-auto/slash-command-routing-policy-mechanics.md

@@ -4,7 +4,7 @@ Lookup table for the `slash-command-routing-policy` rule. Lists the
 locked clusters and their sub-commands so the rule itself can stay at
 its current LOC while still reflecting the full surface. Source of
 truth for the cluster names is
-[`docs/contracts/command-clusters.md`](../../../../../../docs/contracts/command-clusters.md);
+[`docs/contracts/command-clusters.md`](../../../../../docs/contracts/command-clusters.md);
 this file mirrors that contract for runtime lookup. Linter:
 `scripts/check_cluster_patterns.py` (verifies dispatcher shape).
 
@@ -12,7 +12,7 @@ this file mirrors that contract for runtime lookup. Linter:
 
 | Cluster | Phase | Sub-commands | Replaces                                                                                                                                        |
 |---|:-:|---|-------------------------------------------------------------------------------------------------------------------------------------------------|
-| `/fix` | 1 | `ci` · `pr` · `pr-bots` · `pr-developers` · `portability` · `refs` · `seeder` | `/fix-ci` · `/fix-pr-comments` · `/fix-pr-bot-comments` · `/fix-pr-developer-comments` · `/fix-portability` · `/fix-references` · `/fix-seeder` |
+| `/fix` | 1 | `ci` · `pr-comments` · `pr-bot-comments` · `pr-developer-comments` · `portability` · `refs` · `seeder` | `/fix-ci` · `/fix-pr-comments` · `/fix-pr-bot-comments` · `/fix-pr-developer-comments` · `/fix-portability` · `/fix-references` · `/fix-seeder` |
 | `/optimize` | 1 | `agents` · `augmentignore` · `rtk` · `skills` | `/optimize-agents` · `/optimize-augmentignore` · `/optimize-rtk-filters` · `/optimize-skills`                                                   |
 | `/feature` | 1 | `explore` · `plan` · `refactor` · `roadmap` | `/feature-explore` · `/feature-plan` · `/feature-refactor` · `/feature-roadmap`                                                                 |
 | `/chat-history` | 2 | `show` | `/chat-history` (legacy status) — `resume` / `clear` / `checkpoint` removed in `road-to-chat-history-hook-only`                                 |

package/.claude-plugin/marketplace.json

@@ -6,7 +6,7 @@
   },
   "metadata": {
     "description": "Shared agent configuration \u2014 skills for AI coding tools (Claude Code, Augment, Cursor, Cline, Windsurf, Gemini CLI).",
-    "version": "2.0.0"
+    "version": "2.1.0"
   },
   "plugins": [
     {
@@ -112,9 +112,9 @@
         "./.claude/skills/fix",
         "./.claude/skills/fix-ci",
         "./.claude/skills/fix-portability",
-        "./.claude/skills/fix-pr",
-        "./.claude/skills/fix-pr-bots",
-        "./.claude/skills/fix-pr-developers",
+        "./.claude/skills/fix-pr-bot-comments",
+        "./.claude/skills/fix-pr-comments",
+        "./.claude/skills/fix-pr-developer-comments",
         "./.claude/skills/fix-refs",
         "./.claude/skills/fix-seeder",
         "./.claude/skills/flux",

package/CHANGELOG.md

@@ -318,6 +318,37 @@ our recommendation order, not its support status.
   users" tension without removing any path that an existing user
   might rely on.
 
+## [2.1.0](https://github.com/event4u-app/agent-config/compare/2.0.0...2.1.0) (2026-05-12)
+
+### Features
+
+* **wrapper:** add npx fallback and sanitize wrapper error test ([9f4326b](https://github.com/event4u-app/agent-config/commit/9f4326bffc59d79e4421b0cd8966c99348afe1e6))
+* **installer:** add source-repo guard and drop composer/global paths ([5388de2](https://github.com/event4u-app/agent-config/commit/5388de2598ea668a8671f49bd7bacd4866ed1c33))
+
+### Documentation
+
+* **installation:** add Upgrading from v1 section ([f35df4b](https://github.com/event4u-app/agent-config/commit/f35df4b9667eb848ce2ec47f4a7c550b1bba4054))
+* align install guides with v2 npx-only flow ([e841a14](https://github.com/event4u-app/agent-config/commit/e841a14cdbb6691433976c57ff9b28b3ec4992ad))
+* **readme:** collapse plugin-install table to one-liner ([b3407bb](https://github.com/event4u-app/agent-config/commit/b3407bb2fda39a8a57c0e2f72c8b430bed4fd012))
+
+### Refactoring
+
+* **cli:** rename fix:pr sub-commands for clarity ([fbdf636](https://github.com/event4u-app/agent-config/commit/fbdf636a50a06f3b35fe5c3d5fb108e9c15e6266))
+
+### Tests
+
+* **install:** drop composer-detection tests retired in v2 ([e37ad99](https://github.com/event4u-app/agent-config/commit/e37ad99beaebbb5f6a98b41e02ecefd6b0d39453))
+
+### Build
+
+* **tasks:** add npm:login + npm:publish-installer ([22639f8](https://github.com/event4u-app/agent-config/commit/22639f877feee33a3cbadb9147941cfb32fb6c9e))
+
+### Chores
+
+* remove retired setup.sh and global-install test surface ([3eebcf7](https://github.com/event4u-app/agent-config/commit/3eebcf72bcc45af168df4fd4b172a2484901a793))
+
+Tests: 3253 (-4 since 2.0.0)
+
 ## [2.0.0](https://github.com/event4u-app/agent-config/compare/1.41.2...2.0.0) (2026-05-12)
 
 ### BREAKING CHANGES

package/README.md

@@ -79,13 +79,12 @@ dispatcher per bridge as a post-install smoke test (skip: `--no-smoke`).
 
 ### For individual use (optional)
 
-Install directly in your agent for global, cross-project use:
+Skills-only, global across projects — installs into the agent itself,
+no per-repo `init`:
 
-| Tool | Install |
-|---|---|
-| **Augment CLI** | `auggie plugin install agent-config@event4u-agent-config` |
-| **Claude Code** | `claude plugin install agent-config@event4u-agent-config` |
-| **Copilot CLI** | `copilot plugin install agent-config@event4u-agent-config` |
+```bash
+<auggie|claude|copilot> plugin install agent-config@event4u-agent-config
+```
 
 → [All install options & project bridge setup](docs/installation.md)
 

package/docs/architecture.md

@@ -54,7 +54,7 @@ tree where:
   `.agent-src/<subdir>/`. Reading a context follows the symlink to
   the package payload.
 - `.augment/docs/guidelines/` — **symlink** into the package's
-  `docs/guidelines/` (consumer side: `vendor/event4u/agent-config/docs/guidelines/`;
+  `docs/guidelines/` (consumer side: `node_modules/@event4u/agent-config/docs/guidelines/`;
   package self-projection: `../docs/guidelines/`). This is the only
   `docs/` subdirectory exposed in `.augment/`; `docs/contracts/` and
   `docs/decisions/` are package-internal — rules that reference

package/docs/catalog.md

@@ -294,9 +294,9 @@ are excluded.
 | command | [`feature`](../.agent-src/commands/feature.md) | cluster: feature | Feature orchestrator — routes to explore, plan, refactor, roadmap, dev |
 | command | [`fix:ci`](../.agent-src/commands/fix/ci.md) | cluster: fix | Fetch CI errors from GitHub Actions and fix them |
 | command | [`fix:portability`](../.agent-src/commands/fix/portability.md) | cluster: fix | Find and fix project-specific references in shared .augment/ package files |
-| command | [`fix:pr-bots`](../.agent-src/commands/fix/pr-bots.md) | cluster: fix | Fix and reply to bot review comments (Copilot, Augment, Greptile, etc.) on a GitHub PR |
-| command | [`fix:pr-developers`](../.agent-src/commands/fix/pr-developers.md) | cluster: fix | Fix and reply to human reviewer comments on a GitHub PR |
-| command | [`fix:pr`](../.agent-src/commands/fix/pr.md) | cluster: fix | Fix and reply to all open review comments (bots + human reviewers) on a GitHub PR |
+| command | [`fix:pr-bot-comments`](../.agent-src/commands/fix/pr-bot-comments.md) | cluster: fix | Fix and reply to bot review comments (Copilot, Augment, Greptile, etc.) on a GitHub PR |
+| command | [`fix:pr-comments`](../.agent-src/commands/fix/pr-comments.md) | cluster: fix | Fix and reply to all open review comments (bots + human reviewers) on a GitHub PR |
+| command | [`fix:pr-developer-comments`](../.agent-src/commands/fix/pr-developer-comments.md) | cluster: fix | Fix and reply to human reviewer comments on a GitHub PR |
 | command | [`fix:refs`](../.agent-src/commands/fix/refs.md) | cluster: fix | Find and fix broken cross-references in .augment/ and agents/ files |
 | command | [`fix:seeder`](../.agent-src/commands/fix/seeder.md) | cluster: fix | Scan seeder data files for broken foreign key references — find constants used without getReference() and fix them |
 | command | [`fix`](../.agent-src/commands/fix.md) | cluster: fix | Fix orchestrator — routes to ci, references, portability, seeder, pr-comments, pr-bot-comments, pr-developer-comments |

package/docs/contracts/command-clusters.md

@@ -11,7 +11,7 @@ stability: beta
 The agent-config command surface collapses related atomic commands
 into **verb clusters**. A cluster is a single top-level command
 (e.g. `/fix`) that dispatches to sub-commands (e.g. `/fix ci`,
-`/fix pr`). Old atomic commands stay one release as deprecation
+`/fix pr-comments`). Old atomic commands stay one release as deprecation
 shims, then disappear.
 
 This file is the **locked source of truth** for which clusters
@@ -27,7 +27,7 @@ column 1 of this table.
 
 | Cluster | Phase | Sub-commands | Replaces |
 |---|:-:|---|---|
-| `fix` | 1 | `ci` · `pr` · `pr-bots` · `pr-developers` · `portability` · `refs` · `seeder` | `fix-ci` · `fix-pr-comments` · `fix-pr-bot-comments` · `fix-pr-developer-comments` · `fix-portability` · `fix-references` · `fix-seeder` |
+| `fix` | 1 | `ci` · `pr-comments` · `pr-bot-comments` · `pr-developer-comments` · `portability` · `refs` · `seeder` | `fix-ci` · `fix-pr-comments` · `fix-pr-bot-comments` · `fix-pr-developer-comments` · `fix-portability` · `fix-references` · `fix-seeder` |
 | `optimize` | 1 | `agents-dir` · `augmentignore` · `rtk` · `skills` | `optimize-augmentignore` · `optimize-rtk-filters` · `optimize-skills` · former `/optimize agents` and `/optimize agents-md` moved to the `/agents` file-family cluster 2026-05-09; `/agents prepare/audit/cleanup` collapsed into the single `/optimize agents-dir` (flags or wizard) per the agent-doc consolidation |
 | `feature` | 1 | `explore` · `plan` · `refactor` · `roadmap` · `dev` | `feature-explore` · `feature-plan` · `feature-refactor` · `feature-roadmap` · `feature-dev` |
 | `chat-history` | 2 | `show` · `import` · `learn` | `chat-history` (legacy status) — `resume` / `clear` / `checkpoint` removed in `road-to-chat-history-hook-only` (auto-adopt + structural hooks); `import` (verbatim cross-session render) and `learn` (project-improving learning extraction) added in the v4 stateless schema |
@@ -84,7 +84,7 @@ every new sub-command added to an existing cluster.
    cluster's primary verb (e.g. `/roadmap:create` + `process-*`
    composites).
 
-3. **Sub-name format.** kebab-case (`pr-bots`, `process-phase`),
+3. **Sub-name format.** kebab-case (`pr-bot-comments`, `process-phase`),
    ≤ 24 chars, no leading verb that duplicates the cluster name
    (use `/fix:ci`, not `/fix:fix-ci`).
 

package/docs/contracts/file-ownership-matrix.json

@@ -261,19 +261,19 @@
       "load_context": [],
       "load_context_eager": []
     },
-    ".agent-src.uncompressed/commands/fix/pr-bots.md": {
+    ".agent-src.uncompressed/commands/fix/pr-bot-comments.md": {
       "kind": "command",
       "rule_type": null,
       "load_context": [],
       "load_context_eager": []
     },
-    ".agent-src.uncompressed/commands/fix/pr-developers.md": {
+    ".agent-src.uncompressed/commands/fix/pr-comments.md": {
       "kind": "command",
       "rule_type": null,
       "load_context": [],
       "load_context_eager": []
     },
-    ".agent-src.uncompressed/commands/fix/pr.md": {
+    ".agent-src.uncompressed/commands/fix/pr-developer-comments.md": {
       "kind": "command",
       "rule_type": null,
       "load_context": [],
@@ -3088,22 +3088,22 @@
       "depth": 0
     },
     {
-      "source": ".agent-src.uncompressed/commands/fix/pr-bots.md",
-      "target": ".agent-src.uncompressed/commands/fix/pr-bots.md",
+      "source": ".agent-src.uncompressed/commands/fix/pr-bot-comments.md",
+      "target": ".agent-src.uncompressed/commands/fix/pr-bot-comments.md",
       "type": "WRITE",
       "via": "self",
       "depth": 0
     },
     {
-      "source": ".agent-src.uncompressed/commands/fix/pr-developers.md",
-      "target": ".agent-src.uncompressed/commands/fix/pr-developers.md",
+      "source": ".agent-src.uncompressed/commands/fix/pr-comments.md",
+      "target": ".agent-src.uncompressed/commands/fix/pr-comments.md",
       "type": "WRITE",
       "via": "self",
       "depth": 0
     },
     {
-      "source": ".agent-src.uncompressed/commands/fix/pr.md",
-      "target": ".agent-src.uncompressed/commands/fix/pr.md",
+      "source": ".agent-src.uncompressed/commands/fix/pr-developer-comments.md",
+      "target": ".agent-src.uncompressed/commands/fix/pr-developer-comments.md",
       "type": "WRITE",
       "via": "self",
       "depth": 0

package/docs/getting-started.md

@@ -1,33 +1,23 @@
 # Getting Started
 
 `agent-config` is a stack-agnostic orchestration contract for coding
-agents. The installer detects the project shape (Composer / npm / both /
-neither) and wires the matching glue. **Pick the entrypoint that
-matches the project**, not the language you happen to prefer.
+agents. Installation is npx-first; the package itself is npm-published
+and works in any project regardless of language.
 
 ## Installation
 
-The installer is the same orchestrator across stacks — it reads
-`composer.json` and/or `package.json`, syncs the payload, and generates
-the tool-specific glue. Pick one entrypoint:
+Pick one entrypoint:
 
 ```bash
-# Composer-based projects (PHP / Laravel / Symfony / Zend / Laminas)
-composer require --dev event4u/agent-config
-php vendor/bin/install.php
-# Equivalent: bash vendor/event4u/agent-config/scripts/install
-
-# npm-based projects (Next.js / React / Node / Vue / plain JS/TS)
-npm install --save-dev @event4u/agent-config
-# Postinstall runs the orchestrator. Re-run or pick a profile:
-# bash node_modules/@event4u/agent-config/scripts/install --profile=balanced
-
-# Mixed Composer + npm projects (Laravel + Inertia, Symfony + Vue, …)
-# Run both — the orchestrator merges results, no double-write.
-
-# Stack-less or polyglot repos (no Composer, no npm)
-git clone https://github.com/event4u-app/agent-config /tmp/agent-config
-bash /tmp/agent-config/scripts/install --target "$PWD"
+# Recommended — one-shot, no local dependency
+npx @event4u/create-agent-config init --tools=claude-code,cursor
+
+# No-Node fallback — curl | bash entrypoint (downloads a tarball)
+curl -sSL https://raw.githubusercontent.com/event4u-app/agent-config/main/setup.sh | bash
+
+# Global CLI (one install per machine, all projects)
+npm install -g @event4u/agent-config
+agent-config --help
 ```
 
 That's it. Your agent now follows your team's standards. The orchestrator
@@ -49,9 +39,10 @@ so you can run a few package scripts without installing `go-task`,
 ./agent-config help                # full command list
 ```
 
-The wrapper is regenerated on every `npm install` / `composer install`
-and delegates to the copy under `node_modules/@event4u/agent-config/`
-or `vendor/event4u/agent-config/`.
+The wrapper is regenerated on every install and delegates to (in order):
+`$AGENT_CONFIG_MASTER`, `./node_modules/@event4u/agent-config/`,
+`agent-config` on `$PATH` (global npm install), or
+`npx @event4u/agent-config@latest`.
 
 ## First Run
 

package/docs/installation.md

@@ -31,6 +31,41 @@ Combine surfaces by comma-separating: `--tools=claude-code,cursor,windsurf`.
 
 ---
 
+## Upgrading from v1
+
+v2 is a breaking change: the local-install scheme (Composer
+`require-dev`, npm `devDependency`, the `--global` symlink namespace
+under `~/.claude/`, `~/.cursor/`, `~/.codeium/windsurf/`,
+`~/.config/agent-config/`) is **retired**. v2 is npx-only — the
+runtime is resolved per invocation, pinned by
+`agent_config_version` in `.agent-settings.yml`.
+
+One command does the cutover, idempotently:
+
+```bash
+./agent-config migrate              # remove legacy install signals
+./agent-config migrate --dry-run    # detect only, no writes
+```
+
+What `migrate` cleans up:
+
+| What | Action |
+|---|---|
+| `package.json` → `devDependencies.@event4u/agent-config` | Removed (lockfile updated on next `npm install`). |
+| `composer.json` → `require*.event4u/agent-config` | Removed (lockfile updated on next `composer update`). |
+| Symlinks `.augment/`, `.claude/`, `.cursor/`, `.clinerules/`, `.windsurfrules` pointing into `vendor/` or `node_modules/` | Deleted. User-owned links are preserved with a warning. |
+| `.agent-settings.yml` | Written fresh if missing, with `agent_config_version` pinned. |
+| `.gitignore` agent-config block | Refreshed. |
+
+After `migrate` runs, you can drop the now-unreferenced
+`node_modules/@event4u/agent-config/` and `vendor/event4u/agent-config/`
+directories with `npm prune` and `composer update` respectively.
+
+Full contract sketch + the retired `--global` namespace teardown:
+[`docs/migration/v1-to-v2.md`](migration/v1-to-v2.md).
+
+---
+
 ## Mechanisms reference
 
 The rest of this page documents the underlying install mechanisms
@@ -46,9 +81,9 @@ the per-IDE index above.
 > 2. `scripts/install.py` — bridge files (`.agent-settings.yml`, VSCode /
 >    Augment / Copilot JSON descriptors).
 >
-> `bin/install.php` and `scripts/postinstall.sh` are thin wrappers that
-> delegate to `scripts/install`. Both underlying stages remain callable
-> directly for advanced use; see their `--help`.
+> `npx @event4u/create-agent-config init` and `setup.sh` (curl-based)
+> are thin wrappers that delegate to `scripts/install`. Both underlying
+> stages remain callable directly for advanced use; see their `--help`.
 >
 > Python 3.10+ is required for bridges. If it is missing, the orchestrator
 > prints a warning and continues with the payload sync only.
@@ -80,9 +115,9 @@ the per-IDE index above.
 ## Quickstart — one-liner entrypoints
 
 Try `@event4u/agent-config` in any directory in under 30 seconds, without
-`composer require` or `git clone` first. Both entrypoints are thin
-wrappers around `scripts/install` — same payload, same flags, no extra
-state.
+adding it as a dev dependency or cloning the repo first. Both
+entrypoints are thin wrappers around `scripts/install` — same payload,
+same flags, no extra state.
 
 ### `npx` (Node ≥ 18)
 
@@ -139,41 +174,26 @@ used. Pass `--yes` (or `-y`) to force non-interactive mode anywhere.
 Install once in the project — available to everyone working on it.
 The package is versioned with the project. Settings are committed once.
 
-### Composer (PHP projects)
+### npx (recommended for any project)
 
 ```bash
-composer require --dev event4u/agent-config
-php vendor/bin/install.php
+npx @event4u/create-agent-config init --tools=claude-code,cursor
 ```
 
-Composer does **not** run a post-install hook for this package — the
-installer is an explicit step. `bin/install.php` is a thin wrapper that
-calls `scripts/install` (the bash orchestrator). To pick a non-default
-profile:
+The wrapper downloads the latest `@event4u/agent-config` tarball into a
+temp dir, runs `scripts/install` with the selected tools, and cleans up
+afterwards. Nothing is added to `package.json`.
 
-```bash
-php vendor/bin/install.php --profile=balanced
-```
-
-The `--profile` flag controls the initial `cost_profile` value written
-to `.agent-settings.yml`.
-
-### npm (JavaScript/TypeScript projects)
+### Global CLI (one install per machine)
 
 ```bash
-npm install --save-dev @event4u/agent-config
+npm install -g @event4u/agent-config
+agent-config --help
 ```
 
-npm runs `scripts/postinstall.sh` automatically, which invokes
-`scripts/install` — the same orchestrator every other entry point uses.
-
-If your setup disables install scripts (`npm config set ignore-scripts
-true` or similar), nothing happens and the command prints no warning.
-Re-run the installer manually in that case:
-
-```bash
-bash node_modules/@event4u/agent-config/scripts/install
-```
+The global install puts `agent-config` on `$PATH` so the project
+wrapper (`./agent-config`) can fall through to it when no
+`node_modules/@event4u/agent-config/` exists.
 
 ### Installer orchestrator (`scripts/install`)
 
@@ -188,12 +208,6 @@ bash scripts/install --skip-sync      # bridges only
 bash scripts/install --dry-run        # show payload sync plan, skip bridges
 ```
 
-PHP users can use the Composer wrapper, which forwards all flags:
-
-```bash
-php vendor/bin/install.php --profile=balanced
-```
-
 Under the hood:
 
 - `scripts/install.sh` — payload sync (callable directly for sync-only runs).
@@ -544,15 +558,12 @@ for the upgrade path.
 When a new version of the package is published:
 
 ```bash
-composer update event4u/agent-config
-php vendor/bin/install.php          # refresh bridges + symlinks
-```
-
-Or for npm projects:
+# npx (one-shot, recommended) — always uses the latest tarball
+npx @event4u/create-agent-config init --tools=claude-code,cursor
 
-```bash
-npm update @event4u/agent-config
-bash node_modules/@event4u/agent-config/scripts/install
+# Global CLI
+npm install -g @event4u/agent-config@latest
+agent-config --help
 ```
 
 The installer is idempotent — re-running it after an update refreshes

package/docs/migrations/commands-1.15.0.md

@@ -15,9 +15,9 @@ invocation and are removed in `1.16.0`.
 | Old command | New invocation | Removed in |
 |---|---|---|
 | `/fix-ci` | `/fix ci` | 1.16.0 |
-| `/fix-pr-comments` | `/fix pr` | 1.16.0 |
-| `/fix-pr-bot-comments` | `/fix pr-bots` | 1.16.0 |
-| `/fix-pr-developer-comments` | `/fix pr-developers` | 1.16.0 |
+| `/fix-pr-comments` | `/fix pr-comments` | 1.16.0 |
+| `/fix-pr-bot-comments` | `/fix pr-bot-comments` | 1.16.0 |
+| `/fix-pr-developer-comments` | `/fix pr-developer-comments` | 1.16.0 |
 | `/fix-portability` | `/fix portability` | 1.16.0 |
 | `/fix-references` | `/fix refs` | 1.16.0 |
 | `/fix-seeder` | `/fix seeder` | 1.16.0 |