@rune-kit/rune 2.10.0 → 2.11.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Rune 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.
+MIT License
+
+Copyright (c) 2026 Rune 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

@@ -83,14 +83,16 @@ _Methodology: Claude Code CLI headless mode (`claude -p --output-format json`),
 
 ---
 
-## What's New (v2.10.0)
+## What's New (v2.11.0)
 
-- **graft skill** (NEW L2) — port features from external repos with 5-dimension challenge gate (License, Stack Fit, Scope, Quality, Maintenance)
-- **plan v1.4.0** — Feature Map system: auto-maintained `.rune/features.md` for cross-feature awareness and gap detection
-- **Mesh Signals v2** — 23 active signals, 14 mesh gaps fixed, signal dispatch ordering documented
-- **62 skills, 215+ connections** across 5 layers
+- **Mesh integrity** — 8 dead wires fixed, 5 workflow gaps closed (hotfix chain, API versioning, monorepo mode, feature flags, dependency upgrade campaigns)
+- **audit v0.4.0** — DX Review Mode: Addy Osmani's 8 developer experience principles with scoring rubric and browser-pilot integration
+- **cook v2.4.0** — remediation cycle counter + upstream inconsistency protocol
+- **problem-solver v0.4.0** — Cynefin, SWOT, PESTLE, Porter's Five Forces, ethics framework
+- **plan v1.5.0** — autopilot suggested_next: autonomous execution path for Pro users after plan approval
+- **Autopilot routing** — skill-router Tier 1 entry for Pro autopilot ("auto", "làm hết", "đi ngủ" → autonomous mode)
 
-### Previous (v2.9.0)
+### Previous (v2.10.0)
 
 - **marketing v0.4.0** — anti-AI copy rules (banned phrases, 5 hook types, specificity mandate), expanded SEO audit with schema markup guide (10 types + `@graph` pattern), programmatic SEO awareness (4 playbooks), optional Pro content-scorer/cro-analyst integration
 - **Pro growth pack v1.1.0** — 3 new skills (content-scorer, cro-analyst, marketing-psych) + 6 existing skills enriched with SEO Machine patterns

package/commands/rune.md

@@ -1,168 +1,168 @@
----
-description: "Rune skill ecosystem — interconnected workflows for the full project lifecycle. Use /rune <action> to invoke skills."
-disable-model-invocation: true
----
-
-# Rune — Less skills. Deeper connections.
-
-Route to the appropriate Rune skill based on the action:
-
-## Available Commands
-
-### Orchestrators (L1)
-- `/rune cook <task>` — Invoke the rune:cook skill for feature implementation
-- `/rune team <task>` — Invoke the rune:team skill for parallel multi-agent work
-- `/rune launch` — Invoke the rune:launch skill for deploy + marketing
-- `/rune rescue` — Invoke the rune:rescue skill for legacy refactoring
-
-### Workflow (L2) — Creation
-- `/rune plan <task>` — Invoke the rune:plan skill to create implementation plan
-- `/rune scout` — Invoke the rune:scout skill to scan codebase
-- `/rune brainstorm <topic>` — Invoke the rune:brainstorm skill for creative ideation
-
-### Workflow (L2) — Development
-- `/rune debug <issue>` — Invoke the rune:debug skill for root cause analysis
-- `/rune fix <issue>` — Invoke the rune:fix skill to apply code changes
-- `/rune test` — Invoke the rune:test skill to write and run tests
-- `/rune review` — Invoke the rune:review skill for code quality review
-
-### Workflow (L2) — Quality
-- `/rune sentinel` — Invoke the rune:sentinel skill for security scanning
-- `/rune preflight` — Invoke the rune:preflight skill for pre-commit quality gate
-- `/rune onboard` — Invoke the rune:onboard skill to generate project context
-- `/rune logic-guardian` — Invoke the rune:logic-guardian skill to protect business logic from accidental deletion
-
-### Workflow (L2) — Delivery
-- `/rune deploy` — Invoke the rune:deploy skill for deployment management
-- `/rune marketing` — Invoke the rune:marketing skill for launch asset creation
-
-### Workflow (L2) — Rescue
-- `/rune autopsy` — Invoke the rune:autopsy skill for codebase health assessment
-- `/rune safeguard` — Invoke the rune:safeguard skill to build safety nets for legacy code
-- `/rune surgeon` — Invoke the rune:surgeon skill for incremental refactoring
-
-### Utilities (L3) — Knowledge
-- `/rune research <topic>` — Invoke the rune:research skill for web research
-- `/rune docs-seeker <query>` — Invoke the rune:docs-seeker skill for documentation lookup
-- `/rune trend-scout <topic>` — Invoke the rune:trend-scout skill for market intelligence
-
-### Utilities (L3) — Reasoning
-- `/rune problem-solver <problem>` — Invoke the rune:problem-solver skill for structured reasoning
-- `/rune sequential-thinking <problem>` — Invoke the rune:sequential-thinking skill for multi-variable analysis
-
-### Utilities (L3) — Validation
-- `/rune verification` — Invoke the rune:verification skill to run lint, type-check, tests, build
-- `/rune hallucination-guard` — Invoke the rune:hallucination-guard skill to verify imports and APIs
-
-### Utilities (L3) — State
-- `/rune context-engine` — Invoke the rune:context-engine skill for context window management
-- `/rune journal` — Invoke the rune:journal skill for rescue state tracking
-- `/rune session-bridge` — Invoke the rune:session-bridge skill for cross-session persistence
-
-### Utilities (L3) — Monitoring
-- `/rune watchdog` — Invoke the rune:watchdog skill for post-deploy monitoring
-- `/rune scope-guard` — Invoke the rune:scope-guard skill for scope creep detection
-
-### Utilities (L3) — Media
-- `/rune browser-pilot <url>` — Invoke the rune:browser-pilot skill for Playwright automation
-- `/rune asset-creator <brief>` — Invoke the rune:asset-creator skill for visual asset generation
-- `/rune video-creator <brief>` — Invoke the rune:video-creator skill for video content planning
-
-### Utilities (L3) — Deps
-- `/rune dependency-doctor` — Invoke the rune:dependency-doctor skill for dependency management
-
-### Intelligence (H3)
-- `/rune metrics` — Show mesh analytics from .rune/metrics/ (runs audit Phase 8 only)
-- `/rune pack list` — List installed L4 packs (core + community)
-- `/rune pack install <git-url>` — Install a community L4 pack from Git
-- `/rune pack remove <name>` — Remove a community L4 pack
-- `/rune pack create <name>` — Scaffold a new L4 pack using skill-forge
-
-### Extension Packs (L4)
-
-L4 packs provide domain-specific patterns. When invoked, read the pack's PACK.md and follow the matching skill's workflow steps.
-
-#### Frontend & UI (`extensions/ui/PACK.md`)
-- `/rune design-system` — Design token generation and enforcement
-- `/rune component-patterns` — Component architecture refactoring
-- `/rune a11y-audit` — Accessibility audit (WCAG compliance)
-- `/rune animation-patterns` — Motion design and animation patterns
-
-#### Backend (`extensions/backend/PACK.md`)
-- `/rune api-patterns` — REST/GraphQL API design and validation
-- `/rune auth-patterns` — Authentication and authorization flows
-- `/rune database-patterns` — Schema design, migrations, query optimization
-- `/rune middleware-patterns` — Middleware pipeline and error handling
-
-#### DevOps (`extensions/devops/PACK.md`)
-- `/rune docker` — Dockerfile optimization, multi-stage builds, compose
-- `/rune ci-cd` — CI/CD pipeline setup (GitHub Actions, GitLab CI)
-- `/rune monitoring` — Observability, logging, alerting setup
-- `/rune server-setup` — VPS/cloud server provisioning
-- `/rune ssl-domain` — SSL certificates and domain configuration
-
-#### Mobile (`extensions/mobile/PACK.md`)
-- `/rune react-native` — React Native / Expo architecture and performance
-- `/rune flutter` — Flutter state management and widget patterns
-- `/rune app-store-prep` — App Store / Play Store submission preparation
-- `/rune native-bridge` — Native module bridges (Turbo Modules, MethodChannel)
-
-#### Security (`extensions/security/PACK.md`)
-- `/rune owasp-audit` — OWASP Top 10 vulnerability audit
-- `/rune pentest-patterns` — Penetration testing methodology
-- `/rune secret-mgmt` — Secret management and rotation
-- `/rune compliance` — Compliance framework guidance (SOC2, HIPAA, PCI)
-
-#### Trading & Finance (`extensions/trading/PACK.md`)
-- `/rune fintech-patterns` — Financial data validation, decimal arithmetic
-- `/rune realtime-data` — WebSocket market data, order book management
-- `/rune chart-components` — Trading chart integration (TradingView, Lightweight Charts)
-- `/rune indicator-library` — Technical indicators (SMA, EMA, RSI, MACD)
-- `/rune trade-logic` — Trading logic preservation, strategy specs, backtest linkage
-
-#### SaaS (`extensions/saas/PACK.md`)
-- `/rune multi-tenant` — Multi-tenancy architecture patterns
-- `/rune billing-integration` — Stripe/Paddle billing integration
-- `/rune subscription-flow` — Subscription lifecycle management
-- `/rune onboarding-flow` — User onboarding flow design
-
-#### E-commerce (`extensions/ecommerce/PACK.md`)
-- `/rune shopify-dev` — Shopify theme/app development (Hydrogen, Liquid)
-- `/rune payment-integration` — Payment flow (Stripe Payment Intents, 3DS)
-- `/rune cart-system` — Shopping cart architecture
-- `/rune inventory-mgmt` — Stock tracking with optimistic locking
-
-#### AI/ML (`extensions/ai-ml/PACK.md`)
-- `/rune llm-integration` — LLM API clients with retry and structured output
-- `/rune rag-patterns` — RAG pipeline (chunking, embedding, retrieval, reranking)
-- `/rune embedding-search` — Hybrid search (BM25 + vector)
-- `/rune fine-tuning-guide` — Fine-tuning dataset prep, training, evaluation
-
-#### Game Development (`extensions/gamedev/PACK.md`)
-- `/rune threejs-patterns` — Three.js / React Three Fiber scene optimization
-- `/rune webgl` — WebGL shader programming and buffer management
-- `/rune game-loops` — Fixed timestep game loop with interpolation
-- `/rune physics-engine` — Rapier.js physics integration
-- `/rune asset-pipeline` — Game asset loading, compression, preloading
-
-#### Content (`extensions/content/PACK.md`)
-- `/rune blog-patterns` — Blog system (pagination, RSS, reading time)
-- `/rune cms-integration` — Headless CMS setup (Sanity, Contentful, Strapi)
-- `/rune mdx-authoring` — MDX pipeline with custom components
-- `/rune i18n` — Internationalization (locale routing, translations)
-- `/rune seo-patterns` — SEO audit (JSON-LD, sitemap, meta tags, OG)
-
-#### Analytics (`extensions/analytics/PACK.md`)
-- `/rune tracking-setup` — Analytics tracking with consent management
-- `/rune ab-testing` — A/B experiment design and statistical significance
-- `/rune funnel-analysis` — Conversion funnel tracking and drop-off analysis
-- `/rune dashboard-patterns` — KPI dashboards with server-side aggregation
-
-### Quick Actions
-- `/rune status` — Show current project state from .rune/ files
-
-## Usage
-
-When the user runs `/rune <action>`, invoke the corresponding `rune:<action>` skill.
-For L4 pack commands, read the specified PACK.md file and follow the matching skill's workflow.
-If no action is provided, show this help menu.
+---
+description: "Rune skill ecosystem — interconnected workflows for the full project lifecycle. Use /rune <action> to invoke skills."
+disable-model-invocation: true
+---
+
+# Rune — Less skills. Deeper connections.
+
+Route to the appropriate Rune skill based on the action:
+
+## Available Commands
+
+### Orchestrators (L1)
+- `/rune cook <task>` — Invoke the rune:cook skill for feature implementation
+- `/rune team <task>` — Invoke the rune:team skill for parallel multi-agent work
+- `/rune launch` — Invoke the rune:launch skill for deploy + marketing
+- `/rune rescue` — Invoke the rune:rescue skill for legacy refactoring
+
+### Workflow (L2) — Creation
+- `/rune plan <task>` — Invoke the rune:plan skill to create implementation plan
+- `/rune scout` — Invoke the rune:scout skill to scan codebase
+- `/rune brainstorm <topic>` — Invoke the rune:brainstorm skill for creative ideation
+
+### Workflow (L2) — Development
+- `/rune debug <issue>` — Invoke the rune:debug skill for root cause analysis
+- `/rune fix <issue>` — Invoke the rune:fix skill to apply code changes
+- `/rune test` — Invoke the rune:test skill to write and run tests
+- `/rune review` — Invoke the rune:review skill for code quality review
+
+### Workflow (L2) — Quality
+- `/rune sentinel` — Invoke the rune:sentinel skill for security scanning
+- `/rune preflight` — Invoke the rune:preflight skill for pre-commit quality gate
+- `/rune onboard` — Invoke the rune:onboard skill to generate project context
+- `/rune logic-guardian` — Invoke the rune:logic-guardian skill to protect business logic from accidental deletion
+
+### Workflow (L2) — Delivery
+- `/rune deploy` — Invoke the rune:deploy skill for deployment management
+- `/rune marketing` — Invoke the rune:marketing skill for launch asset creation
+
+### Workflow (L2) — Rescue
+- `/rune autopsy` — Invoke the rune:autopsy skill for codebase health assessment
+- `/rune safeguard` — Invoke the rune:safeguard skill to build safety nets for legacy code
+- `/rune surgeon` — Invoke the rune:surgeon skill for incremental refactoring
+
+### Utilities (L3) — Knowledge
+- `/rune research <topic>` — Invoke the rune:research skill for web research
+- `/rune docs-seeker <query>` — Invoke the rune:docs-seeker skill for documentation lookup
+- `/rune trend-scout <topic>` — Invoke the rune:trend-scout skill for market intelligence
+
+### Utilities (L3) — Reasoning
+- `/rune problem-solver <problem>` — Invoke the rune:problem-solver skill for structured reasoning
+- `/rune sequential-thinking <problem>` — Invoke the rune:sequential-thinking skill for multi-variable analysis
+
+### Utilities (L3) — Validation
+- `/rune verification` — Invoke the rune:verification skill to run lint, type-check, tests, build
+- `/rune hallucination-guard` — Invoke the rune:hallucination-guard skill to verify imports and APIs
+
+### Utilities (L3) — State
+- `/rune context-engine` — Invoke the rune:context-engine skill for context window management
+- `/rune journal` — Invoke the rune:journal skill for rescue state tracking
+- `/rune session-bridge` — Invoke the rune:session-bridge skill for cross-session persistence
+
+### Utilities (L3) — Monitoring
+- `/rune watchdog` — Invoke the rune:watchdog skill for post-deploy monitoring
+- `/rune scope-guard` — Invoke the rune:scope-guard skill for scope creep detection
+
+### Utilities (L3) — Media
+- `/rune browser-pilot <url>` — Invoke the rune:browser-pilot skill for Playwright automation
+- `/rune asset-creator <brief>` — Invoke the rune:asset-creator skill for visual asset generation
+- `/rune video-creator <brief>` — Invoke the rune:video-creator skill for video content planning
+
+### Utilities (L3) — Deps
+- `/rune dependency-doctor` — Invoke the rune:dependency-doctor skill for dependency management
+
+### Intelligence (H3)
+- `/rune metrics` — Show mesh analytics from .rune/metrics/ (runs audit Phase 8 only)
+- `/rune pack list` — List installed L4 packs (core + community)
+- `/rune pack install <git-url>` — Install a community L4 pack from Git
+- `/rune pack remove <name>` — Remove a community L4 pack
+- `/rune pack create <name>` — Scaffold a new L4 pack using skill-forge
+
+### Extension Packs (L4)
+
+L4 packs provide domain-specific patterns. When invoked, read the pack's PACK.md and follow the matching skill's workflow steps.
+
+#### Frontend & UI (`extensions/ui/PACK.md`)
+- `/rune design-system` — Design token generation and enforcement
+- `/rune component-patterns` — Component architecture refactoring
+- `/rune a11y-audit` — Accessibility audit (WCAG compliance)
+- `/rune animation-patterns` — Motion design and animation patterns
+
+#### Backend (`extensions/backend/PACK.md`)
+- `/rune api-patterns` — REST/GraphQL API design and validation
+- `/rune auth-patterns` — Authentication and authorization flows
+- `/rune database-patterns` — Schema design, migrations, query optimization
+- `/rune middleware-patterns` — Middleware pipeline and error handling
+
+#### DevOps (`extensions/devops/PACK.md`)
+- `/rune docker` — Dockerfile optimization, multi-stage builds, compose
+- `/rune ci-cd` — CI/CD pipeline setup (GitHub Actions, GitLab CI)
+- `/rune monitoring` — Observability, logging, alerting setup
+- `/rune server-setup` — VPS/cloud server provisioning
+- `/rune ssl-domain` — SSL certificates and domain configuration
+
+#### Mobile (`extensions/mobile/PACK.md`)
+- `/rune react-native` — React Native / Expo architecture and performance
+- `/rune flutter` — Flutter state management and widget patterns
+- `/rune app-store-prep` — App Store / Play Store submission preparation
+- `/rune native-bridge` — Native module bridges (Turbo Modules, MethodChannel)
+
+#### Security (`extensions/security/PACK.md`)
+- `/rune owasp-audit` — OWASP Top 10 vulnerability audit
+- `/rune pentest-patterns` — Penetration testing methodology
+- `/rune secret-mgmt` — Secret management and rotation
+- `/rune compliance` — Compliance framework guidance (SOC2, HIPAA, PCI)
+
+#### Trading & Finance (`extensions/trading/PACK.md`)
+- `/rune fintech-patterns` — Financial data validation, decimal arithmetic
+- `/rune realtime-data` — WebSocket market data, order book management
+- `/rune chart-components` — Trading chart integration (TradingView, Lightweight Charts)
+- `/rune indicator-library` — Technical indicators (SMA, EMA, RSI, MACD)
+- `/rune trade-logic` — Trading logic preservation, strategy specs, backtest linkage
+
+#### SaaS (`extensions/saas/PACK.md`)
+- `/rune multi-tenant` — Multi-tenancy architecture patterns
+- `/rune billing-integration` — Stripe/Paddle billing integration
+- `/rune subscription-flow` — Subscription lifecycle management
+- `/rune onboarding-flow` — User onboarding flow design
+
+#### E-commerce (`extensions/ecommerce/PACK.md`)
+- `/rune shopify-dev` — Shopify theme/app development (Hydrogen, Liquid)
+- `/rune payment-integration` — Payment flow (Stripe Payment Intents, 3DS)
+- `/rune cart-system` — Shopping cart architecture
+- `/rune inventory-mgmt` — Stock tracking with optimistic locking
+
+#### AI/ML (`extensions/ai-ml/PACK.md`)
+- `/rune llm-integration` — LLM API clients with retry and structured output
+- `/rune rag-patterns` — RAG pipeline (chunking, embedding, retrieval, reranking)
+- `/rune embedding-search` — Hybrid search (BM25 + vector)
+- `/rune fine-tuning-guide` — Fine-tuning dataset prep, training, evaluation
+
+#### Game Development (`extensions/gamedev/PACK.md`)
+- `/rune threejs-patterns` — Three.js / React Three Fiber scene optimization
+- `/rune webgl` — WebGL shader programming and buffer management
+- `/rune game-loops` — Fixed timestep game loop with interpolation
+- `/rune physics-engine` — Rapier.js physics integration
+- `/rune asset-pipeline` — Game asset loading, compression, preloading
+
+#### Content (`extensions/content/PACK.md`)
+- `/rune blog-patterns` — Blog system (pagination, RSS, reading time)
+- `/rune cms-integration` — Headless CMS setup (Sanity, Contentful, Strapi)
+- `/rune mdx-authoring` — MDX pipeline with custom components
+- `/rune i18n` — Internationalization (locale routing, translations)
+- `/rune seo-patterns` — SEO audit (JSON-LD, sitemap, meta tags, OG)
+
+#### Analytics (`extensions/analytics/PACK.md`)
+- `/rune tracking-setup` — Analytics tracking with consent management
+- `/rune ab-testing` — A/B experiment design and statistical significance
+- `/rune funnel-analysis` — Conversion funnel tracking and drop-off analysis
+- `/rune dashboard-patterns` — KPI dashboards with server-side aggregation
+
+### Quick Actions
+- `/rune status` — Show current project state from .rune/ files
+
+## Usage
+
+When the user runs `/rune <action>`, invoke the corresponding `rune:<action>` skill.
+For L4 pack commands, read the specified PACK.md file and follow the matching skill's workflow.
+If no action is provided, show this help menu.

package/contexts/dev.md

@@ -1,34 +1,34 @@
-# Development Mode
-
-Behavioral context for active coding sessions. Prioritize action over analysis.
-
-## Principles
-
-- **Code first, explain after** — show working code, not paragraphs about what you'll do
-- **Working → Right → Clean** — get it running, make it correct, then refine
-- **Bias toward action** — if the path is 80% clear, start coding rather than analyzing further
-
-## Tool Priority
-
-```
-HIGH:    Edit, Write, Bash (run tests/build)
-MEDIUM:  Read (targeted files), Grep (specific patterns)
-LOW:     Glob (broad search), WebSearch (external docs)
-```
-
-## Behavioral Rules
-
-1. Read the file BEFORE editing — never guess at existing code
-2. Run tests after every meaningful change
-3. If stuck for >2 iterations on the same error, switch strategy:
-   - Try a different approach rather than debugging deeper
-   - Use `rune:debug` for structured root cause analysis
-4. Keep explanations to 1-2 sentences between code blocks
-5. Commit working increments — don't batch everything into one giant change
-
-## Anti-Patterns
-
-- Lengthy analysis before writing a single line of code
-- Reading 10+ files "for context" when 2-3 would suffice
-- Explaining what you're about to do instead of doing it
-- Over-engineering the first pass (violates Working → Right → Clean)
+# Development Mode
+
+Behavioral context for active coding sessions. Prioritize action over analysis.
+
+## Principles
+
+- **Code first, explain after** — show working code, not paragraphs about what you'll do
+- **Working → Right → Clean** — get it running, make it correct, then refine
+- **Bias toward action** — if the path is 80% clear, start coding rather than analyzing further
+
+## Tool Priority
+
+```
+HIGH:    Edit, Write, Bash (run tests/build)
+MEDIUM:  Read (targeted files), Grep (specific patterns)
+LOW:     Glob (broad search), WebSearch (external docs)
+```
+
+## Behavioral Rules
+
+1. Read the file BEFORE editing — never guess at existing code
+2. Run tests after every meaningful change
+3. If stuck for >2 iterations on the same error, switch strategy:
+   - Try a different approach rather than debugging deeper
+   - Use `rune:debug` for structured root cause analysis
+4. Keep explanations to 1-2 sentences between code blocks
+5. Commit working increments — don't batch everything into one giant change
+
+## Anti-Patterns
+
+- Lengthy analysis before writing a single line of code
+- Reading 10+ files "for context" when 2-3 would suffice
+- Explaining what you're about to do instead of doing it
+- Over-engineering the first pass (violates Working → Right → Clean)

package/contexts/research.md

@@ -1,43 +1,43 @@
-# Research Mode
-
-Behavioral context for investigation, exploration, and understanding. Prioritize breadth and accuracy over speed.
-
-## Principles
-
-- **Read widely before concluding** — check 3+ sources before forming an opinion
-- **Map before moving** — understand the full landscape before recommending a path
-- **Evidence over intuition** — every claim should reference a file, doc, or search result
-
-## Tool Priority
-
-```
-HIGH:    Grep, Glob, Read, WebSearch, WebFetch
-MEDIUM:  Bash (non-destructive: git log, dependency checks)
-LOW:     Edit, Write (only for saving findings)
-```
-
-## Investigation Framework
-
-1. **Define the question** — what exactly are we trying to learn?
-2. **Internal scan** — search the codebase first (Grep, Glob, Read)
-3. **External lookup** — check docs, changelogs, GitHub issues (WebSearch, WebFetch)
-4. **Cross-reference** — validate findings against 2+ sources
-5. **Synthesize** — present findings with confidence levels:
-   - **Confirmed**: found in code/docs, verified
-   - **Likely**: strong evidence but not 100% confirmed
-   - **Uncertain**: limited evidence, needs more investigation
-
-## Behavioral Rules
-
-1. Never modify code in research mode — read-only exploration
-2. Present findings in structured format (tables, bullet points)
-3. Include file paths and line numbers for all code references
-4. Flag contradictions between sources rather than picking one silently
-5. Estimate scope/effort when the research is for planning purposes
-
-## Anti-Patterns
-
-- Jumping to a solution after reading one file
-- Modifying code "while we're here" during research
-- Presenting opinions as facts without evidence trail
-- Stopping research early because the first answer looks plausible
+# Research Mode
+
+Behavioral context for investigation, exploration, and understanding. Prioritize breadth and accuracy over speed.
+
+## Principles
+
+- **Read widely before concluding** — check 3+ sources before forming an opinion
+- **Map before moving** — understand the full landscape before recommending a path
+- **Evidence over intuition** — every claim should reference a file, doc, or search result
+
+## Tool Priority
+
+```
+HIGH:    Grep, Glob, Read, WebSearch, WebFetch
+MEDIUM:  Bash (non-destructive: git log, dependency checks)
+LOW:     Edit, Write (only for saving findings)
+```
+
+## Investigation Framework
+
+1. **Define the question** — what exactly are we trying to learn?
+2. **Internal scan** — search the codebase first (Grep, Glob, Read)
+3. **External lookup** — check docs, changelogs, GitHub issues (WebSearch, WebFetch)
+4. **Cross-reference** — validate findings against 2+ sources
+5. **Synthesize** — present findings with confidence levels:
+   - **Confirmed**: found in code/docs, verified
+   - **Likely**: strong evidence but not 100% confirmed
+   - **Uncertain**: limited evidence, needs more investigation
+
+## Behavioral Rules
+
+1. Never modify code in research mode — read-only exploration
+2. Present findings in structured format (tables, bullet points)
+3. Include file paths and line numbers for all code references
+4. Flag contradictions between sources rather than picking one silently
+5. Estimate scope/effort when the research is for planning purposes
+
+## Anti-Patterns
+
+- Jumping to a solution after reading one file
+- Modifying code "while we're here" during research
+- Presenting opinions as facts without evidence trail
+- Stopping research early because the first answer looks plausible