arreio 1.0.3 → 1.0.5

package/README.md

@@ -12,7 +12,15 @@ Install Arreio as a dependency to enable all skills in your workspace:
 npm install arreio
 ```
 
-The post-install script will automatically copy all Arreio skills to your project's `.agents/skills/` directory, making them available in VS Code Copilot Chat. (Note: npm may show an advisory about unallowed install scripts—this is informational and won't block the installation.)
+The post-install script will automatically copy all Arreio skills to your project's `.agents/skills/` directory, making them available to your AI coding agent.
+
+> **Note on npm 10+ install scripts:** npm 10+ blocks lifecycle scripts by default and will print a warning like `npm warn install-scripts arreio@x.y.z (postinstall: ...)`. The script is not run automatically until you allow it. Run:
+>
+> ```bash
+> npm install-scripts approve arreio
+> ```
+>
+> If you skip the postinstall, run `/arreio-init` in your AI coding agent — it will install the skills for you.
 
 Then initialize your project to set up the Arreio folder structure and documentation:
 
@@ -20,7 +28,7 @@ Then initialize your project to set up the Arreio folder structure and documenta
 /arreio-init
 ```
 
-Run this command in VS Code Copilot Chat to:
+Run this command in your AI coding agent to:
 
 1. Verify or manually install Arreio skills to `.agents/skills/` (if postinstall was skipped)
 2. Create the project structure (`docs/plans/`, `docs/learn/`, etc.)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arreio",
-  "version": "1.0.3",
+  "version": "1.0.5",
   "description": "Arreio transforms agentic coding workflows into a predictable, safe, and high-quality software delivery pipeline. Master the four core phases—Plan, Work, Review, Learn—to orchestrate a highly reliable development cycle.",
   "license": "MIT",
   "author": "Wicttor",

package/scripts/postinstall.js

@@ -11,7 +11,11 @@ const path = require('path');
 // Determine the source and destination paths
 const packageDir = path.dirname(__dirname);
 const skillsSource = path.join(packageDir, 'skills');
-const agentsDir = path.join(process.cwd(), '.agents');
+
+// INIT_CWD is set by npm to the project root during lifecycle scripts.
+// Fallback to process.cwd() for direct/manual runs.
+const projectRoot = process.env.INIT_CWD || process.cwd();
+const agentsDir = path.join(projectRoot, '.agents');
 const skillsDestination = path.join(agentsDir, 'skills');
 
 // Function to recursively copy directories

package/skills/arreio-init/SKILL.md

@@ -42,7 +42,7 @@ The initialization workflow runs in two phases:
 
 Verify that Arreio skills are installed to the project's `.agents/skills/` directory. See [modules/install.md](modules/install.md) for detailed instructions.
 
-**Why:** Skills must be available in `.agents/skills/` for VS Code Copilot Chat discovery. Normally, the npm postinstall script handles this automatically when you run `npm install arreio`. This step provides a manual fallback if postinstall was skipped.
+**Why:** Skills must be available in `.agents/skills/` so your AI coding agent can discover them. Normally, the npm postinstall script handles this automatically when you run `npm install arreio`. This step provides a manual fallback if postinstall was skipped.
 
 **When to run:** Skip this step if npm postinstall has already run. If skills are not yet installed, this phase will copy them from `node_modules/arreio/skills/` to `.agents/skills/`.
 

package/skills/arreio-init/modules/install.md

@@ -8,7 +8,7 @@ timestamp: "2026-09-01"
 
 # Phase 0 - Install Skills (Fallback)
 
-**Purpose:** Verify that Arreio skills are installed to the project's `.agents/skills/` directory, making them available for discovery and invocation in VS Code Copilot Chat. This is normally handled by the npm postinstall script, but this phase provides a manual fallback if postinstall was skipped or if users need to reinstall skills.
+**Purpose:** Verify that Arreio skills are installed to the project's `.agents/skills/` directory, making them available for discovery and invocation by your AI coding agent. This is normally handled by the npm postinstall script, but this phase provides a manual fallback if postinstall was skipped or if users need to reinstall skills.
 
 ## Workflow
 
@@ -103,7 +103,7 @@ If verification passes, log:
   - end-session
   - arreio-init
 
-Skills are now available in VS Code Copilot Chat.
+Skills are now available to your AI coding agent.
 ```
 
 If verification fails for any skill, report which skills failed and suggest manual verification.
@@ -137,7 +137,7 @@ After this phase completes:
   - `.agents/skills/end-session/`
   - `.agents/skills/arreio-init/`
 - ✓ Each skill directory contains `SKILL.md` and expected subdirectories
-- ✓ Skills are ready for discovery by VS Code Copilot Chat
+- ✓ Skills are ready for discovery by your AI coding agent
 
 ## Error Handling