@williambeto/ai-workflow 2.3.1 → 2.3.2

package/CHANGELOG.md

@@ -1,3 +1,13 @@
+## [2.3.2] - 2026-06-19
+
+### Documentation
+- Clarified first-time usage with `npx @williambeto/ai-workflow init`.
+- Clarified local installed-package alias usage with `npx aw init`, `npx aw doctor`, and `npx aw run`.
+
+### Notes
+- No CLI behavior changed.
+- No runtime behavior changed.
+
 ## [2.3.1] - 2026-06-18
 
 ### Fixed

package/README.md

@@ -21,26 +21,30 @@ The workflow the product guarantees is:
 
 In practice, the kit is neither a frontend framework nor a UI library. It is an operational layer for software agents: it installs instructions and guardrails so that the agent can work more effectively inside the user's repository.
 
-## Installation
+## Installation and Usage
 
-### Current public release
+### First-time usage
+
+Use the full package command when running the kit before it is installed in a project:
 
 ```bash
-npm install -g @williambeto/ai-workflow@latest
+npx @williambeto/ai-workflow init
 ```
 
-Use `latest` for the supported public release. Release notes record exact historical versions when needed.
+### Short alias after installation
 
-## Quick start
+After installing AI Workflow Kit in a project, the shorter `aw` binary is available through `node_modules/.bin`:
 
 ```bash
-mkdir workflow-test && cd workflow-test
-npm init -y
-ai-workflow init --yes
-ai-workflow doctor
-ai-workflow execute "Atlas, list all agents, subagents, skills, and commands in the project. Present them in a table with their name, description, and usage examples."
+npm install -D @williambeto/ai-workflow
+
+npx aw init
+npx aw doctor
+npx aw run "Atlas, list all agents, subagents, skills, and commands in the project. Present them in a table with their name, description, and usage examples."
 ```
 
+The `aw` binary is an alias for the same CLI entrypoint as `ai-workflow`.
+
 The CLI receives the natural request, classifies the intent, plans the workflow, switch/creates branch safely, delegates coding tasks to the OpenCode runtime adapter, validates changes, and runs bounded remediation if necessary before outputting the handoff summary.
 
 ## Modes and profiles

package/docs/getting-started/upgrading-to-v2.md

@@ -19,10 +19,17 @@ Version `2.x` is a breaking public line from the previous `1.x` line. Test upgra
 
 4. Inspect initialization before applying it:
 
+   For first-time or pre-installation usage:
    ```bash
-   ai-workflow init --dry-run
-   ai-workflow init --yes
-   ai-workflow doctor
+   npx @williambeto/ai-workflow init --dry-run
+   npx @williambeto/ai-workflow init --yes
+   ```
+
+   After installing AI Workflow Kit locally in your project:
+   ```bash
+   npx aw init --dry-run
+   npx aw init --yes
+   npx aw doctor
    ```
 
 ## Main changes in version 2

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@williambeto/ai-workflow",
-  "version": "2.3.1",
+  "version": "2.3.2",
   "description": "AI Workflow Kit — OpenCode-first software delivery workflow with agents, commands, skills, validation, and evidence",
   "license": "MIT",
   "author": "José Willams",
@@ -29,7 +29,8 @@
     "url": "https://github.com/williambeto/ai-workflow/issues"
   },
   "bin": {
-    "ai-workflow": "bin/ai-workflow.js"
+    "ai-workflow": "bin/ai-workflow.js",
+    "aw": "bin/ai-workflow.js"
   },
   "files": [
     "bin",