ironweave 1.0.0

package/.claude-plugin/plugin.json

@@ -0,0 +1,16 @@
+{
+  "name": "ironweave",
+  "description": "Agentic skills framework for software development: orchestration, requirements, architecture, TDD, and quality gates",
+  "version": "1.0.0",
+  "homepage": "https://github.com/YuluoY/ironware",
+  "repository": "https://github.com/YuluoY/ironware",
+  "license": "MIT",
+  "keywords": [
+    "skills",
+    "orchestrator",
+    "tdd",
+    "architecture",
+    "quality-gates",
+    "workflows"
+  ]
+}

package/.clinerules

@@ -0,0 +1,7 @@
+# Ironweave
+
+You have access to the Ironweave skills library — a complete software development workflow with built-in quality gates.
+
+The **orchestrator** skill (`skills/orchestrator/SKILL.md`) is the main entry point. For any development task, start by reading it. The orchestrator automatically senses context, scores difficulty, selects the right route, and runs Plan → Execute → Validate → Deliver with quality gates.
+
+All skills are in `skills/`, each with a `SKILL.md` containing instructions.

package/.codex/INSTALL.md

@@ -0,0 +1,45 @@
+# Installing Ironweave for Codex
+
+## Installation
+
+1. **Clone the repository:**
+   ```bash
+   git clone https://github.com/YuluoY/ironware.git ~/.codex/ironweave
+   ```
+
+2. **Create the skills symlink:**
+   ```bash
+   mkdir -p ~/.agents/skills
+   ln -s ~/.codex/ironweave/skills ~/.agents/skills/ironweave
+   ```
+
+   **Windows (PowerShell):**
+   ```powershell
+   New-Item -ItemType Directory -Force -Path "$env:USERPROFILE\.agents\skills"
+   cmd /c mklink /J "$env:USERPROFILE\.agents\skills\ironweave" "$env:USERPROFILE\.codex\ironweave\skills"
+   ```
+
+3. **Restart Codex** to discover the skills.
+
+## Verify
+
+```bash
+ls -la ~/.agents/skills/ironweave
+```
+
+You should see a symlink pointing to the Ironweave skills directory.
+
+## Updating
+
+```bash
+cd ~/.codex/ironweave && git pull
+```
+
+Skills update instantly through the symlink.
+
+## Uninstalling
+
+```bash
+rm ~/.agents/skills/ironweave
+rm -rf ~/.codex/ironweave
+```

package/.cursor-plugin/plugin.json

@@ -0,0 +1,19 @@
+{
+  "name": "ironweave",
+  "displayName": "Ironweave",
+  "description": "Agentic skills framework for software development: orchestration, requirements, architecture, TDD, and quality gates",
+  "version": "1.0.0",
+  "homepage": "https://github.com/YuluoY/ironware",
+  "repository": "https://github.com/YuluoY/ironware",
+  "license": "MIT",
+  "keywords": [
+    "skills",
+    "orchestrator",
+    "tdd",
+    "architecture",
+    "quality-gates",
+    "workflows"
+  ],
+  "skills": "./skills/",
+  "agents": "./agents/"
+}

package/.cursorrules

@@ -0,0 +1,7 @@
+# Ironweave
+
+You have access to the Ironweave skills library — a complete software development workflow with built-in quality gates.
+
+The **orchestrator** skill (`skills/orchestrator/SKILL.md`) is the main entry point. For any development task, start by reading it. The orchestrator automatically senses context, scores difficulty, selects the right route, and runs Plan → Execute → Validate → Deliver with quality gates.
+
+All skills are in `skills/`, each with a `SKILL.md` containing instructions.

package/.github/copilot-instructions.md

@@ -0,0 +1,7 @@
+# Ironweave
+
+You have access to the Ironweave skills library — a complete software development workflow with built-in quality gates.
+
+The **orchestrator** skill (`skills/orchestrator/SKILL.md`) is the main entry point. For any development task, start by reading it. The orchestrator automatically senses context, scores difficulty, selects the right route, and runs Plan → Execute → Validate → Deliver with quality gates.
+
+All skills are in `skills/`, each with a `SKILL.md` containing instructions.

package/.opencode/INSTALL.md

@@ -0,0 +1,42 @@
+# Installing Ironweave for OpenCode
+
+## Prerequisites
+
+- [OpenCode.ai](https://opencode.ai) installed
+
+## Installation
+
+Add ironweave to the `plugin` array in your `opencode.json` (global or project-level):
+
+```json
+{
+  "plugin": ["ironweave@git+https://github.com/YuluoY/ironware.git"]
+}
+```
+
+Restart OpenCode. The plugin auto-installs and registers all skills.
+
+## Usage
+
+Use OpenCode's native `skill` tool:
+
+```
+use skill tool to list skills
+use skill tool to load ironweave/orchestrator
+```
+
+## Updating
+
+Ironweave updates automatically when you restart OpenCode.
+
+To pin a specific version:
+
+```json
+{
+  "plugin": ["ironweave@git+https://github.com/YuluoY/ironware.git#v1.0.0"]
+}
+```
+
+## Uninstalling
+
+Remove the plugin entry from your `opencode.json` and restart OpenCode.

package/.windsurfrules

@@ -0,0 +1,7 @@
+# Ironweave
+
+You have access to the Ironweave skills library — a complete software development workflow with built-in quality gates.
+
+The **orchestrator** skill (`skills/orchestrator/SKILL.md`) is the main entry point. For any development task, start by reading it. The orchestrator automatically senses context, scores difficulty, selects the right route, and runs Plan → Execute → Validate → Deliver with quality gates.
+
+All skills are in `skills/`, each with a `SKILL.md` containing instructions.

package/AGENTS.md

@@ -0,0 +1 @@
+CLAUDE.md

package/CLAUDE.md

@@ -0,0 +1,22 @@
+# 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/CONTRIBUTING.md

@@ -0,0 +1,81 @@
+# Contributing to Ironweave
+
+Thank you for your interest in contributing! Ironweave welcomes contributions from everyone.
+
+## Ways to Contribute
+
+- **Report bugs** — Open an issue describing the problem
+- **Suggest skills** — Propose new skills or improvements to existing ones
+- **Submit PRs** — Fix bugs, improve documentation, or add features
+- **Translate** — Help improve Chinese/English documentation
+
+## Development Setup
+
+```bash
+git clone https://github.com/YuluoY/ironware.git
+cd ironweave
+```
+
+No build step required — skills are plain Markdown files.
+
+## Skill Structure
+
+Each skill is a directory under `skills/` containing at minimum a `SKILL.md` file:
+
+```
+skills/my-skill/
+├── SKILL.md              # Required: main skill file with YAML frontmatter
+├── references/           # Optional: supporting documents
+│   └── rules.md
+├── agents/               # Optional: SubAgent definitions
+│   └── expert.md
+└── scripts/              # Optional: helper scripts
+    └── helper.py
+```
+
+### SKILL.md Frontmatter (Required)
+
+```yaml
+---
+name: my-skill
+description: >-
+  One-paragraph description of what this skill does and when to use it.
+---
+```
+
+Both `name` and `description` are required for [skills.sh](https://skills.sh) compatibility.
+
+## Guidelines
+
+1. **One skill, one concern** — Each skill should do one thing well
+2. **Include trigger phrases** — The `description` field should list scenarios that activate the skill
+3. **Reference, don't duplicate** — Use `references/` for shared rules; don't copy content across skills
+4. **Test your changes** — Verify skills work with at least one agent before submitting
+5. **Bilingual** — New skills should include both English and Chinese content where practical
+
+## Orchestrator Changes
+
+Changes to the orchestrator skill (`skills/orchestrator/`) require extra care:
+
+- Ensure all 4 routes (A/B/C/D) remain consistent
+- Verify quality gates in `references/gates.md` still cover all paths
+- Check that reflow arrows point to correct targets
+- Run through at least one scenario per route mentally
+
+## Commit Messages
+
+Use conventional commits:
+
+```
+feat(brainstorm): add devil's advocate role
+fix(orchestrator): correct reflow target for need-level failures
+docs(readme): update compatibility table
+```
+
+## Code of Conduct
+
+Be respectful, constructive, and inclusive. We follow the [Contributor Covenant](https://www.contributor-covenant.org/).
+
+---
+
+Questions? Open an issue or start a discussion.

package/GEMINI.md

@@ -0,0 +1 @@
+@./skills/orchestrator/SKILL.md

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Ironweave Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,250 @@
+<p align="center">
+  <h1 align="center">Ironweave</h1>
+  <p align="center">
+    An agentic skills framework & software development methodology for your AI coding agents.
+  </p>
+  <p align="center">
+    <a href="./README_CN.md">中文文档</a> · <a href="https://skills.sh">skills.sh</a> · <a href="#installation">Install</a> · <a href="./LICENSE">MIT License</a>
+  </p>
+</p>
+
+---
+
+Ironweave is a complete software development workflow for your coding agents, built on top of a set of composable **skills**. It doesn't just write code — it steps back, understands what you're building, plans the work, breaks it into slices, and executes each slice with built-in quality gates. And because the skills trigger automatically, you don't need to do anything special. Your coding agent just has Ironweave.
+
+## How it works
+
+It starts from the moment you give your agent a task. The **orchestrator** skill activates and:
+
+1. **Senses context** — Detects project type (new project, new feature, bug fix, or refactoring) via `project-context`
+2. **Scores difficulty** — Rates the task 1-10 via `task-difficulty`, selecting a variant (lite / standard / plus)
+3. **Clarifies requirements** — For ambiguous or complex tasks, uses `requirement-qa` and `brainstorm` to nail down scope before coding
+4. **Slices scope** — Breaks large tasks into ordered slices (by module dependency), each independently deliverable
+5. **Routes** — Picks one of four routes (A: new project, B: new feature, C: bug fix, D: refactoring) with route-specific skill chains
+6. **Executes per slice** — Each slice goes through Plan → Execute → Validate → Deliver with quality gates at each transition
+
+If validation fails, work **reflows** to the right level — code-level issues go back to Execute, design-level back to Plan, requirement-level back to scope. No blind retries.
+
+## The Workflow
+
+```
+User Request
+    │
+    ▼
+  Context Sensing → Difficulty Scoring → Clarify (if needed) → Scope Slicing
+    │
+    ▼
+  ┌──────────────────────────────────┐
+  │  Per-Slice Loop                  │
+  │                                  │
+  │  Route Selection (A/B/C/D)      │
+  │       │                          │
+  │       ▼                          │
+  │  Plan ──── Gate ──── Execute     │
+  │                        │         │
+  │                      Gate        │
+  │                        │         │
+  │                    Validate      │
+  │                        │         │
+  │                    Deliver       │
+  └──────────────────────────────────┘
+    │
+    ▼
+  Done (or next slice)
+```
+
+### Three Variants
+
+| Difficulty | Variant | What changes |
+|-----------|---------|-------------|
+| L1-L2 (easy) | **lite** | Skip optional skills, quick self-review, no mandatory TDD |
+| L3 (medium) | **standard** | Full skill chain, mandatory TDD, standard review |
+| L4-L5 (hard) | **plus** | SubAgent isolation per task, strict TDD, two-stage review, parallel strategy |
+
+## What's Inside
+
+### Skills Library
+
+**Orchestration**
+
+- `orchestrator` — Full-lifecycle flow orchestrator (routes, quality gates, reflow, slice iteration)
+
+**Requirements & Design**
+
+- `requirement-qa` — Multi-round Q&A to elicit and refine requirements
+- `brainstorm` — Multi-perspective brainstorming with expert SubAgents
+- `spec-writing` — Structured feature specification documents
+- `tech-stack` — Full-stack technology selection & decision docs
+
+**Architecture & Engineering**
+
+- `engineering-principles` — Context-aware principles matcher (SOLID, DDD, TDD, design patterns)
+- `api-contract-design` — RESTful/GraphQL API contracts, DTOs, OpenAPI specs
+- `error-handling-strategy` — Exception hierarchy, error codes, retry, circuit-breaker, fallback
+- `performance-arch-design` — Cache layering, async processing, indexing, rate limiting
+- `observability-design` — Distributed tracing, structured logging, metrics, alerting
+
+**Implementation**
+
+- `code-scaffold` — Project scaffolding from domain model + design docs
+- `implementation-complexity-analysis` — Technical risk identification, complexity decomposition
+- `integration-test-design` — TestContainers, contract testing, mock strategy
+
+**Meta**
+
+- `task-difficulty` — Multi-dimensional difficulty scoring (1-10)
+- `project-context` — Project structure awareness & cross-session persistence
+- `docs-output` — Document output management (modular docs/ organization)
+- `skill-creator` — Create, modify, and evaluate agent skills
+
+## Installation
+
+### Via skills.sh (Recommended)
+
+```bash
+# Install all skills
+npx skills add YuluoY/ironware
+
+# Install specific skills
+npx skills add YuluoY/ironware --skill orchestrator --skill brainstorm
+
+# List available skills
+npx skills add YuluoY/ironware --list
+```
+
+Supports **40+ agents**: Claude Code, GitHub Copilot, Cursor, Codex, Windsurf, Cline, OpenCode, Gemini CLI, Trae, CodeBuddy, and more.
+
+### Per-Agent Manual Installation
+
+<details>
+<summary><b>Claude Code</b></summary>
+
+```bash
+git clone https://github.com/YuluoY/ironware.git ~/.claude/ironweave
+mkdir -p ~/.claude/skills
+ln -s ~/.claude/ironweave/skills ~/.claude/skills/ironweave
+```
+
+Or use the Claude plugin system — Ironweave ships with `.claude-plugin/plugin.json`.
+
+</details>
+
+<details>
+<summary><b>VS Code GitHub Copilot</b></summary>
+
+Copy the `skills/` directory into your project, then add to `.github/copilot-instructions.md`:
+
+```markdown
+The orchestrator skill (skills/orchestrator/SKILL.md) is the main entry point.
+For any development task, start by reading it.
+```
+
+Or clone Ironweave directly — it ships with `.github/copilot-instructions.md` pre-configured.
+
+</details>
+
+<details>
+<summary><b>Cursor</b></summary>
+
+```bash
+git clone https://github.com/YuluoY/ironware.git
+```
+
+Ironweave ships with `.cursorrules` and `.cursor-plugin/plugin.json` for auto-discovery.
+
+</details>
+
+<details>
+<summary><b>Codex (OpenAI)</b></summary>
+
+```bash
+git clone https://github.com/YuluoY/ironware.git ~/.codex/ironweave
+mkdir -p ~/.agents/skills
+ln -s ~/.codex/ironweave/skills ~/.agents/skills/ironweave
+```
+
+See [.codex/INSTALL.md](./.codex/INSTALL.md) for details.
+
+</details>
+
+<details>
+<summary><b>OpenCode</b></summary>
+
+Add to your `opencode.json`:
+
+```json
+{
+  "plugin": ["ironweave@git+https://github.com/YuluoY/ironware.git"]
+}
+```
+
+See [.opencode/INSTALL.md](./.opencode/INSTALL.md) for details.
+
+</details>
+
+<details>
+<summary><b>Windsurf / Cline / Gemini CLI</b></summary>
+
+Ironweave ships with `.windsurfrules`, `.clinerules`, and `GEMINI.md` respectively. Clone the repo and the agent auto-discovers the rules.
+
+```bash
+git clone https://github.com/YuluoY/ironware.git
+```
+
+</details>
+
+<details>
+<summary><b>Trae / CodeBuddy / Other Agents</b></summary>
+
+Copy the `skills/` directory into your project. Then add the following to your agent's custom instructions:
+
+> The orchestrator skill (`skills/orchestrator/SKILL.md`) is the main entry point. For any development task, start by reading it. All skills are in `skills/`, each with a `SKILL.md` containing instructions.
+
+</details>
+
+## Project Structure
+
+```
+ironweave/
+├── skills/
+│   ├── orchestrator/              # Flow orchestrator
+│   │   ├── SKILL.md              # Orchestrator logic
+│   │   └── references/           # Methodology docs
+│   ├── brainstorm/
+│   ├── spec-writing/
+│   ├── code-scaffold/
+│   ├── ...                        # 16 more skills
+│   └── skill-creator/
+├── CLAUDE.md                      # Claude Code instructions
+├── AGENTS.md                      # Codex instructions
+├── GEMINI.md                      # Gemini CLI instructions
+├── .github/copilot-instructions.md  # VS Code Copilot
+├── .cursorrules                   # Cursor rules
+├── .windsurfrules                 # Windsurf rules
+├── .clinerules                    # Cline rules
+├── .claude-plugin/plugin.json     # Claude plugin manifest
+├── .cursor-plugin/plugin.json     # Cursor plugin manifest
+├── .codex/INSTALL.md              # Codex install guide
+├── .opencode/INSTALL.md           # OpenCode install guide
+├── README.md
+├── README_CN.md
+├── CONTRIBUTING.md
+├── LICENSE
+└── package.json
+```
+
+## Philosophy
+
+- **Adaptive routing** over linear workflows — different task types need different flows
+- **Quality gates with reflow** over pass/fail — failures route back to the right phase
+- **Scope slicing** before execution — large tasks split into ordered, independently deliverable slices
+- **Overhead scales with complexity** — simple tasks stay fast (lite), hard tasks get full rigor (plus)
+- **Skills as methodology** — each skill encodes decision trees, not just templates
+
+## Contributing
+
+See [CONTRIBUTING.md](./CONTRIBUTING.md). Skills live directly in this repository. Follow `skills/skill-creator` for creating and testing new skills.
+
+## License
+
+[MIT](./LICENSE) © Ironweave Contributors