arreio 1.0.0 → 1.0.1

package/README.md

@@ -17,7 +17,9 @@ Install Arreio as a dependency to enable all skills in your workspace:
 npm install arreio
 ```
 
-Then initialize your project to set up Arreio workflows:
+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.)
+
+Then initialize your project to set up the Arreio folder structure and documentation:
 
 ```
 /arreio-init
@@ -25,7 +27,7 @@ Then initialize your project to set up Arreio workflows:
 
 Run this command in VS Code Copilot Chat to:
 
-1. Copy all Arreio skills to your `~/.agents/skills/` directory
+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.0",
+  "version": "1.0.1",
   "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",
@@ -27,8 +27,12 @@
   "main": "README.md",
   "files": [
     "skills/",
+    "scripts/",
     "README.md"
   ],
+  "scripts": {
+    "postinstall": "node scripts/postinstall.js"
+  },
   "engines": {
     "node": ">=14.0.0"
   },

package/scripts/postinstall.js

@@ -0,0 +1,50 @@
+#!/usr/bin/env node
+
+/**
+ * Post-install script for arreio
+ * Copies skills from the package to the user'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 skillsDestination = path.join(agentsDir, 'skills');
+
+// Function to recursively copy directories
+function copyDirectory(src, dest) {
+  if (!fs.existsSync(dest)) {
+    fs.mkdirSync(dest, { recursive: true });
+  }
+
+  const files = fs.readdirSync(src);
+  files.forEach(file => {
+    const srcFile = path.join(src, file);
+    const destFile = path.join(dest, file);
+    const stat = fs.statSync(srcFile);
+
+    if (stat.isDirectory()) {
+      copyDirectory(srcFile, destFile);
+    } else {
+      fs.copyFileSync(srcFile, destFile);
+    }
+  });
+}
+
+try {
+  // Create .agents directory if it doesn't exist
+  if (!fs.existsSync(agentsDir)) {
+    fs.mkdirSync(agentsDir, { recursive: true });
+  }
+
+  // Copy skills to .agents/skills
+  copyDirectory(skillsSource, skillsDestination);
+  console.log(`✓ Arreio skills installed to ${skillsDestination}`);
+} catch (error) {
+  console.error(`✗ Failed to install Arreio skills: ${error.message}`);
+  process.exit(1);
+}

package/skills/arreio-init/SKILL.md

@@ -35,16 +35,18 @@ After initialization, the following modules can operate:
 
 The initialization workflow runs in two phases:
 
-1. **Phase 0: Install Skills** — Copy Arreio skills to `~/.agents/skills/` for VS Code Copilot Chat discovery
+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)
 2. **Phase 1: Initialize Project Structure** — Create folders, indexes, and architectural documentation
 
-### Step 1: Install Skills
+### Step 1: Install Skills (Optional Fallback)
 
-Install Arreio skills 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 user's `.agents/skills` directory. See [modules/install.md](modules/install.md) for detailed instructions.
 
-**Why:** Skills must be copied from the installed npm package to the user's home directory so they are discoverable by VS Code Copilot Chat. This step must run first, before project structure is created.
+**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.
 
-**Action:** Execute the [install.md](modules/install.md) phase to copy all skills 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.
 
 ### Step 2: Create Core Folder Structure
 

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

@@ -1,22 +1,37 @@
 ---
 title: Install Skills
-description: Install Arreio skills to the user's .agents/skills directory, making them available in VS Code Copilot Chat.
+description: Verify or manually install Arreio skills to the user's .agents/skills directory, providing a fallback if npm postinstall was skipped.
 type: module
 version: 1.0
 timestamp: "2026-09-01"
 ---
 
-# Phase 0 - Install Skills
+# Phase 0 - Install Skills (Fallback)
 
-**Purpose:** Copy Arreio skills from the installed npm package to the user's `~/.agents/skills/` directory, making them available for discovery and invocation in VS Code Copilot Chat. This ensures all Arreio workflows (plan, work, review, learn, end-session) are accessible after initialization.
+**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.
 
 ## Workflow
 
-This is the Phase 0 pipeline for the Arreio Init Skill. It orchestrates the following steps before creating project structure.
+This is the Phase 0 pipeline for the Arreio Init Skill. It performs verification and optional installation before creating project structure.
 
-### Step 1: Verify Installation Context
+### Step 1: Check if Skills Already Installed
 
-Verify that the prerequisites are met:
+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).
+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.
+
+**Result:**
+
+- ✓ Skills already installed → Skip to project structure
+- ✗ Skills missing → Proceed to manual installation
+
+### Step 2: Verify Installation Context (if needed)
+
+### Step 2: Verify Installation Context (if needed)
+
+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.
@@ -28,7 +43,7 @@ If any verification fails:
 - **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).
 
-### Step 2: Create Target Directory
+### Step 3: Create Target Directory
 
 Create the destination directory hierarchy:
 
@@ -36,7 +51,7 @@ Create the destination directory hierarchy:
 2. If `~/.agents/skills/` does not exist, create it.
 3. Log: `✓ Created ~/.agents/skills/`
 
-### Step 3: Copy Skills from Package
+### Step 4: Copy Skills from Package
 
 Copy each skill directory from `node_modules/arreio/skills/` to `~/.agents/skills/`:
 
@@ -64,7 +79,7 @@ If any copy operation fails:
 - Ask the user to manually verify the source exists and the destination is writable.
 - Do not proceed to the next phase.
 
-### Step 4: Verify Installation Success
+### Step 5: Verify Installation Success
 
 After all skills are copied, verify that the expected skill files are present:
 
@@ -89,14 +104,14 @@ Skills are now available in VS Code Copilot Chat.
 
 If verification fails for any skill, report which skills failed and suggest manual verification.
 
-### Step 5: Log Installation Summary
+### Step 6: Log Installation Summary
 
 Provide the user with confirmation and next steps:
 
 ```
 Installation complete. Arreio skills are now available:
 
-Next step: Project structure will be initialized in Step 1 of arreio-init.
+Next step: Project structure will be initialized in the next phase of arreio-init.
 
 You can now use:
   /plan    — Create implementation plans