arreio 1.0.2 → 1.0.3

package/README.md

@@ -12,7 +12,7 @@ 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 `~/.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 in VS Code Copilot Chat. (Note: npm may show an advisory about unallowed install scripts—this is informational and won't block the installation.)
 
 Then initialize your project to set up the Arreio folder structure and documentation:
 
@@ -22,7 +22,7 @@ Then initialize your project to set up the Arreio folder structure and documenta
 
 Run this command in VS Code Copilot Chat to:
 
-1. Verify or manually install Arreio skills to `~/.agents/skills/` (if postinstall was skipped)
+1. Verify or manually install Arreio skills to `.agents/skills/` (if postinstall was skipped)
 2. Create the project structure (`docs/plans/`, `docs/learn/`, etc.)
 3. Set up architectural documentation and index files
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "arreio",
-  "version": "1.0.2",
+  "version": "1.0.3",
   "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

@@ -2,17 +2,16 @@
 
 /**
  * Post-install script for arreio
- * Copies skills from the package to the user's .agents/skills directory
+ * Copies skills from the package to the project's .agents/skills directory
  */
 
 const fs = require('fs');
 const path = require('path');
-const os = require('os');
 
 // Determine the source and destination paths
 const packageDir = path.dirname(__dirname);
 const skillsSource = path.join(packageDir, 'skills');
-const agentsDir = path.join(os.homedir(), '.agents');
+const agentsDir = path.join(process.cwd(), '.agents');
 const skillsDestination = path.join(agentsDir, 'skills');
 
 // Function to recursively copy directories

package/skills/arreio-init/SKILL.md

@@ -35,16 +35,16 @@ After initialization, the following modules can operate:
 
 The initialization workflow runs in two phases:
 
-1. **Phase 0: Install Skills (Optional)** — Verify or manually copy Arreio skills to `~/.agents/skills/` (skills are normally installed via npm postinstall, but this phase can install them as a fallback)
+1. **Phase 0: Install Skills (Optional)** — Verify or manually copy Arreio skills to `.agents/skills/` in the project (skills are normally installed via npm postinstall, but this phase can install them as a fallback)
 2. **Phase 1: Initialize Project Structure** — Create folders, indexes, and architectural documentation
 
 ### Step 1: Install Skills (Optional Fallback)
 
-Verify that Arreio skills are installed to the user's `.agents/skills` directory. See [modules/install.md](modules/install.md) for detailed instructions.
+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/` 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.
 
-**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/`.
+**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/`.
 
 **Action:** See [install.md](modules/install.md) for verification and manual installation steps.
 
@@ -201,13 +201,13 @@ _No review reports yet._
 
 After initialization, verify:
 
-- ✓ All Arreio skills are installed to `~/.agents/skills/`:
-  - `~/.agents/skills/plan/`
-  - `~/.agents/skills/work/`
-  - `~/.agents/skills/review/`
-  - `~/.agents/skills/learn/`
-  - `~/.agents/skills/end-session/`
-  - `~/.agents/skills/arreio-init/`
+- ✓ All Arreio skills are installed to `.agents/skills/`:
+  - `.agents/skills/plan/`
+  - `.agents/skills/work/`
+  - `.agents/skills/review/`
+  - `.agents/skills/learn/`
+  - `.agents/skills/end-session/`
+  - `.agents/skills/arreio-init/`
 - ✓ All five core folders exist: `docs/plans/`, `docs/learn/`, `docs/reports/`, `docs/tasks/`, `docs/archives/`
 - ✓ `ARCHITECTURE.md` exists at project root
 - ✓ Root-level index files exist:

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

@@ -1,6 +1,6 @@
 ---
 title: Install Skills
-description: Verify or manually install Arreio skills to the user's .agents/skills directory, providing a fallback if npm postinstall was skipped.
+description: Verify or manually install Arreio skills to the project's .agents/skills directory, providing a fallback if npm postinstall was skipped.
 type: module
 version: 1.0
 timestamp: "2026-09-01"
@@ -8,7 +8,7 @@ timestamp: "2026-09-01"
 
 # Phase 0 - Install Skills (Fallback)
 
-**Purpose:** Verify that Arreio skills are installed to the user'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 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.
 
 ## Workflow
 
@@ -18,7 +18,7 @@ This is the Phase 0 pipeline for the Arreio Init Skill. It performs verification
 
 First, verify that Arreio skills are already available:
 
-1. Check if `~/.agents/skills/` directory exists and contains the expected skill folders (plan, work, review, learn, end-session, arreio-init).
+1. Check if `.agents/skills/` directory exists in the project and contains the expected skill folders (plan, work, review, learn, end-session, arreio-init).
 2. If all skills are present and current, log success and skip to project structure initialization (Step 2).
 3. If skills are missing or incomplete, proceed to Step 2.
 
@@ -35,25 +35,29 @@ Verify that the prerequisites are met if skills need to be installed:
 
 1. Arreio is installed as an npm package in the current project (`node_modules/arreio/` exists).
 2. The skills directory exists in the package: `node_modules/arreio/skills/` contains subdirectories for each skill.
-3. The user's home directory is accessible (required to create `~/.agents/skills/`).
+3. The project directory is writable (required to create `.agents/skills/`).
 
 If any verification fails:
 
 - **Missing package:** Suggest running `npm install arreio` first.
 - **Missing skills:** Report a package integrity error (the skills/ directory is missing from the installed package).
-- **No home access:** Report an environment error (unable to determine home directory).
+- **No write access:** Report an environment error (unable to write to project directory).
 
 ### Step 3: Create Target Directory
 
 Create the destination directory hierarchy:
 
-1. If `~/.agents/` does not exist, create it.
-2. If `~/.agents/skills/` does not exist, create it.
-3. Log: `✓ Created ~/.agents/skills/`
+### Step 3: Create Target Directory
+
+Create the destination directory hierarchy:
+
+1. If `.agents/` does not exist, create it.
+2. If `.agents/skills/` does not exist, create it.
+3. Log: `✓ Created .agents/skills/`
 
 ### Step 4: Copy Skills from Package
 
-Copy each skill directory from `node_modules/arreio/skills/` to `~/.agents/skills/`:
+Copy each skill directory from `node_modules/arreio/skills/` to `.agents/skills/`:
 
 **Skills to copy:**
 
@@ -69,7 +73,7 @@ Copy each skill directory from `node_modules/arreio/skills/` to `~/.agents/skill
 For each skill:
 
 1. Read the source directory: `node_modules/arreio/skills/<skill-name>/`
-2. Copy recursively to destination: `~/.agents/skills/<skill-name>/`
+2. Copy recursively to destination: `.agents/skills/<skill-name>/`
 3. Verify the destination directory was created and contains the expected files (`SKILL.md`, `modules/`, `references/`).
 4. Log: `✓ Copied <skill-name>`
 
@@ -85,7 +89,7 @@ After all skills are copied, verify that the expected skill files are present:
 
 For each skill, check:
 
-- `~/.agents/skills/<skill-name>/SKILL.md` exists
+- `.agents/skills/<skill-name>/SKILL.md` exists
 - Directory structure is intact (modules/, references/ subdirs if present)
 
 If verification passes, log:
@@ -124,14 +128,14 @@ You can now use:
 
 After this phase completes:
 
-- ✓ `~/.agents/skills/` directory exists
-- ✓ All six skills are copied to `~/.agents/skills/`:
-  - `~/.agents/skills/plan/`
-  - `~/.agents/skills/work/`
-  - `~/.agents/skills/review/`
-  - `~/.agents/skills/learn/`
-  - `~/.agents/skills/end-session/`
-  - `~/.agents/skills/arreio-init/`
+- ✓ `.agents/skills/` directory exists in the project
+- ✓ All six skills are copied to `.agents/skills/`:
+  - `.agents/skills/plan/`
+  - `.agents/skills/work/`
+  - `.agents/skills/review/`
+  - `.agents/skills/learn/`
+  - `.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
 
@@ -141,11 +145,11 @@ Refer to [error-handling.md](../references/error-handling.md) for category class
 
 - **Category 1 (Missing context):** Arreio package not installed; suggest `npm install arreio`.
 - **Category 2 (Routing error):** Skills directory missing from package; report package integrity issue.
-- **Category 3 (Environment issue):** Cannot write to `~/.agents/`; insufficient permissions or home dir unavailable.
+- **Category 3 (Environment issue):** Cannot write to project `.agents/` directory; insufficient permissions.
 
 ## Notes
 
 - This phase runs **before** project structure initialization (Phase 1 → Create Core Folders).
-- Skills are copied to the user's home directory (`~/.agents/`), not the project directory. This allows skills to be reused across all projects once installed.
-- The copy is non-destructive; if skills already exist in `~/.agents/skills/`, they are overwritten with the latest version from the installed package. This supports package updates.
+- Skills are copied to the project's `.agents/` directory, keeping them scoped to the project. Each project gets its own copy of skills.
+- The copy is non-destructive; if skills already exist in `.agents/skills/`, they are overwritten with the latest version from the installed package. This supports package updates.
 - This phase is idempotent; running it multiple times produces the same result.