superkit-mcp-server 1.0.2 → 1.1.0

package/skills/tech/intelligent-routing/SKILL.md

@@ -233,10 +233,10 @@ User: "Add mobile support to the web app"
 - If task is unclear, still ask questions first
 - Then route to appropriate agent
 
-### With GEMINI.md Rules
+### With main AGENT.md (GEMINI.md, CLAUDE.md) Rules
 
-- **Priority**: GEMINI.md rules > intelligent-routing
-- If GEMINI.md specifies explicit routing, follow it
+- **Priority**: main AGENT.md (GEMINI.md, CLAUDE.md) rules > intelligent-routing
+- If main AGENT.md (GEMINI.md, CLAUDE.md) specifies explicit routing, follow it
 - Intelligent routing is the DEFAULT when no explicit rule exists
 
 ## Testing the System
@@ -305,7 +305,7 @@ still mention agents explicitly with `@agent-name` if you prefer.
 
 ### Enable Debug Mode (for development)
 
-Add to GEMINI.md temporarily:
+Add to main AGENT.md (GEMINI.md, CLAUDE.md) temporarily:
 
 ```markdown
 ## DEBUG: Intelligent Routing
@@ -332,4 +332,4 @@ Show selection reasoning:
 
 ---
 
-**Next Steps**: Integrate this skill into GEMINI.md TIER 0 rules.
+**Next Steps**: Integrate this skill into main AGENT.md (GEMINI.md, CLAUDE.md) TIER 0 rules.

package/workflows/README.md

@@ -1,191 +1,191 @@
-# Compound Engineering Workflows
-
-> **Quick Start:** New to this project? Read [critical-patterns.md](../docs/solutions/patterns/critical-patterns.md) first.
-> **Technical Architecture:** For the complete system architecture, see [docs/architecture/compound-system.md](../docs/architecture/compound-system.md).
-
-## Purpose
-
-This directory contains workflow definitions that orchestrate the agent's compound engineering process. Workflows provide structured, repeatable sequences for planning, implementing, reviewing, and documenting work.
-
-## Components
-
-| Category | Workflows | Description |
-|----------|-----------|-------------|
-| Core Loop | 8 | `/explore`, `/specs`, `/plan`, `/plan_review`, `/work`, `/review`, `/compound`, `/housekeeping` |
-| Todo/Triage | 2 | `/triage`, `/resolve_todo` |
-| Code Review | 2 | `/resolve_pr`, `/plan_review` |
-| Release | 3 | `/changelog`, `/release-docs`, `/deploy-docs` |
-| Debugging | 2 | `/report-bug`, `/reproduce-bug` |
-| Skills | 3 | `/create-agent-skill`, `/heal-skill`, `/generate_command` |
-| Maintenance | 2 | `/housekeeping`, `/compound_health` |
-
-## Component Details
-
-### 🔴 Critical Workflows
-
-| Workflow | Purpose | When to Use |
-|----------|---------|-------------|
-| `plan.md` | Create implementation plans | Before significant work |
-| `work.md` | Execute plans systematically | During implementation |
-| `review-compound.md` | Multi-pass code review | After work complete |
-| `compound.md` | Capture knowledge for reuse | After solving problems |
-
-### 🟡 Supporting Workflows
-
-| Workflow | Purpose |
-|----------|---------|
-| `explore.md` | Deep investigation before planning |
-| `specs.md` | Multi-session specifications |
-| `housekeeping.md` | Pre-push cleanup and validation |
-| `triage.md` | Prioritize pending work items |
-
-## Core Loop
-
-```
-/explore (optional) → /specs (large) → /plan (per phase) → /work → /review → /compound → /housekeeping → repeat
-```
-
-| Command | When | Purpose |
-|---------|------|---------|
-| `/explore` | Before planning | Deep investigation, best practices, multi-order analysis |
-| `/specs` | Before multi-week initiatives | Create structured specification with phases |
-| `/plan` | Before significant work | Research, design, create implementation plan |
-| `/plan_review` | Before executing plan | Review plan quality and completeness |
-| `/work` | During implementation | Execute plan systematically |
-| `/review` | After work complete | Quality check before merge |
-| `/compound` | After solving problems | Capture knowledge for reuse |
-| `/housekeeping` | Before git push | Archive completed work, fix drift |
-
-## Support Commands
-
-### Todos & Triage
-| Command | Purpose |
-|---------|---------|
-| `/triage` | Prioritize pending todo items |
-| `/resolve_todo` | Batch-process ready todos |
-
-### Code Review
-| Command | Purpose |
-|---------|---------|
-| `/resolve_pr` | Address PR feedback systematically |
-| `/plan_review` | Review plan quality before execution |
-
-### Release & Docs
-| Command | Purpose |
-|---------|---------|
-| `/changelog` | Generate changelog from commits |
-| `/release-docs` | Prepare release documentation |
-| `/deploy-docs` | Deploy documentation updates |
-
-### Debugging
-| Command | Purpose |
-|---------|---------|
-| `/report-bug` | Create structured bug report |
-| `/reproduce-bug` | Systematically reproduce a bug |
-
-### Skills & Extensions
-| Command | Purpose |
-|---------|---------|
-| `/create-agent-skill` | Add new modular capabilities |
-| `/heal-skill` | Diagnose and fix broken skills |
-| `/generate_command` | Create new workflow commands |
-
-### Platform-Specific
-| Command | Purpose |
-|---------|---------|
-| `/xcode-test` | Run Xcode tests for iOS |
-
-### Maintenance
-| Command | Purpose |
-|---------|---------|
-| `/housekeeping` | Pre-push cleanup: archive completed work, fix state drift |
-| `/compound_health` | Weekly health check: monitor knowledge base vitals |
-| `check-docs-freshness` | Verify documentation updates for code changes |
-
-### Modular Skills
-| Skill | Purpose | Entry Point |
-|-------|---------|-------------|
-| `session-resume` | Establish session state | `skills/session-resume/SKILL.md` |
-| `compound-docs` | Search/Document solutions | `skills/compound-docs/SKILL.md` |
-| `file-todos` | Manage file-based tasks | `skills/file-todos/SKILL.md` |
-| `code-review` | Systematic quality gates | `skills/code-review/SKILL.md` |
-| `testing` | Unified test patterns | `skills/testing/SKILL.md` |
-| `debug` | Structured root cause analysis | `skills/debug/SKILL.md` |
-
----
-
-## Before You Start Any Work
-
-### 1. Resume Session (STRICTLY REQUIRED)
-
-Always run this first when starting a new conversation:
-```bash
-# Read and follow the checklist
-cat skills/session-resume/SKILL.md
-```
-
-### 2. Search Existing Solutions
-
-```bash
-# Check if this problem was solved before
-grep -r "{keywords}" docs/solutions/
-
-# Check critical patterns
-cat docs/solutions/patterns/critical-patterns.md
-```
-
-### 3. Check Pending Work
-
-```bash
-# Any active specs?
-ls docs/specs/*/README.md 2>/dev/null | grep -v templates
-
-# Any ready todos?
-ls todos/*-ready-*.md 2>/dev/null
-
-# Any in-progress plans?
-ls plans/*.md 2>/dev/null
-```
-
----
-
-## Directory Structure
-
-```
-.agent/workflows/     # You are here - all workflow commands
-docs/solutions/       # Persistent knowledge base
-├── patterns/         # Critical patterns (READ FIRST)
-├── schema.yaml       # Solution validation schema
-└── {categories}/     # Categorized solutions
-docs/explorations/    # Deep investigations & research
-skills/               # Modular capabilities
-plans/                # Implementation plans from /plan
-└── archive/          # Completed plans
-todos/                # Work items from /review, /triage
-└── archive/          # Completed todos
-docs/specs/           # Multi-session specifications
-└── archive/          # Completed specs
-```
-
----
-
-## Key Principles
-
-1. **Search before solving** - Check `docs/solutions/` and `docs/explorations/`
-2. **Document after solving** - Run `/compound` when you fix something
-3. **Follow patterns** - Reference `critical-patterns.md`
-4. **Create todos for deferred work** - Don't just document in artifacts
-5. **Use conventional commits** - Enables changelog automation
-6. **Housekeeping before push** - Run `/housekeeping` to archive completed work
-
----
-
-## Changelog
-
-### 2026-01-24
-- Added Purpose, Components, and Component Details sections
-- Restructured for documentation validation compliance
-
-### 2025-12-20
-- Added modular skills section
-- Updated core loop documentation
+# Compound Engineering Workflows
+
+> **Quick Start:** New to this project? Read [critical-patterns.md](../docs/solutions/patterns/critical-patterns.md) first.
+> **Technical Architecture:** For the complete system architecture, see [docs/architecture/compound-system.md](../docs/architecture/compound-system.md).
+
+## Purpose
+
+This directory contains workflow definitions that orchestrate the agent's compound engineering process. Workflows provide structured, repeatable sequences for planning, implementing, reviewing, and documenting work.
+
+## Components
+
+| Category | Workflows | Description |
+|----------|-----------|-------------|
+| Core Loop | 8 | `/explore`, `/specs`, `/plan`, `/plan_review`, `/work`, `/review`, `/compound`, `/housekeeping` |
+| Todo/Triage | 2 | `/triage`, `/resolve_todo` |
+| Code Review | 2 | `/resolve_pr`, `/plan_review` |
+| Release | 3 | `/changelog`, `/release-docs`, `/deploy-docs` |
+| Debugging | 2 | `/report-bug`, `/reproduce-bug` |
+| Skills | 3 | `/create-agent-skill`, `/heal-skill`, `/generate_command` |
+| Maintenance | 2 | `/housekeeping`, `/compound_health` |
+
+## Component Details
+
+### 🔴 Critical Workflows
+
+| Workflow | Purpose | When to Use |
+|----------|---------|-------------|
+| `plan.md` | Create implementation plans | Before significant work |
+| `work.md` | Execute plans systematically | During implementation |
+| `review-compound.md` | Multi-pass code review | After work complete |
+| `compound.md` | Capture knowledge for reuse | After solving problems |
+
+### 🟡 Supporting Workflows
+
+| Workflow | Purpose |
+|----------|---------|
+| `explore.md` | Deep investigation before planning |
+| `specs.md` | Multi-session specifications |
+| `housekeeping.md` | Pre-push cleanup and validation |
+| `triage.md` | Prioritize pending work items |
+
+## Core Loop
+
+```
+/explore (optional) → /specs (large) → /plan (per phase) → /work → /review → /compound → /housekeeping → repeat
+```
+
+| Command | When | Purpose |
+|---------|------|---------|
+| `/explore` | Before planning | Deep investigation, best practices, multi-order analysis |
+| `/specs` | Before multi-week initiatives | Create structured specification with phases |
+| `/plan` | Before significant work | Research, design, create implementation plan |
+| `/plan_review` | Before executing plan | Review plan quality and completeness |
+| `/work` | During implementation | Execute plan systematically |
+| `/review` | After work complete | Quality check before merge |
+| `/compound` | After solving problems | Capture knowledge for reuse |
+| `/housekeeping` | Before git push | Archive completed work, fix drift |
+
+## Support Commands
+
+### Todos & Triage
+| Command | Purpose |
+|---------|---------|
+| `/triage` | Prioritize pending todo items |
+| `/resolve_todo` | Batch-process ready todos |
+
+### Code Review
+| Command | Purpose |
+|---------|---------|
+| `/resolve_pr` | Address PR feedback systematically |
+| `/plan_review` | Review plan quality before execution |
+
+### Release & Docs
+| Command | Purpose |
+|---------|---------|
+| `/changelog` | Generate changelog from commits |
+| `/release-docs` | Prepare release documentation |
+| `/deploy-docs` | Deploy documentation updates |
+
+### Debugging
+| Command | Purpose |
+|---------|---------|
+| `/report-bug` | Create structured bug report |
+| `/reproduce-bug` | Systematically reproduce a bug |
+
+### Skills & Extensions
+| Command | Purpose |
+|---------|---------|
+| `/create-agent-skill` | Add new modular capabilities |
+| `/heal-skill` | Diagnose and fix broken skills |
+| `/generate_command` | Create new workflow commands |
+
+### Platform-Specific
+| Command | Purpose |
+|---------|---------|
+| `/xcode-test` | Run Xcode tests for iOS |
+
+### Maintenance
+| Command | Purpose |
+|---------|---------|
+| `/housekeeping` | Pre-push cleanup: archive completed work, fix state drift |
+| `/compound_health` | Weekly health check: monitor knowledge base vitals |
+| `check-docs-freshness` | Verify documentation updates for code changes |
+
+### Modular Skills
+| Skill | Purpose | Entry Point |
+|-------|---------|-------------|
+| `session-resume` | Establish session state | `skills/session-resume/SKILL.md` |
+| `compound-docs` | Search/Document solutions | `skills/compound-docs/SKILL.md` |
+| `file-todos` | Manage file-based tasks | `skills/file-todos/SKILL.md` |
+| `code-review` | Systematic quality gates | `skills/code-review/SKILL.md` |
+| `testing` | Unified test patterns | `skills/testing/SKILL.md` |
+| `debug` | Structured root cause analysis | `skills/debug/SKILL.md` |
+
+---
+
+## Before You Start Any Work
+
+### 1. Resume Session (STRICTLY REQUIRED)
+
+Always run this first when starting a new conversation:
+```bash
+# Read and follow the checklist
+cat skills/session-resume/SKILL.md
+```
+
+### 2. Search Existing Solutions
+
+```bash
+# Check if this problem was solved before
+grep -r "{keywords}" docs/solutions/
+
+# Check critical patterns
+cat docs/solutions/patterns/critical-patterns.md
+```
+
+### 3. Check Pending Work
+
+```bash
+# Any active specs?
+ls docs/specs/*/README.md 2>/dev/null | grep -v templates
+
+# Any ready todos?
+ls todos/*-ready-*.md 2>/dev/null
+
+# Any in-progress plans?
+ls plans/*.md 2>/dev/null
+```
+
+---
+
+## Directory Structure
+
+```
+.agent/workflows/     # You are here - all workflow commands
+docs/solutions/       # Persistent knowledge base
+├── patterns/         # Critical patterns (READ FIRST)
+├── schema.yaml       # Solution validation schema
+└── {categories}/     # Categorized solutions
+docs/explorations/    # Deep investigations & research
+skills/               # Modular capabilities
+plans/                # Implementation plans from /plan
+└── archive/          # Completed plans
+todos/                # Work items from /review, /triage
+└── archive/          # Completed todos
+docs/specs/           # Multi-session specifications
+└── archive/          # Completed specs
+```
+
+---
+
+## Key Principles
+
+1. **Search before solving** - Check `docs/solutions/` and `docs/explorations/`
+2. **Document after solving** - Run `/compound` when you fix something
+3. **Follow patterns** - Reference `critical-patterns.md`
+4. **Create todos for deferred work** - Don't just document in artifacts
+5. **Use conventional commits** - Enables changelog automation
+6. **Housekeeping before push** - Run `/housekeeping` to archive completed work
+
+---
+
+## Changelog
+
+### 2026-01-24
+- Added Purpose, Components, and Component Details sections
+- Restructured for documentation validation compliance
+
+### 2025-12-20
+- Added modular skills section
+- Updated core loop documentation