devloom 1.0.0

package/agents/devloom-qa.md

@@ -0,0 +1,94 @@
+---
+mode: subagent
+model: opencode/deepseek-v4-flash-free
+hidden: true
+permission:
+  edit: allow
+  bash: allow
+---
+
+# DevLoom QA – Quality Inspector
+
+## Skill Auto-Detection
+
+Read the relevant domain skill file(s) from disk based on the task type:
+- FE task -> cat ~/.config/opencode/skills/build/frontend-development.md
+- BE task -> cat ~/.config/opencode/skills/build/backend-development.md + cat ~/.config/opencode/skills/build/api-design.md
+- API design -> cat ~/.config/opencode/skills/build/api-design.md
+- Testing -> cat ~/.config/opencode/skills/build/test-driven-development.md + cat ~/.config/opencode/skills/verify/quality-assurance.md
+- Security -> cat ~/.config/opencode/skills/review/security-review.md
+- Performance -> cat ~/.config/opencode/skills/review/performance-review.md
+- Debugging -> cat ~/.config/opencode/skills/verify/debugging.md
+- Documentation -> cat ~/.config/opencode/skills/ship/documentation.md
+- Requirements -> cat ~/.config/opencode/skills/define/requirements-analysis.md
+- Planning -> cat ~/.config/opencode/skills/plan/architecture-planning.md
+
+At minimum, always read:
+    cat ~/.config/opencode/skills/verify/quality-assurance.md
+
+You are a QA engineer in the DevLoom weaving pipeline.
+Verify that a single completed task meets its acceptance criteria, passes all
+tests, and introduces no regressions.
+
+## Instructions
+
+1. Read the task to verify from your prompt. Then read its spec in `.opencode/devloom/plan.md`:
+   ```bash
+   cat .opencode/devloom/plan.md
+   ```
+
+2. Read the files that were modified (reported by the developer in their completion message).
+
+3. Write tests if they do not already exist:
+   - **Unit tests**: cover every new function, method, or class.
+   - **Integration tests**: cover API endpoints or cross-module interactions.
+   - **Edge cases**: null/undefined inputs, empty collections, boundary values, error paths.
+   - Place test files adjacent to source files following the project's convention
+     (e.g., `*.spec.ts`, `*_test.py`, `*_test.go`).
+
+4. Run the linter and capture output — do NOT suppress failures with `|| true`,
+   as lint errors must be included in a `QA_FAIL` report:
+   ```bash
+   LINT_RESULT=0
+   LINT_OUTPUT=$(npm run lint 2>&1) || LINT_RESULT=$?
+   if [ $LINT_RESULT -ne 0 ]; then
+     LINT_OUTPUT=$(npx eslint src --ext .ts,.js 2>&1) || LINT_RESULT=$?
+   fi
+   echo "$LINT_OUTPUT"
+   # LINT_RESULT is non-zero if linting failed — factor this into your verdict.
+   ```
+
+5. Run the full test suite and capture the result:
+   ```bash
+   TEST_RESULT=0
+   TEST_OUTPUT=$(npm test 2>&1) || { TEST_RESULT=$?; TEST_OUTPUT=$(python -m pytest 2>&1) || { TEST_RESULT=$?; TEST_OUTPUT=$(go test ./... 2>&1) || TEST_RESULT=$?; }; }
+   echo "$TEST_OUTPUT"
+   # TEST_RESULT is non-zero if the test suite failed — factor this into your verdict.
+   ```
+
+6. Verify each acceptance criterion from `.opencode/devloom/plan.md` for this task is met.
+   If any criterion is unmet, it is a failure.
+
+7. **Report the verdict exactly once** with **exactly one** of these strings:
+
+   **On success:**
+   ```
+   QA_PASS: [task title]
+   Tests written: [list of test files]
+   Criteria verified: [list of AC IDs that were checked]
+   ```
+
+   **On failure:**
+   ```
+   QA_FAIL: [task title]
+   Failures:
+   - [specific failure 1: file, line, error message or criterion unmet]
+   - [specific failure 2: ...]
+   Suggested fixes:
+   - [concrete fix suggestion 1]
+   - [concrete fix suggestion 2]
+   ```
+
+   **CRITICAL**: Be precise in failure reports — the developer will use them directly to fix the code.
+   Do NOT attempt to fix the code yourself or iterate. Report once and stop. The orchestrator
+   will determine if the developer retries or the task is skipped after 3 failures.

package/commands/devloom-init.md

@@ -0,0 +1,60 @@
+---
+description: "DevLoom Init: start fresh execution, clearing any prior state"
+agent: devloom-orchestrator
+subtask: false
+---
+
+# Force Fresh Start
+
+```bash
+# Create .opencode/devloom directory if not exists
+mkdir -p .opencode/devloom
+
+# Load project config — local config.json overrides global agent models
+# ALL models MUST use opencode/ API prefix (e.g. opencode/deepseek-v4-flash-free)
+if [ -f ".opencode/devloom/config.json" ]; then
+  echo "📋 Applying local model config..."
+  node -e "
+    const c = JSON.parse(require('fs').readFileSync('.opencode/devloom/config.json','utf8'));
+    const m = c.models || {};
+    for (const [agent, model] of Object.entries(m)) {
+      let finalModel = model.trim();
+      if (!finalModel.startsWith('opencode/') && !finalModel.startsWith('opencode-go/')) {
+        finalModel = 'opencode/' + finalModel;
+        console.log('  ⚠️  Added opencode/ prefix to ' + agent + ': ' + model + ' -> ' + finalModel);
+      }
+      const f = require('os').homedir() + '/.config/opencode/agents/devloom-' + agent + '.md';
+      try {
+        const fs = require('fs');
+        let content = fs.readFileSync(f, 'utf8');
+        content = content.replace(/^model:.*/m, 'model: ' + finalModel);
+        fs.writeFileSync(f, content);
+        console.log('  ' + agent + ' -> ' + finalModel);
+      } catch(e) { console.error('  Failed ' + agent + ': ' + e.message); }
+    }
+  "
+fi
+
+# Remove any existing state to force fresh start
+rm -f .opencode/devloom/state.json
+rm -f .opencode/devloom/errors.md
+
+# Clear requirement/plan files if they exist
+rm -f .opencode/devloom/requirements.md
+rm -f .opencode/devloom/plan.md
+
+echo "🔄 Clearing prior state - starting fresh"
+```
+
+# Fresh DevLoom Orchestration
+
+$ARGUMENTS
+
+IMPORTANT: Run full workflow from PHASE 0.
+
+1. Run PHASE 0 — detect models, ask user preference, update agent files
+2. Invoke @devloom-analyst to create requirements
+3. Invoke @devloom-architect to create plan
+4. Loop through every task: developer → QA → (fix if needed) → mark [x]
+5. Invoke @devloom-documenter and run final quality gate
+6. Output DEVLOOM_DONE only when all tasks are [x] and build passes

package/commands/devloom-resume.md

@@ -0,0 +1,58 @@
+---
+description: "Resume DevLoom from last execution point"
+agent: devloom-orchestrator
+subtask: false
+---
+
+# Initialize & Dashboard Setup
+
+```bash
+# Load project config — local config.json overrides global agent models
+# ALL models MUST use opencode/ API prefix (e.g. opencode/deepseek-v4-flash-free)
+if [ -f ".opencode/devloom/config.json" ]; then
+  echo "📋 Applying local model config..."
+  node -e "
+    const c = JSON.parse(require('fs').readFileSync('.opencode/devloom/config.json','utf8'));
+    const m = c.models || {};
+    for (const [agent, model] of Object.entries(m)) {
+      let finalModel = model.trim();
+      if (!finalModel.startsWith('opencode/') && !finalModel.startsWith('opencode-go/')) {
+        finalModel = 'opencode/' + finalModel;
+        console.log('  ⚠️  Added opencode/ prefix to ' + agent + ': ' + model + ' -> ' + finalModel);
+      }
+      const f = require('os').homedir() + '/.config/opencode/agents/devloom-' + agent + '.md';
+      try {
+        const fs = require('fs');
+        let content = fs.readFileSync(f, 'utf8');
+        content = content.replace(/^model:.*/m, 'model: ' + finalModel);
+        fs.writeFileSync(f, content);
+        console.log('  ' + agent + ' -> ' + finalModel);
+      } catch(e) { console.error('  Failed ' + agent + ': ' + e.message); }
+    }
+  "
+fi
+
+# Check state file
+STATE_FILE=".opencode/devloom/state.json"
+
+if [ -f "$STATE_FILE" ]; then
+  PHASE=$(grep -o '"phase":"[^"]*"' "$STATE_FILE" | cut -d'"' -f4)
+  echo "Resuming from $PHASE"
+else
+  echo "No execution state found. Use /devloom [prompt] to start new execution."
+  exit 1
+fi
+```
+
+# Resume DevLoom Orchestration
+
+RESUME MODE ACTIVE: Execute PRE-PHASE 0 resume detection.
+
+1. Check for existing `.opencode/devloom/state.json`
+2. If found: Load phase, completedPhases, tasks.completed, requirements, plan
+3. Skip all completed phases
+4. Jump to next pending phase
+5. Resume execution from that point with existing models and configuration
+6. Do NOT run PHASE 0 (model selection) during resume
+
+Execute all remaining tasks until complete, then PHASE 3 delivery and quality gate.

package/commands/devloom-status.md

@@ -0,0 +1,23 @@
+---
+description: "DevLoom: show the current weaving progress — tasks done, in progress, and any errors"
+agent: devloom-orchestrator
+subtask: false
+---
+
+# Setup
+
+```bash
+mkdir -p .opencode/devloom
+```
+
+# Status Report
+
+Read `.opencode/devloom/plan.md` and `.opencode/devloom/errors.md` (if they exist) and report:
+
+1. **Progress**: total tasks, completed ([x]), pending ([ ]), completion percentage
+2. **Current task**: the first unchecked task in `.opencode/devloom/plan.md` (if any)
+3. **Errors**: any failed or skipped tasks listed in `.opencode/devloom/errors.md`
+4. **Phase**: which phase the weave is in (Planning / Weaving / Documenting / Done)
+
+Format the output as a clean status report. If `.opencode/devloom/plan.md` does not exist,
+report that no weaving session has been started yet.

package/commands/devloom.md

@@ -0,0 +1,81 @@
+---
+description: "DevLoom: weave a full software feature from a single prompt — requirements, code, tests, and docs"
+agent: devloom-orchestrator
+subtask: false
+---
+
+# Smart Resume Detection
+
+```bash
+# Create .opencode/devloom directory if not exists
+mkdir -p .opencode/devloom
+
+# Load project config — local config.json overrides global agent models
+# ALL models MUST use opencode/ API prefix (e.g. opencode/deepseek-v4-flash-free)
+if [ -f ".opencode/devloom/config.json" ]; then
+  echo "📋 Applying local model config..."
+  node -e "
+    const c = JSON.parse(require('fs').readFileSync('.opencode/devloom/config.json','utf8'));
+    const m = c.models || {};
+    for (const [agent, model] of Object.entries(m)) {
+      // Ensure model has opencode/ or opencode-go/ prefix
+      let finalModel = model.trim();
+      if (!finalModel.startsWith('opencode/') && !finalModel.startsWith('opencode-go/')) {
+        finalModel = 'opencode/' + finalModel;
+        console.log('  ⚠️  Added opencode/ prefix to ' + agent + ': ' + model + ' -> ' + finalModel);
+      }
+      const f = require('os').homedir() + '/.config/opencode/agents/devloom-' + agent + '.md';
+      try {
+        const fs = require('fs');
+        let content = fs.readFileSync(f, 'utf8');
+        content = content.replace(/^model:.*/m, 'model: ' + finalModel);
+        fs.writeFileSync(f, content);
+        console.log('  ' + agent + ' -> ' + finalModel);
+      } catch(e) { console.error('  Failed ' + agent + ': ' + e.message); }
+    }
+  "
+fi
+
+# Check if state exists
+if [ -f ".opencode/devloom/state.json" ]; then
+  PHASE=$(grep -o '"phase":"[^"]*"' .opencode/devloom/state.json | cut -d'"' -f4)
+  COMPLETED=$(grep -o '"completed":\[' .opencode/devloom/state.json | wc -l)
+  
+  # If no arguments provided, RESUME existing execution
+  if [ -z "$ARGUMENTS" ]; then
+    echo "📋 Found existing execution at phase: $PHASE"
+    echo "🔄 Resuming from saved state..."
+    
+    # Delegate to orchestrator resume logic (PRE-PHASE 0)
+    echo "RESUMING_FROM_STATE"
+  else
+    # If prompt provided, treat as new execution with same project
+    echo "ℹ️  Existing state found. Starting fresh execution with new prompt..."
+  fi
+else
+  # No prior state
+  if [ -z "$ARGUMENTS" ]; then
+    echo "❌ No prior execution found. Use: /devloom [description]"
+    echo "   Or use: /devloom init [description] to start fresh"
+    exit 1
+  fi
+  
+  echo "✨ Starting fresh DevLoom execution..."
+fi
+```
+
+# Orchestrator Direction
+
+$ARGUMENTS
+
+IMPORTANT: 
+- If RESUMING_FROM_STATE: Use PRE-PHASE 0 resume detection. Skip completed phases.
+- Otherwise: Run full PHASE 0 → PHASE 1 → PHASE 2 → PHASE 3 workflow.
+
+Full workflow:
+1. Run PHASE 0 — detect models, ask user preference, update agent files
+2. Invoke @devloom-analyst to create requirements
+3. Invoke @devloom-architect to create plan  
+4. Loop through every task: developer → QA → (fix if needed) → mark [x]
+5. Invoke @devloom-documenter and run final quality gate
+6. Output DEVLOOM_DONE only when all tasks are [x] and build passes

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import type { Plugin } from "@opencode-ai/plugin";
+export declare const DevLoomPlugin: Plugin;
+export default DevLoomPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAA;AAGjD,eAAO,MAAM,aAAa,EAAE,MAE3B,CAAA;AAED,eAAe,aAAa,CAAA"}

package/dist/index.js

@@ -0,0 +1,6 @@
+import { createLifecycleHooks } from "./plugin.js";
+export const DevLoomPlugin = async (ctx) => {
+    return createLifecycleHooks(ctx);
+};
+export default DevLoomPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAA;AAElD,MAAM,CAAC,MAAM,aAAa,GAAW,KAAK,EAAE,GAAG,EAAE,EAAE;IACjD,OAAO,oBAAoB,CAAC,GAAG,CAAC,CAAA;AAClC,CAAC,CAAA;AAED,eAAe,aAAa,CAAA"}

package/dist/plugin.d.ts

@@ -0,0 +1,4 @@
+import type { Hooks, PluginInput } from "@opencode-ai/plugin";
+declare function createLifecycleHooks(_ctx: PluginInput): Hooks;
+export { createLifecycleHooks };
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAA;AAI7D,iBAAS,oBAAoB,CAAC,IAAI,EAAE,WAAW,GAAG,KAAK,CAkCtD;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAA"}

package/dist/plugin.js

@@ -0,0 +1,31 @@
+import { env } from "node:process";
+const PLUGIN_NAME = "devloom";
+function createLifecycleHooks(_ctx) {
+    const debug = env.DEVLOOM_DEBUG === "1";
+    const log = (message, data) => {
+        if (debug) {
+            console.log(`[${new Date().toISOString()}] [${PLUGIN_NAME}]`, message, data ? JSON.stringify(data, null, 2) : "");
+        }
+    };
+    return {
+        event: async ({ event }) => {
+            log("Event received", {
+                type: event.type,
+                properties: Object.keys(event.properties ?? {}),
+            });
+        },
+        "tool.execute.before": async ({ tool, sessionID }) => {
+            log("Tool executing", { tool, sessionID });
+        },
+        "tool.execute.after": async ({ tool, sessionID }, output) => {
+            log("Tool completed", {
+                tool,
+                sessionID,
+                title: output?.title,
+                outputLength: output?.output?.length ?? 0,
+            });
+        },
+    };
+}
+export { createLifecycleHooks };
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.js","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,GAAG,EAAE,MAAM,cAAc,CAAA;AAGlC,MAAM,WAAW,GAAG,SAAS,CAAA;AAE7B,SAAS,oBAAoB,CAAC,IAAiB;IAC7C,MAAM,KAAK,GAAG,GAAG,CAAC,aAAa,KAAK,GAAG,CAAA;IAEvC,MAAM,GAAG,GAAG,CAAC,OAAe,EAAE,IAA8B,EAAE,EAAE;QAC9D,IAAI,KAAK,EAAE,CAAC;YACV,OAAO,CAAC,GAAG,CACT,IAAI,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,WAAW,GAAG,EAChD,OAAO,EACP,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAC1C,CAAA;QACH,CAAC;IACH,CAAC,CAAA;IAED,OAAO;QACL,KAAK,EAAE,KAAK,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE;YACzB,GAAG,CAAC,gBAAgB,EAAE;gBACpB,IAAI,EAAE,KAAK,CAAC,IAAI;gBAChB,UAAU,EAAE,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,IAAI,EAAE,CAAC;aAChD,CAAC,CAAA;QACJ,CAAC;QAED,qBAAqB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,EAAE;YACnD,GAAG,CAAC,gBAAgB,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,CAAA;QAC5C,CAAC;QAED,oBAAoB,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,EAAE,MAAM,EAAE,EAAE;YAC1D,GAAG,CAAC,gBAAgB,EAAE;gBACpB,IAAI;gBACJ,SAAS;gBACT,KAAK,EAAE,MAAM,EAAE,KAAK;gBACpB,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,CAAC;aAC1C,CAAC,CAAA;QACJ,CAAC;KACF,CAAA;AACH,CAAC;AAED,OAAO,EAAE,oBAAoB,EAAE,CAAA"}

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "devloom",
+  "version": "1.0.0",
+  "description": "DevLoom – Autonomous Development Weaver for OpenCode. Transforms a single prompt into fully tested, documented software.",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist",
+    "agents",
+    "commands",
+    "postinstall.mjs",
+    "README.md",
+    "GUIDE.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "postinstall": "node postinstall.mjs"
+  },
+  "peerDependencies": {
+    "@opencode-ai/plugin": ">=0.6.0"
+  },
+
+  "devDependencies": {
+    "@opencode-ai/plugin": "^1.15.7",
+    "@types/node": "^25.9.1",
+    "typescript": "^5.4.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/nsrau/devloom.git"
+  },
+  "bugs": {
+    "url": "https://github.com/nsrau/devloom/issues"
+  },
+  "homepage": "https://github.com/nsrau/devloom#readme",
+  "keywords": [
+    "opencode",
+    "opencode-plugin",
+    "devloom",
+    "autonomous",
+    "agent-loop",
+    "weaver",
+    "code-generation"
+  ],
+  "license": "MIT"
+}

package/postinstall.mjs

@@ -0,0 +1,137 @@
+#!/usr/bin/env node
+// postinstall.mjs — Installs DevLoom agents, commands, and skills into OpenCode's global config dirs.
+
+import { copyFileSync, mkdirSync, existsSync, readdirSync, statSync } from "fs"
+import { resolve, dirname, join, relative } from "path"
+import { fileURLToPath } from "url"
+import { homedir, platform } from "os"
+
+const __dirname = dirname(fileURLToPath(import.meta.url))
+
+// ── Config dir resolution (cross-platform) ────────────────────────────────────
+function getConfigDir() {
+  const os = platform()
+  if (os === "win32") {
+    return resolve(process.env.APPDATA ?? homedir(), "opencode")
+  }
+  if (os === "darwin") {
+    return resolve(homedir(), "Library", "Application Support", "opencode")
+  }
+  return resolve(
+    process.env.XDG_CONFIG_HOME ?? join(homedir(), ".config"),
+    "opencode"
+  )
+}
+
+const CONFIG_DIR = getConfigDir()
+const AGENTS_DIR  = resolve(CONFIG_DIR, "agents")
+const COMMANDS_DIR = resolve(CONFIG_DIR, "commands")
+const SKILLS_DIR = resolve(CONFIG_DIR, "skills")
+
+const AGENTS = [
+  "devloom-orchestrator",
+  "devloom-analyst",
+  "devloom-architect",
+  "devloom-developer",
+  "devloom-qa",
+  "devloom-documenter",
+]
+
+const COMMANDS = ["devloom", "devloom-status", "devloom-resume", "devloom-init"]
+
+// ── Helpers ───────────────────────────────────────────────────────────────────
+function ensureDir(dir) {
+  if (!existsSync(dir)) {
+    mkdirSync(dir, { recursive: true })
+    console.log(`  Created: ${dir}`)
+  }
+}
+
+let installFailed = false
+
+function installFile(src, dest, label) {
+  if (!existsSync(src)) {
+    console.error(`  Source file not found: ${src}`)
+    installFailed = true
+    return
+  }
+  try {
+    copyFileSync(src, dest)
+    console.log(`  ${label}`)
+  } catch (err) {
+    console.error(`  Failed -- ${label}: ${err.message}`)
+    installFailed = true
+  }
+}
+
+function installDirRecursive(srcDir, destDir, labelPrefix) {
+  if (!existsSync(srcDir)) {
+    console.error(`  Source dir not found: ${srcDir}`)
+    installFailed = true
+    return
+  }
+  const entries = readdirSync(srcDir)
+  ensureDir(destDir)
+  for (const entry of entries) {
+    const srcPath = join(srcDir, entry)
+    const destPath = join(destDir, entry)
+    const stat = statSync(srcPath)
+    if (stat.isDirectory()) {
+      installDirRecursive(srcPath, destPath, `${labelPrefix}/${entry}`)
+    } else {
+      installFile(srcPath, destPath, `${labelPrefix}/${entry}`)
+    }
+  }
+}
+
+// ── Main ──────────────────────────────────────────────────────────────────────
+console.log("\nDevLoom -- post-install\n")
+console.log(`  Config dir  : ${CONFIG_DIR}`)
+console.log(`  Agents dir  : ${AGENTS_DIR}`)
+console.log(`  Commands dir: ${COMMANDS_DIR}`)
+console.log(`  Skills dir  : ${SKILLS_DIR}\n`)
+
+ensureDir(AGENTS_DIR)
+ensureDir(COMMANDS_DIR)
+
+
+console.log("Installing agents:")
+for (const name of AGENTS) {
+  installFile(
+    resolve(__dirname, "agents", `${name}.md`),
+    resolve(AGENTS_DIR, `${name}.md`),
+    `Agent: ${name}`
+  )
+}
+
+console.log("\nInstalling commands:")
+for (const name of COMMANDS) {
+  installFile(
+    resolve(__dirname, "commands", `${name}.md`),
+    resolve(COMMANDS_DIR, `${name}.md`),
+    `Command: /${name}`
+  )
+}
+
+console.log("\nInstalling skills:")
+installDirRecursive(
+  resolve(__dirname, "skills"),
+  SKILLS_DIR,
+  "Skill"
+)
+
+if (!installFailed) {
+  console.log(`
+DevLoom installed successfully!
+
+Start weaving:
+  /devloom Build a REST API for user management with JWT auth
+  /devloom-status
+
+Debug mode:
+  DEVLOOM_DEBUG=1 opencode @devloom-orchestrator
+`)
+} else {
+  console.error("\nSome files could not be installed. See errors above.")
+  process.exit(1)
+}