ironweave 1.0.0 → 1.1.0

package/.claude-plugin/plugin.json

@@ -12,5 +12,6 @@
     "architecture",
     "quality-gates",
     "workflows"
-  ]
+  ],
+  "hooks": "./hooks/hooks.json"
 }

package/.cursor-plugin/plugin.json

@@ -15,5 +15,5 @@
     "workflows"
   ],
   "skills": "./skills/",
-  "agents": "./agents/"
+  "hooks": "./hooks/hooks-cursor.json"
 }

package/AGENTS.md

@@ -1 +1,22 @@
-CLAUDE.md
+# Ironweave
+
+You have access to the Ironweave skills library — a complete software development workflow with built-in quality gates.
+
+## How to use
+
+The **orchestrator** skill (`skills/orchestrator/SKILL.md`) is the main entry point. It automatically:
+- Senses project context and scores task difficulty
+- Selects the right route (new project / new feature / bug fix / refactoring)
+- Runs Plan → Execute → Validate → Deliver with quality gates per slice
+
+For any development task, start by reading the orchestrator skill. It will guide which other skills to invoke.
+
+## Skills available
+
+All skills are in `skills/`. Each has a `SKILL.md` with YAML frontmatter (`name`, `description`).
+
+Key skills: `orchestrator`, `requirement-qa`, `brainstorm`, `spec-writing`, `tech-stack`, `engineering-principles`, `api-contract-design`, `code-scaffold`, `error-handling-strategy`, `performance-arch-design`, `observability-design`, `integration-test-design`, `implementation-complexity-analysis`, `task-difficulty`, `project-context`, `docs-output`, `skill-creator`.
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md).

package/bin/cli.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+
+const fs = require('fs');
+const path = require('path');
+
+const args = process.argv.slice(2);
+const command = args[0] || 'init';
+
+if (command === '--help' || command === '-h') {
+  console.log(`
+ironweave - Agentic skills framework for AI coding agents
+
+Usage:
+  npx ironweave init [options]     Install skills into current project
+  npx ironweave list               List all available skills
+
+Options:
+  --agent <name>    Only install config for specific agent
+                    (claude, copilot, cursor, windsurf, cline, codex, gemini, all)
+                    Default: all
+  --skills-only     Only copy skills/, skip agent config files
+  --force           Overwrite existing files (default: skip existing)
+  --help            Show this help message
+`);
+  process.exit(0);
+}
+
+if (command === 'list') {
+  const skillsDir = path.join(__dirname, '..', 'skills');
+  const skills = fs.readdirSync(skillsDir).filter(f => {
+    return fs.statSync(path.join(skillsDir, f)).isDirectory();
+  });
+  console.log(`\nIronweave Skills (${skills.length}):\n`);
+  skills.forEach(s => console.log(`  - ${s}`));
+  console.log('');
+  process.exit(0);
+}
+
+if (command === 'init') {
+  const targetDir = process.cwd();
+  const pkgDir = path.join(__dirname, '..');
+
+  const agentFlag = args.indexOf('--agent');
+  const agent = agentFlag !== -1 ? args[agentFlag + 1] : 'all';
+  const skillsOnly = args.includes('--skills-only');
+  const force = args.includes('--force');
+
+  // Copy skills/ and hooks/
+  const srcSkills = path.join(pkgDir, 'skills');
+  const dstSkills = path.join(targetDir, 'skills');
+  copyDirRecursive(srcSkills, dstSkills, force);
+  console.log('✓ skills/ copied');
+
+  const srcHooks = path.join(pkgDir, 'hooks');
+  const dstHooks = path.join(targetDir, 'hooks');
+  copyDirRecursive(srcHooks, dstHooks, force);
+  console.log('✓ hooks/ copied');
+
+  if (!skillsOnly) {
+    const agentFiles = {
+      claude: [
+        { src: 'CLAUDE.md', dst: 'CLAUDE.md' },
+        { src: '.claude-plugin', dst: '.claude-plugin', dir: true }
+      ],
+      copilot: [
+        { src: '.github/copilot-instructions.md', dst: '.github/copilot-instructions.md' }
+      ],
+      cursor: [
+        { src: '.cursorrules', dst: '.cursorrules' },
+        { src: '.cursor-plugin', dst: '.cursor-plugin', dir: true }
+      ],
+      windsurf: [
+        { src: '.windsurfrules', dst: '.windsurfrules' }
+      ],
+      cline: [
+        { src: '.clinerules', dst: '.clinerules' }
+      ],
+      codex: [
+        { src: 'AGENTS.md', dst: 'AGENTS.md' },
+        { src: '.codex', dst: '.codex', dir: true }
+      ],
+      gemini: [
+        { src: 'GEMINI.md', dst: 'GEMINI.md' },
+        { src: 'gemini-extension.json', dst: 'gemini-extension.json' }
+      ]
+    };
+
+    const agents = agent === 'all' ? Object.keys(agentFiles) : [agent];
+
+    agents.forEach(a => {
+      const files = agentFiles[a];
+      if (!files) {
+        console.log(`✗ Unknown agent: ${a}`);
+        return;
+      }
+      files.forEach(f => {
+        const srcPath = path.join(pkgDir, f.src);
+        const dstPath = path.join(targetDir, f.dst);
+        if (f.dir) {
+          copyDirRecursive(srcPath, dstPath, force);
+        } else {
+          const dstDir = path.dirname(dstPath);
+          if (!fs.existsSync(dstDir)) fs.mkdirSync(dstDir, { recursive: true });
+          if (force || !fs.existsSync(dstPath)) {
+            fs.copyFileSync(srcPath, dstPath);
+          }
+        }
+      });
+      console.log(`✓ ${a} config installed`);
+    });
+  }
+
+  console.log('\n🎉 Ironweave installed! Your agent will auto-discover the skills.\n');
+  process.exit(0);
+}
+
+console.error(`Unknown command: ${command}. Run "npx ironweave --help" for usage.`);
+process.exit(1);
+
+function copyDirRecursive(src, dst, force) {
+  if (!fs.existsSync(src)) return;
+  if (!fs.existsSync(dst)) fs.mkdirSync(dst, { recursive: true });
+  const entries = fs.readdirSync(src, { withFileTypes: true });
+  for (const entry of entries) {
+    const srcPath = path.join(src, entry.name);
+    const dstPath = path.join(dst, entry.name);
+    if (entry.isDirectory()) {
+      copyDirRecursive(srcPath, dstPath, force);
+    } else if (force || !fs.existsSync(dstPath)) {
+      fs.copyFileSync(srcPath, dstPath);
+    }
+  }
+}

package/gemini-extension.json

@@ -0,0 +1,6 @@
+{
+  "name": "ironweave",
+  "description": "Agentic skills framework for software development: orchestration, requirements, architecture, TDD, and quality gates",
+  "version": "1.0.0",
+  "contextFileName": "GEMINI.md"
+}

package/hooks/hooks-cursor.json

@@ -0,0 +1,10 @@
+{
+  "version": 1,
+  "hooks": {
+    "sessionStart": [
+      {
+        "command": "./hooks/session-start"
+      }
+    ]
+  }
+}

package/hooks/hooks.json

@@ -0,0 +1,16 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "matcher": "startup|clear|compact",
+        "hooks": [
+          {
+            "type": "command",
+            "command": "\"${CLAUDE_PLUGIN_ROOT}/hooks/run-hook.cmd\" session-start",
+            "async": false
+          }
+        ]
+      }
+    ]
+  }
+}

package/hooks/run-hook.cmd

@@ -0,0 +1,5 @@
+@echo off
+setlocal
+set "SCRIPT_DIR=%~dp0"
+set "PLUGIN_ROOT=%SCRIPT_DIR%.."
+call "%PLUGIN_ROOT%\hooks\session-start"

package/hooks/session-start

@@ -0,0 +1,39 @@
+#!/usr/bin/env bash
+# SessionStart hook for Ironweave plugin
+
+set -euo pipefail
+
+# Determine plugin root directory
+SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
+PLUGIN_ROOT="$(cd "${SCRIPT_DIR}/.." && pwd)"
+
+# Read orchestrator skill content
+orchestrator_content=$(cat "${PLUGIN_ROOT}/skills/orchestrator/SKILL.md" 2>&1 || echo "Error reading orchestrator skill")
+
+# Escape string for JSON embedding
+escape_for_json() {
+    local s="$1"
+    s="${s//\\/\\\\}"
+    s="${s//\"/\\\"}"
+    s="${s//$'\n'/\\n}"
+    s="${s//$'\r'/\\r}"
+    s="${s//$'\t'/\\t}"
+    printf '%s' "$s"
+}
+
+orchestrator_escaped=$(escape_for_json "$orchestrator_content")
+session_context="<IMPORTANT>\nYou have Ironweave skills.\n\nIronweave is a complete software development workflow with built-in quality gates. The orchestrator skill is your main entry point — it auto-senses context, scores difficulty, selects the right route, and runs Plan > Execute > Validate > Deliver.\n\nAll skills are in the skills/ directory, each with a SKILL.md. For any development task, start by reading skills/orchestrator/SKILL.md.\n\nKey skills: orchestrator, requirement-qa, brainstorm, spec-writing, tech-stack, engineering-principles, api-contract-design, code-scaffold, error-handling-strategy, performance-arch-design, observability-design, integration-test-design, implementation-complexity-analysis, task-difficulty, project-context, docs-output, skill-creator.\n</IMPORTANT>"
+
+# Output context injection as JSON.
+# Cursor hooks expect additional_context (snake_case).
+# Claude Code hooks expect hookSpecificOutput.additionalContext (nested).
+# Copilot CLI and others expect additionalContext (top-level, SDK standard).
+if [ -n "${CURSOR_PLUGIN_ROOT:-}" ]; then
+  printf '{\n  "additional_context": "%s"\n}\n' "$session_context"
+elif [ -n "${CLAUDE_PLUGIN_ROOT:-}" ] && [ -z "${COPILOT_CLI:-}" ]; then
+  printf '{\n  "hookSpecificOutput": {\n    "hookEventName": "SessionStart",\n    "additionalContext": "%s"\n  }\n}\n' "$session_context"
+else
+  printf '{\n  "additionalContext": "%s"\n}\n' "$session_context"
+fi
+
+exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ironweave",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "description": "Agentic skills framework for AI coding agents — orchestrated workflows with adaptive routing, quality gates, and 17 composable skills.",
   "keywords": [
     "agent-skills",
@@ -27,11 +27,17 @@
   },
   "license": "MIT",
   "author": "YuluoY",
+  "bin": {
+    "ironweave": "./bin/cli.js"
+  },
   "files": [
     "skills/",
+    "hooks/",
+    "bin/",
     "CLAUDE.md",
     "AGENTS.md",
     "GEMINI.md",
+    "gemini-extension.json",
     ".cursorrules",
     ".windsurfrules",
     ".clinerules",