@rune-kit/rune 2.1.1
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/LICENSE +21 -0
- package/README.md +357 -0
- package/agents/.gitkeep +0 -0
- package/agents/architect.md +29 -0
- package/agents/asset-creator.md +11 -0
- package/agents/audit.md +11 -0
- package/agents/autopsy.md +11 -0
- package/agents/brainstorm.md +11 -0
- package/agents/browser-pilot.md +11 -0
- package/agents/coder.md +29 -0
- package/agents/completion-gate.md +11 -0
- package/agents/constraint-check.md +11 -0
- package/agents/context-engine.md +11 -0
- package/agents/cook.md +11 -0
- package/agents/db.md +11 -0
- package/agents/debug.md +11 -0
- package/agents/dependency-doctor.md +11 -0
- package/agents/deploy.md +11 -0
- package/agents/design.md +11 -0
- package/agents/docs-seeker.md +11 -0
- package/agents/fix.md +11 -0
- package/agents/hallucination-guard.md +11 -0
- package/agents/incident.md +11 -0
- package/agents/integrity-check.md +11 -0
- package/agents/journal.md +11 -0
- package/agents/launch.md +11 -0
- package/agents/logic-guardian.md +11 -0
- package/agents/marketing.md +11 -0
- package/agents/onboard.md +11 -0
- package/agents/perf.md +11 -0
- package/agents/plan.md +11 -0
- package/agents/preflight.md +11 -0
- package/agents/problem-solver.md +11 -0
- package/agents/rescue.md +11 -0
- package/agents/research.md +11 -0
- package/agents/researcher.md +29 -0
- package/agents/review-intake.md +11 -0
- package/agents/review.md +11 -0
- package/agents/reviewer.md +28 -0
- package/agents/safeguard.md +11 -0
- package/agents/sast.md +11 -0
- package/agents/scanner.md +28 -0
- package/agents/scope-guard.md +11 -0
- package/agents/scout.md +11 -0
- package/agents/sentinel.md +11 -0
- package/agents/sequential-thinking.md +11 -0
- package/agents/session-bridge.md +11 -0
- package/agents/skill-forge.md +11 -0
- package/agents/skill-router.md +11 -0
- package/agents/surgeon.md +11 -0
- package/agents/team.md +11 -0
- package/agents/test.md +11 -0
- package/agents/trend-scout.md +11 -0
- package/agents/verification.md +11 -0
- package/agents/video-creator.md +11 -0
- package/agents/watchdog.md +11 -0
- package/agents/worktree.md +11 -0
- package/commands/.gitkeep +0 -0
- package/commands/rune.md +168 -0
- package/compiler/__tests__/openclaw-adapter.test.js +140 -0
- package/compiler/__tests__/parser.test.js +55 -0
- package/compiler/adapters/antigravity.js +59 -0
- package/compiler/adapters/claude.js +37 -0
- package/compiler/adapters/cursor.js +67 -0
- package/compiler/adapters/generic.js +60 -0
- package/compiler/adapters/index.js +45 -0
- package/compiler/adapters/openclaw.js +150 -0
- package/compiler/adapters/windsurf.js +60 -0
- package/compiler/bin/rune.js +288 -0
- package/compiler/doctor.js +153 -0
- package/compiler/emitter.js +240 -0
- package/compiler/parser.js +208 -0
- package/compiler/transformer.js +69 -0
- package/compiler/transforms/branding.js +27 -0
- package/compiler/transforms/cross-references.js +29 -0
- package/compiler/transforms/frontmatter.js +38 -0
- package/compiler/transforms/hooks.js +68 -0
- package/compiler/transforms/subagents.js +36 -0
- package/compiler/transforms/tool-names.js +60 -0
- package/contexts/dev.md +34 -0
- package/contexts/research.md +43 -0
- package/contexts/review.md +55 -0
- package/extensions/ai-ml/PACK.md +517 -0
- package/extensions/analytics/PACK.md +557 -0
- package/extensions/backend/PACK.md +678 -0
- package/extensions/chrome-ext/PACK.md +995 -0
- package/extensions/content/PACK.md +381 -0
- package/extensions/devops/PACK.md +520 -0
- package/extensions/ecommerce/PACK.md +280 -0
- package/extensions/gamedev/PACK.md +393 -0
- package/extensions/mobile/PACK.md +273 -0
- package/extensions/saas/PACK.md +805 -0
- package/extensions/security/PACK.md +536 -0
- package/extensions/trading/PACK.md +597 -0
- package/extensions/ui/PACK.md +947 -0
- package/package.json +47 -0
- package/skills/.gitkeep +0 -0
- package/skills/adversary/SKILL.md +271 -0
- package/skills/asset-creator/SKILL.md +157 -0
- package/skills/audit/SKILL.md +466 -0
- package/skills/autopsy/SKILL.md +200 -0
- package/skills/ba/SKILL.md +279 -0
- package/skills/brainstorm/SKILL.md +266 -0
- package/skills/browser-pilot/SKILL.md +168 -0
- package/skills/completion-gate/SKILL.md +151 -0
- package/skills/constraint-check/SKILL.md +165 -0
- package/skills/context-engine/SKILL.md +176 -0
- package/skills/cook/SKILL.md +636 -0
- package/skills/db/SKILL.md +256 -0
- package/skills/debug/SKILL.md +240 -0
- package/skills/dependency-doctor/SKILL.md +235 -0
- package/skills/deploy/SKILL.md +174 -0
- package/skills/design/DESIGN-REFERENCE.md +365 -0
- package/skills/design/SKILL.md +462 -0
- package/skills/doc-processor/SKILL.md +254 -0
- package/skills/docs/SKILL.md +336 -0
- package/skills/docs-seeker/SKILL.md +166 -0
- package/skills/fix/SKILL.md +192 -0
- package/skills/git/SKILL.md +285 -0
- package/skills/hallucination-guard/SKILL.md +204 -0
- package/skills/incident/SKILL.md +241 -0
- package/skills/integrity-check/SKILL.md +169 -0
- package/skills/journal/SKILL.md +190 -0
- package/skills/launch/SKILL.md +330 -0
- package/skills/logic-guardian/SKILL.md +240 -0
- package/skills/marketing/SKILL.md +229 -0
- package/skills/mcp-builder/SKILL.md +311 -0
- package/skills/onboard/SKILL.md +298 -0
- package/skills/perf/SKILL.md +297 -0
- package/skills/plan/SKILL.md +520 -0
- package/skills/preflight/SKILL.md +231 -0
- package/skills/problem-solver/SKILL.md +284 -0
- package/skills/rescue/SKILL.md +434 -0
- package/skills/research/SKILL.md +122 -0
- package/skills/review/SKILL.md +354 -0
- package/skills/review-intake/SKILL.md +222 -0
- package/skills/safeguard/SKILL.md +188 -0
- package/skills/sast/SKILL.md +190 -0
- package/skills/scaffold/SKILL.md +276 -0
- package/skills/scope-guard/SKILL.md +150 -0
- package/skills/scout/SKILL.md +232 -0
- package/skills/sentinel/SKILL.md +320 -0
- package/skills/sentinel-env/SKILL.md +226 -0
- package/skills/sequential-thinking/SKILL.md +234 -0
- package/skills/session-bridge/SKILL.md +287 -0
- package/skills/skill-forge/SKILL.md +317 -0
- package/skills/skill-router/SKILL.md +267 -0
- package/skills/surgeon/SKILL.md +203 -0
- package/skills/team/SKILL.md +397 -0
- package/skills/test/SKILL.md +271 -0
- package/skills/trend-scout/SKILL.md +145 -0
- package/skills/verification/SKILL.md +201 -0
- package/skills/video-creator/SKILL.md +201 -0
- package/skills/watchdog/SKILL.md +166 -0
- package/skills/worktree/SKILL.md +140 -0
package/LICENSE
ADDED
|
@@ -0,0 +1,21 @@
|
|
|
1
|
+
MIT License
|
|
2
|
+
|
|
3
|
+
Copyright (c) 2026 Rune Contributors
|
|
4
|
+
|
|
5
|
+
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
6
|
+
of this software and associated documentation files (the "Software"), to deal
|
|
7
|
+
in the Software without restriction, including without limitation the rights
|
|
8
|
+
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
9
|
+
copies of the Software, and to permit persons to whom the Software is
|
|
10
|
+
furnished to do so, subject to the following conditions:
|
|
11
|
+
|
|
12
|
+
The above copyright notice and this permission notice shall be included in all
|
|
13
|
+
copies or substantial portions of the Software.
|
|
14
|
+
|
|
15
|
+
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
16
|
+
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
17
|
+
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
18
|
+
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
19
|
+
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
20
|
+
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
|
|
21
|
+
SOFTWARE.
|
package/README.md
ADDED
|
@@ -0,0 +1,357 @@
|
|
|
1
|
+
# Rune
|
|
2
|
+
|
|
3
|
+
**Less skills. Deeper connections.**
|
|
4
|
+
|
|
5
|
+
A lean, interconnected skill ecosystem for AI coding assistants. 55 skills, 200+ mesh connections, full project lifecycle — from idea to production.
|
|
6
|
+
|
|
7
|
+
Works on **Claude Code** (native plugin) · **Cursor** · **Windsurf** · **Google Antigravity** · any AI IDE
|
|
8
|
+
|
|
9
|
+
## Why Rune?
|
|
10
|
+
|
|
11
|
+
Most skill ecosystems are either **too many isolated skills** (540+ that don't talk to each other) or **rigid pipelines** (A → B → C, if B fails everything stops).
|
|
12
|
+
|
|
13
|
+
Rune is a **mesh** — 55 skills with 200+ connections across a 5-layer architecture. Skills call each other bidirectionally, forming resilient workflows that adapt when things go wrong.
|
|
14
|
+
|
|
15
|
+
```
|
|
16
|
+
Pipeline: A → B → C → D (B fails = stuck)
|
|
17
|
+
Hub-Spoke: A → HUB → C (HUB fails = stuck)
|
|
18
|
+
Mesh: A ↔ B ↔ C (B fails = A reaches C via D→E)
|
|
19
|
+
↕ ↕
|
|
20
|
+
D ↔ E ↔ F
|
|
21
|
+
```
|
|
22
|
+
|
|
23
|
+
## What's New (v2.1.0)
|
|
24
|
+
|
|
25
|
+
- **Phase-Aware Execution** — cook v0.5.0 resumes multi-session plans automatically. Master plan + phase files = one phase per session, any model executes accurately
|
|
26
|
+
- **Amateur-Proof Plans** — plan v0.4.0 generates self-contained phase files with data flow diagrams, code contracts, failure scenarios, and rejection criteria. Designed so even the weakest model succeeds
|
|
27
|
+
- **Cognitive Bias Detection** — problem-solver v0.3.0 runs mandatory bias checks (12 biases) before every analysis. Reversibility Filter, Pre-Mortem, Weighted Matrix, MECE decomposition
|
|
28
|
+
- **Second-Order Thinking** — sequential-thinking v0.3.0 classifies decision reversibility, traces cascading effects, and cross-checks for anchoring/status-quo/overconfidence biases
|
|
29
|
+
- **6 New Skills** — ba (business analyst), scaffold (project bootstrap), docs (documentation lifecycle), git (semantic commits), mcp-builder (MCP server generator), doc-processor (PDF/DOCX/XLSX)
|
|
30
|
+
- **Multi-Platform Compiler** — all 55 skills compile to Cursor, Windsurf, Antigravity, and generic formats with zero knowledge loss
|
|
31
|
+
|
|
32
|
+
## What Rune Is (and Isn't)
|
|
33
|
+
|
|
34
|
+
Rune started as a **Claude Code plugin** and now compiles to **every major AI IDE**. Same 55 skills, same mesh connections, same workflows — zero knowledge loss across platforms.
|
|
35
|
+
|
|
36
|
+
| | Rune Provides | Claude Code Provides |
|
|
37
|
+
|---|---|---|
|
|
38
|
+
| **Workflows** | 8-phase TDD cycle (cook), parallel DAG execution (team), rescue pipelines | Basic tool calling |
|
|
39
|
+
| **Quality Gates** | preflight + sentinel + review + completion-gate (parallel) | None built-in |
|
|
40
|
+
| **Domain Knowledge** | 12 extension packs (trading, SaaS, mobile, etc.) | General-purpose |
|
|
41
|
+
| **Cross-Session State** | .rune/ directory (decisions, conventions, progress) | Conversation only |
|
|
42
|
+
| **Mesh Resilience** | 200+ skill connections, fail-loud-route-around | Linear execution |
|
|
43
|
+
| **Cost Optimization** | Auto model selection (haiku/sonnet/opus per task) | Single model |
|
|
44
|
+
| | | |
|
|
45
|
+
| **Sandbox & Permissions** | — | Claude Code handles this |
|
|
46
|
+
| **Agent Spawning** | — | Claude Code's Task/Agent system |
|
|
47
|
+
| **MCP Integration** | — | Claude Code's MCP protocol |
|
|
48
|
+
| **File System Access** | — | Claude Code's tool permissions |
|
|
49
|
+
|
|
50
|
+
### Common Misconceptions
|
|
51
|
+
|
|
52
|
+
| "Rune doesn't have..." | Reality |
|
|
53
|
+
|---|---|
|
|
54
|
+
| Task graph / DAG | `team` skill: DAG decomposition → parallel worktree agents → merge coordination |
|
|
55
|
+
| CI quality gates | `verification` skill: lint + typecheck + tests + build (actual commands, not LLM review) |
|
|
56
|
+
| Memory / state | `session-bridge` + `journal`: cross-session decisions, conventions, ADRs, module health |
|
|
57
|
+
| Multi-model strategy | Every skill has assigned model: haiku (scan), sonnet (code), opus (architecture) |
|
|
58
|
+
| Agent specialization | 55 specialized skills with dedicated roles (architect, coder, reviewer, scanner, researcher, BA, scaffolder) — each runs as a Task agent via Claude Code |
|
|
59
|
+
| Security scanning | `sentinel`: OWASP patterns, secret scanning, dependency audit. `sast`: static analysis |
|
|
60
|
+
|
|
61
|
+
## Install
|
|
62
|
+
|
|
63
|
+
### Claude Code (Native Plugin)
|
|
64
|
+
|
|
65
|
+
```bash
|
|
66
|
+
# Via Claude Code plugin marketplace
|
|
67
|
+
/plugin marketplace add rune-kit/rune
|
|
68
|
+
/plugin install rune@rune-kit
|
|
69
|
+
```
|
|
70
|
+
|
|
71
|
+
Full mesh: subagents, hooks, adaptive routing, mesh analytics.
|
|
72
|
+
|
|
73
|
+
### Cursor / Windsurf / Antigravity / Any IDE
|
|
74
|
+
|
|
75
|
+
```bash
|
|
76
|
+
# Compile Rune skills for your platform
|
|
77
|
+
npx @rune-kit/rune init
|
|
78
|
+
|
|
79
|
+
# Or specify platform explicitly
|
|
80
|
+
npx @rune-kit/rune init --platform cursor
|
|
81
|
+
npx @rune-kit/rune init --platform windsurf
|
|
82
|
+
npx @rune-kit/rune init --platform antigravity
|
|
83
|
+
```
|
|
84
|
+
|
|
85
|
+
This compiles all 55 skills into your IDE's rules format. Same knowledge, same workflows.
|
|
86
|
+
|
|
87
|
+
### Platform Comparison
|
|
88
|
+
|
|
89
|
+
| Feature | Claude Code | Cursor / Windsurf / Others |
|
|
90
|
+
|---------|-------------|---------------------------|
|
|
91
|
+
| Skills available | 55/55 | 55/55 |
|
|
92
|
+
| Mesh connections | 200+ (programmatic) | 200+ (rule references) |
|
|
93
|
+
| Workflows & HARD-GATEs | Full | Full |
|
|
94
|
+
| Extension packs | 12 | 12 |
|
|
95
|
+
| Subagent parallelism | Native | Sequential fallback |
|
|
96
|
+
| Lifecycle hooks | 8 hooks (JS runtime) | Inline MUST/NEVER constraints |
|
|
97
|
+
| Adaptive model routing | haiku/sonnet/opus | Single model |
|
|
98
|
+
| Mesh analytics | Real-time metrics | Not available |
|
|
99
|
+
|
|
100
|
+
**Same power, different delivery.** Claude Code gets execution efficiency; other IDEs get the same knowledge and workflows.
|
|
101
|
+
|
|
102
|
+
## Quick Start
|
|
103
|
+
|
|
104
|
+
```bash
|
|
105
|
+
# Onboard any project (generates CLAUDE.md + .rune/ context)
|
|
106
|
+
/rune onboard
|
|
107
|
+
|
|
108
|
+
# Build a feature (full TDD cycle)
|
|
109
|
+
/rune cook "add user authentication with JWT"
|
|
110
|
+
|
|
111
|
+
# Debug an issue
|
|
112
|
+
/rune debug "login returns 401 for valid credentials"
|
|
113
|
+
|
|
114
|
+
# Security scan before commit
|
|
115
|
+
/rune sentinel
|
|
116
|
+
|
|
117
|
+
# Refactor legacy code safely
|
|
118
|
+
/rune rescue
|
|
119
|
+
|
|
120
|
+
# Full project health audit
|
|
121
|
+
/rune audit
|
|
122
|
+
|
|
123
|
+
# Respond to a production incident
|
|
124
|
+
/rune incident "login service returning 503 for 30% of users"
|
|
125
|
+
|
|
126
|
+
# Generate design system before building UI
|
|
127
|
+
/rune design "trading dashboard with real-time data"
|
|
128
|
+
|
|
129
|
+
# Bootstrap a new project from scratch (v2.1.0)
|
|
130
|
+
/rune scaffold "REST API with auth, payments, and Docker"
|
|
131
|
+
|
|
132
|
+
# Deep requirement analysis before building
|
|
133
|
+
/rune ba "integrate Telegram bot with trading signals"
|
|
134
|
+
|
|
135
|
+
# Auto-generate project documentation
|
|
136
|
+
/rune docs init
|
|
137
|
+
|
|
138
|
+
# Build an MCP server
|
|
139
|
+
/rune mcp-builder "weather API with forecast tools"
|
|
140
|
+
```
|
|
141
|
+
|
|
142
|
+
## Architecture
|
|
143
|
+
|
|
144
|
+
### 5-Layer Model
|
|
145
|
+
|
|
146
|
+
```
|
|
147
|
+
╔══════════════════════════════════════════════════════╗
|
|
148
|
+
║ L0: ROUTER (1) ║
|
|
149
|
+
║ Meta-enforcement — routes every action ║
|
|
150
|
+
║ skill-router ║
|
|
151
|
+
╠══════════════════════════════════════════════════════╣
|
|
152
|
+
║ L1: ORCHESTRATORS (5) ║
|
|
153
|
+
║ Full lifecycle workflows ║
|
|
154
|
+
║ cook │ team │ launch │ rescue │ scaffold ║
|
|
155
|
+
╠══════════════════════════════════════════════════════╣
|
|
156
|
+
║ L2: WORKFLOW HUBS (26) ║
|
|
157
|
+
║ Cross-hub mesh — the key differentiator ║
|
|
158
|
+
║ ║
|
|
159
|
+
║ Creation: plan │ scout │ brainstorm │ design │ ║
|
|
160
|
+
║ skill-forge │ ba │ mcp-builder ║
|
|
161
|
+
║ Development: debug │ fix │ test │ review │ db ║
|
|
162
|
+
║ Quality: sentinel │ preflight │ onboard │ ║
|
|
163
|
+
║ audit │ perf │ review-intake │ ║
|
|
164
|
+
║ logic-guardian ║
|
|
165
|
+
║ Delivery: deploy │ marketing │ incident │ docs ║
|
|
166
|
+
║ Rescue: autopsy │ safeguard │ surgeon ║
|
|
167
|
+
╠══════════════════════════════════════════════════════╣
|
|
168
|
+
║ L3: UTILITIES (23) ║
|
|
169
|
+
║ Stateless, pure capabilities ║
|
|
170
|
+
║ ║
|
|
171
|
+
║ Knowledge: research │ docs-seeker │ trend-scout ║
|
|
172
|
+
║ Reasoning: problem-solver │ sequential-thinking ║
|
|
173
|
+
║ Validation: verification │ hallucination-guard │ ║
|
|
174
|
+
║ completion-gate │ constraint-check │ ║
|
|
175
|
+
║ sast │ integrity-check ║
|
|
176
|
+
║ State: context-engine │ journal │ ║
|
|
177
|
+
║ session-bridge ║
|
|
178
|
+
║ Monitoring: watchdog │ scope-guard ║
|
|
179
|
+
║ Media: browser-pilot │ asset-creator │ ║
|
|
180
|
+
║ video-creator ║
|
|
181
|
+
║ Deps: dependency-doctor ║
|
|
182
|
+
║ Workspace: worktree ║
|
|
183
|
+
║ Git: git ║
|
|
184
|
+
║ Documents: doc-processor ║
|
|
185
|
+
╠══════════════════════════════════════════════════════╣
|
|
186
|
+
║ L4: EXTENSION PACKS (12) ║
|
|
187
|
+
║ Domain-specific, install what you need ║
|
|
188
|
+
║ ║
|
|
189
|
+
║ @rune/ui │ @rune/backend │ @rune/devops │ ║
|
|
190
|
+
║ @rune/mobile │ @rune/security │ @rune/trading │ ║
|
|
191
|
+
║ @rune/saas │ @rune/ecommerce │ @rune/ai-ml │ ║
|
|
192
|
+
║ @rune/gamedev │ @rune/content │ @rune/analytics ║
|
|
193
|
+
╚══════════════════════════════════════════════════════╝
|
|
194
|
+
```
|
|
195
|
+
|
|
196
|
+
### Layer Rules
|
|
197
|
+
|
|
198
|
+
| Layer | Can Call | Called By | State |
|
|
199
|
+
|-------|---------|----------|-------|
|
|
200
|
+
| L0 Router | L1-L3 (routing) | Every message | Stateless |
|
|
201
|
+
| L1 Orchestrators | L2, L3 | L0, User | Stateful (workflow) |
|
|
202
|
+
| L2 Workflow Hubs | L2 (cross-hub), L3 | L1, L2 | Stateful (task) |
|
|
203
|
+
| L3 Utilities | Nothing (pure)* | L1, L2 | Stateless |
|
|
204
|
+
| L4 Extensions | L3 | L2 (domain match) | Config-based |
|
|
205
|
+
|
|
206
|
+
\*L3→L3 exceptions: `context-engine`→`session-bridge`, `hallucination-guard`→`research`, `session-bridge`→`integrity-check`
|
|
207
|
+
|
|
208
|
+
### Cost Intelligence
|
|
209
|
+
|
|
210
|
+
Every skill has an auto-selected model for optimal cost:
|
|
211
|
+
|
|
212
|
+
| Task Type | Model | Cost |
|
|
213
|
+
|-----------|-------|------|
|
|
214
|
+
| Scan, search, validate | Haiku | Cheapest |
|
|
215
|
+
| Write code, fix bugs, review | Sonnet | Default |
|
|
216
|
+
| Architecture, security audit | Opus | Deep reasoning |
|
|
217
|
+
|
|
218
|
+
Typical feature: ~$0.05-0.15 (vs ~$0.60 all-opus).
|
|
219
|
+
|
|
220
|
+
## Key Workflows
|
|
221
|
+
|
|
222
|
+
### `/rune cook` — Build a Feature
|
|
223
|
+
|
|
224
|
+
```
|
|
225
|
+
Phase 0 RESUME → detect existing .rune/plan-*.md, load active phase
|
|
226
|
+
Phase 1 UNDERSTAND → scout scans codebase, ba elicits requirements
|
|
227
|
+
Phase 2 PLAN → plan creates master plan + phase files
|
|
228
|
+
Phase 3 TEST → test writes failing tests (TDD red)
|
|
229
|
+
Phase 4 IMPLEMENT → fix writes code (TDD green)
|
|
230
|
+
Phase 5 QUALITY → preflight + sentinel + review (parallel)
|
|
231
|
+
Phase 6 VERIFY → verification + hallucination-guard
|
|
232
|
+
Phase 7 COMMIT → git creates semantic commit
|
|
233
|
+
Phase 8 BRIDGE → session-bridge saves state, announce next phase
|
|
234
|
+
```
|
|
235
|
+
|
|
236
|
+
Multi-session: Phase 0 detects existing plans and resumes from the current phase. One phase per session = small context = better code.
|
|
237
|
+
|
|
238
|
+
### `/rune rescue` — Refactor Legacy Code
|
|
239
|
+
|
|
240
|
+
```
|
|
241
|
+
Phase 0 RECON → autopsy assesses damage (health score)
|
|
242
|
+
Phase 1 SAFETY NET → safeguard writes characterization tests
|
|
243
|
+
Phase 2-N SURGERY → surgeon refactors 1 module per session
|
|
244
|
+
Phase N+1 CLEANUP → remove @legacy markers
|
|
245
|
+
Phase N+2 VERIFY → health score comparison (before vs after)
|
|
246
|
+
```
|
|
247
|
+
|
|
248
|
+
### `/rune launch` — Deploy + Market
|
|
249
|
+
|
|
250
|
+
```
|
|
251
|
+
Phase 1 PRE-FLIGHT → full test suite
|
|
252
|
+
Phase 2 DEPLOY → push to platform
|
|
253
|
+
Phase 3 VERIFY → live site checks + monitoring
|
|
254
|
+
Phase 4 MARKET → landing copy, social, SEO
|
|
255
|
+
Phase 5 ANNOUNCE → publish content
|
|
256
|
+
```
|
|
257
|
+
|
|
258
|
+
## Mesh Resilience
|
|
259
|
+
|
|
260
|
+
If a skill fails, the mesh adapts:
|
|
261
|
+
|
|
262
|
+
| If this fails... | Rune tries... |
|
|
263
|
+
|---|---|
|
|
264
|
+
| debug can't find cause | problem-solver (different reasoning) |
|
|
265
|
+
| docs-seeker can't find docs | research (broader web search) |
|
|
266
|
+
| scout can't find files | research + docs-seeker |
|
|
267
|
+
| test can't run | deploy fix env, then test again |
|
|
268
|
+
|
|
269
|
+
Loop prevention: max 2 visits per skill, max chain depth 8.
|
|
270
|
+
|
|
271
|
+
## Cross-Session Persistence
|
|
272
|
+
|
|
273
|
+
Rune preserves context across sessions via `.rune/`:
|
|
274
|
+
|
|
275
|
+
```
|
|
276
|
+
.rune/
|
|
277
|
+
├── decisions.md — architectural decisions log
|
|
278
|
+
├── conventions.md — established patterns & style
|
|
279
|
+
├── progress.md — task progress tracker
|
|
280
|
+
└── session-log.md — brief session history
|
|
281
|
+
```
|
|
282
|
+
|
|
283
|
+
Every new session loads `.rune/` automatically — zero context loss.
|
|
284
|
+
|
|
285
|
+
## Extension Packs
|
|
286
|
+
|
|
287
|
+
Domain-specific skills that plug into the core mesh:
|
|
288
|
+
|
|
289
|
+
| Pack | Skills | For |
|
|
290
|
+
|------|--------|-----|
|
|
291
|
+
| @rune/ui | design-system, components, a11y, animation | Frontend |
|
|
292
|
+
| @rune/backend | api, auth, database, middleware | Backend |
|
|
293
|
+
| @rune/devops | docker, ci-cd, monitoring, server, ssl | DevOps |
|
|
294
|
+
| @rune/mobile | react-native, flutter, app-store, native | Mobile |
|
|
295
|
+
| @rune/security | owasp, pentest, secrets, compliance | Security |
|
|
296
|
+
| @rune/trading | fintech, realtime, charts, indicators | Fintech |
|
|
297
|
+
| @rune/saas | multi-tenant, billing, subscription, onboarding | SaaS |
|
|
298
|
+
| @rune/ecommerce | shopify, payment, cart, inventory | E-commerce |
|
|
299
|
+
| @rune/ai-ml | llm, rag, embeddings, fine-tuning | AI/ML |
|
|
300
|
+
| @rune/gamedev | threejs, webgl, game-loops, physics | Games |
|
|
301
|
+
| @rune/content | blog, cms, mdx, i18n, seo | Content |
|
|
302
|
+
| @rune/analytics | tracking, a/b testing, funnels, dashboards | Growth |
|
|
303
|
+
|
|
304
|
+
### Rune Pro (Premium)
|
|
305
|
+
|
|
306
|
+
Business department packs for product, sales, and data teams. Same PACK.md format, plugs into the core mesh.
|
|
307
|
+
|
|
308
|
+
| Pack | Skills | For |
|
|
309
|
+
|------|--------|-----|
|
|
310
|
+
| @rune-pro/product | feature-spec, roadmap, metrics, release-comms, user-research, competitive | Product Management |
|
|
311
|
+
| @rune-pro/sales | account-research, call-prep, outreach, pipeline-review, competitive-intel | Sales Enablement |
|
|
312
|
+
| @rune-pro/data-science | data-exploration, sql-advanced, visualization, statistical-testing, dashboards | Data Science |
|
|
313
|
+
|
|
314
|
+
Coming soon. See [docs/plans/RUNE-PRO-PLAN.md](docs/plans/RUNE-PRO-PLAN.md) for the full roadmap.
|
|
315
|
+
|
|
316
|
+
## Multi-Platform Compiler
|
|
317
|
+
|
|
318
|
+
Rune includes a 3-stage compiler that transforms SKILL.md files into platform-native rule formats:
|
|
319
|
+
|
|
320
|
+
```
|
|
321
|
+
skills/*.md → PARSE → TRANSFORM → EMIT → platform rules
|
|
322
|
+
```
|
|
323
|
+
|
|
324
|
+
**6 transforms applied per platform:**
|
|
325
|
+
1. Cross-references: `rune:cook` → `@rune-cook.mdc` (Cursor) / prose ref (Windsurf)
|
|
326
|
+
2. Tool names: `Read`, `Edit`, `Bash` → generic language
|
|
327
|
+
3. Frontmatter: strip Claude Code-specific directives
|
|
328
|
+
4. Subagents: parallel → sequential workflow
|
|
329
|
+
5. Hooks: runtime hooks → inline MUST/NEVER constraints
|
|
330
|
+
6. Branding: Rune attribution footer
|
|
331
|
+
|
|
332
|
+
```bash
|
|
333
|
+
# Build for any platform
|
|
334
|
+
npx @rune-kit/rune build --platform cursor
|
|
335
|
+
npx @rune-kit/rune build --platform windsurf
|
|
336
|
+
|
|
337
|
+
# Validate compiled output
|
|
338
|
+
npx @rune-kit/rune doctor
|
|
339
|
+
```
|
|
340
|
+
|
|
341
|
+
See [docs/MULTI-PLATFORM.md](docs/MULTI-PLATFORM.md) for the full architecture.
|
|
342
|
+
|
|
343
|
+
## Numbers
|
|
344
|
+
|
|
345
|
+
```
|
|
346
|
+
Core Skills: 55 (L0: 1 │ L1: 5 │ L2: 26 │ L3: 23)
|
|
347
|
+
Extension Packs: 12 free + 3 pro (coming soon)
|
|
348
|
+
Mesh Connections: 206 cross-references + 151 tool references
|
|
349
|
+
Connections/Skill: 3.7 avg
|
|
350
|
+
Platforms: 5 (Claude Code, Cursor, Windsurf, Antigravity, Generic)
|
|
351
|
+
Compiler: ~1200 LOC (parser + transforms + adapters + CLI)
|
|
352
|
+
Quality: 55/55 skills with Output Format, Sharp Edges, Done When, Cost Profile
|
|
353
|
+
```
|
|
354
|
+
|
|
355
|
+
## License
|
|
356
|
+
|
|
357
|
+
MIT
|
package/agents/.gitkeep
ADDED
|
File without changes
|
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: architect
|
|
3
|
+
description: Architecture and planning agent. Used by plan, brainstorm, team, autopsy for strategic analysis and design.
|
|
4
|
+
model: opus
|
|
5
|
+
subagent_type: Plan
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Architect Agent
|
|
9
|
+
|
|
10
|
+
Deep reasoning agent for architectural decisions, system design, and strategic planning. Uses opus for maximum reasoning depth.
|
|
11
|
+
|
|
12
|
+
## Capabilities
|
|
13
|
+
|
|
14
|
+
- System architecture design
|
|
15
|
+
- Task decomposition and dependency analysis
|
|
16
|
+
- Trade-off evaluation (2-3 approaches with pros/cons)
|
|
17
|
+
- Legacy code health assessment
|
|
18
|
+
- Refactoring strategy planning
|
|
19
|
+
|
|
20
|
+
## Usage
|
|
21
|
+
|
|
22
|
+
Called by L1 orchestrators and L2 creation/rescue skills for strategic decisions.
|
|
23
|
+
|
|
24
|
+
## Constraints
|
|
25
|
+
|
|
26
|
+
- Planning only — does not write code
|
|
27
|
+
- Must provide actionable implementation steps
|
|
28
|
+
- Must consider existing project conventions
|
|
29
|
+
- Returns structured plans, not prose
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: asset-creator
|
|
3
|
+
description: "Creates code-based visual assets — SVG icons, OG images, social banners."
|
|
4
|
+
model: sonnet
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are the **asset-creator** skill of the Rune plugin.
|
|
9
|
+
|
|
10
|
+
Your full skill definition is in `skills/asset-creator/SKILL.md` relative to the plugin root.
|
|
11
|
+
Read that file and execute every step precisely. Do not skip steps or improvise beyond what the SKILL.md specifies.
|
package/agents/audit.md
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: audit
|
|
3
|
+
description: "Comprehensive project health audit across 8 dimensions."
|
|
4
|
+
model: opus
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are the **audit** skill of the Rune plugin.
|
|
9
|
+
|
|
10
|
+
Your full skill definition is in `skills/audit/SKILL.md` relative to the plugin root.
|
|
11
|
+
Read that file and execute every step precisely. Do not skip steps or improvise beyond what the SKILL.md specifies.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: autopsy
|
|
3
|
+
description: "Full codebase health assessment. Analyzes complexity, dependencies, dead code, tech debt."
|
|
4
|
+
model: opus
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are the **autopsy** skill of the Rune plugin.
|
|
9
|
+
|
|
10
|
+
Your full skill definition is in `skills/autopsy/SKILL.md` relative to the plugin root.
|
|
11
|
+
Read that file and execute every step precisely. Do not skip steps or improvise beyond what the SKILL.md specifies.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: brainstorm
|
|
3
|
+
description: "Creative ideation and solution exploration. Generates multiple approaches with trade-offs."
|
|
4
|
+
model: opus
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are the **brainstorm** skill of the Rune plugin.
|
|
9
|
+
|
|
10
|
+
Your full skill definition is in `skills/brainstorm/SKILL.md` relative to the plugin root.
|
|
11
|
+
Read that file and execute every step precisely. Do not skip steps or improvise beyond what the SKILL.md specifies.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: browser-pilot
|
|
3
|
+
description: "Browser automation for testing and verification using Playwright."
|
|
4
|
+
model: sonnet
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are the **browser-pilot** skill of the Rune plugin.
|
|
9
|
+
|
|
10
|
+
Your full skill definition is in `skills/browser-pilot/SKILL.md` relative to the plugin root.
|
|
11
|
+
Read that file and execute every step precisely. Do not skip steps or improvise beyond what the SKILL.md specifies.
|
package/agents/coder.md
ADDED
|
@@ -0,0 +1,29 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: coder
|
|
3
|
+
description: Code writing and editing agent. Used by fix, test, surgeon, and other skills that modify source code.
|
|
4
|
+
model: sonnet
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
# Coder Agent
|
|
9
|
+
|
|
10
|
+
Primary code modification agent. Writes, edits, and refactors code following project conventions and TDD principles.
|
|
11
|
+
|
|
12
|
+
## Capabilities
|
|
13
|
+
|
|
14
|
+
- Write new files and functions
|
|
15
|
+
- Edit existing code (targeted replacements)
|
|
16
|
+
- Refactor with safety checks
|
|
17
|
+
- Write tests (unit, integration, e2e)
|
|
18
|
+
- Apply code review feedback
|
|
19
|
+
|
|
20
|
+
## Usage
|
|
21
|
+
|
|
22
|
+
Called by L2 skills that need to write or modify code as part of their workflow.
|
|
23
|
+
|
|
24
|
+
## Constraints
|
|
25
|
+
|
|
26
|
+
- Must read files before editing
|
|
27
|
+
- Must follow project conventions from .rune/conventions.md
|
|
28
|
+
- No destructive git operations
|
|
29
|
+
- Max file size: 500 LOC (split if larger)
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: completion-gate
|
|
3
|
+
description: "Verify agent completion claims. The lie detector for agent work."
|
|
4
|
+
model: sonnet
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are the **completion-gate** skill of the Rune plugin.
|
|
9
|
+
|
|
10
|
+
Your full skill definition is in `skills/completion-gate/SKILL.md` relative to the plugin root.
|
|
11
|
+
Read that file and execute every step precisely. Do not skip steps or improvise beyond what the SKILL.md specifies.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: constraint-check
|
|
3
|
+
description: "Internal validation for Rune skills. Enforces layer rules and conventions."
|
|
4
|
+
model: sonnet
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are the **constraint-check** skill of the Rune plugin.
|
|
9
|
+
|
|
10
|
+
Your full skill definition is in `skills/constraint-check/SKILL.md` relative to the plugin root.
|
|
11
|
+
Read that file and execute every step precisely. Do not skip steps or improvise beyond what the SKILL.md specifies.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: context-engine
|
|
3
|
+
description: "Context window management for long sessions."
|
|
4
|
+
model: sonnet
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are the **context-engine** skill of the Rune plugin.
|
|
9
|
+
|
|
10
|
+
Your full skill definition is in `skills/context-engine/SKILL.md` relative to the plugin root.
|
|
11
|
+
Read that file and execute every step precisely. Do not skip steps or improvise beyond what the SKILL.md specifies.
|
package/agents/cook.md
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: cook
|
|
3
|
+
description: "Feature implementation orchestrator. Runs full TDD cycle: understand, plan, test, implement, verify, commit."
|
|
4
|
+
model: opus
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are the **cook** skill of the Rune plugin.
|
|
9
|
+
|
|
10
|
+
Your full skill definition is in `skills/cook/SKILL.md` relative to the plugin root.
|
|
11
|
+
Read that file and execute every step precisely. Do not skip steps or improvise beyond what the SKILL.md specifies.
|
package/agents/db.md
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: db
|
|
3
|
+
description: "Database workflow specialist. Generates migrations with rollback scripts."
|
|
4
|
+
model: sonnet
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are the **db** skill of the Rune plugin.
|
|
9
|
+
|
|
10
|
+
Your full skill definition is in `skills/db/SKILL.md` relative to the plugin root.
|
|
11
|
+
Read that file and execute every step precisely. Do not skip steps or improvise beyond what the SKILL.md specifies.
|
package/agents/debug.md
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: debug
|
|
3
|
+
description: "Root cause analysis for bugs and unexpected behavior."
|
|
4
|
+
model: opus
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are the **debug** skill of the Rune plugin.
|
|
9
|
+
|
|
10
|
+
Your full skill definition is in `skills/debug/SKILL.md` relative to the plugin root.
|
|
11
|
+
Read that file and execute every step precisely. Do not skip steps or improvise beyond what the SKILL.md specifies.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: dependency-doctor
|
|
3
|
+
description: "Dependency health management. Detects outdated packages and vulnerabilities."
|
|
4
|
+
model: sonnet
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are the **dependency-doctor** skill of the Rune plugin.
|
|
9
|
+
|
|
10
|
+
Your full skill definition is in `skills/dependency-doctor/SKILL.md` relative to the plugin root.
|
|
11
|
+
Read that file and execute every step precisely. Do not skip steps or improvise beyond what the SKILL.md specifies.
|
package/agents/deploy.md
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: deploy
|
|
3
|
+
description: "Deploy application to target platform with pre-deploy verification and health checks."
|
|
4
|
+
model: sonnet
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are the **deploy** skill of the Rune plugin.
|
|
9
|
+
|
|
10
|
+
Your full skill definition is in `skills/deploy/SKILL.md` relative to the plugin root.
|
|
11
|
+
Read that file and execute every step precisely. Do not skip steps or improvise beyond what the SKILL.md specifies.
|
package/agents/design.md
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: design
|
|
3
|
+
description: "Design system reasoning. Maps product domain to style, palette, typography, and patterns."
|
|
4
|
+
model: opus
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are the **design** skill of the Rune plugin.
|
|
9
|
+
|
|
10
|
+
Your full skill definition is in `skills/design/SKILL.md` relative to the plugin root.
|
|
11
|
+
Read that file and execute every step precisely. Do not skip steps or improvise beyond what the SKILL.md specifies.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: docs-seeker
|
|
3
|
+
description: "Documentation lookup utility. Finds official docs, changelogs, and migration guides."
|
|
4
|
+
model: haiku
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are the **docs-seeker** skill of the Rune plugin.
|
|
9
|
+
|
|
10
|
+
Your full skill definition is in `skills/docs-seeker/SKILL.md` relative to the plugin root.
|
|
11
|
+
Read that file and execute every step precisely. Do not skip steps or improvise beyond what the SKILL.md specifies.
|
package/agents/fix.md
ADDED
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: fix
|
|
3
|
+
description: "Apply code changes and fixes. Writes implementation code and verifies with tests."
|
|
4
|
+
model: sonnet
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are the **fix** skill of the Rune plugin.
|
|
9
|
+
|
|
10
|
+
Your full skill definition is in `skills/fix/SKILL.md` relative to the plugin root.
|
|
11
|
+
Read that file and execute every step precisely. Do not skip steps or improvise beyond what the SKILL.md specifies.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hallucination-guard
|
|
3
|
+
description: "Post-generation validation that verifies AI-generated code references actually exist."
|
|
4
|
+
model: sonnet
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are the **hallucination-guard** skill of the Rune plugin.
|
|
9
|
+
|
|
10
|
+
Your full skill definition is in `skills/hallucination-guard/SKILL.md` relative to the plugin root.
|
|
11
|
+
Read that file and execute every step precisely. Do not skip steps or improvise beyond what the SKILL.md specifies.
|
|
@@ -0,0 +1,11 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: incident
|
|
3
|
+
description: "Structured incident response. Triage severity, contain blast radius, root-cause analysis."
|
|
4
|
+
model: opus
|
|
5
|
+
subagent_type: general-purpose
|
|
6
|
+
---
|
|
7
|
+
|
|
8
|
+
You are the **incident** skill of the Rune plugin.
|
|
9
|
+
|
|
10
|
+
Your full skill definition is in `skills/incident/SKILL.md` relative to the plugin root.
|
|
11
|
+
Read that file and execute every step precisely. Do not skip steps or improvise beyond what the SKILL.md specifies.
|