mindforge-cc 11.2.1 → 11.3.0

package/subagents/tools/subagent-catalog/fetch.md

@@ -0,0 +1,82 @@
+---
+name: fetch
+description: "Fetch full subagent definition from catalog. Use when user wants to get, download, view, or use a specific subagent."
+---
+
+# Subagent Catalog - Fetch
+
+Get the full definition of a specific agent.
+
+## Input: $ARGUMENTS
+
+Accepts: agent name, path, or GitHub URL.
+
+## Example
+
+```
+/subagent-catalog:fetch code-reviewer
+
+## code-reviewer
+
+**Category**: Quality & Security
+**Tools**: Read, Write, Edit, Bash, Glob, Grep
+
+Expert code reviewer specializing in code quality, security vulnerabilities...
+
+[full definition follows]
+
+---
+**What now?**
+- save to ~/.claude/agents/code-reviewer.md
+- customize for this project
+- spawn as Task subagent
+```
+
+## Instructions
+
+### Progress checklist
+
+Copy and track:
+- [ ] Step 1: Resolve agent path from catalog
+- [ ] Step 2: Fetch full definition
+- [ ] Step 3: Display and offer options
+
+### Step 1: Resolve path
+
+```bash
+source ~/.claude/commands/subagent-catalog/config.sh
+subagent_catalog_ensure_cache
+
+# find the agent (use -F for literal match)
+grep -iF "{{NAME}}" "$SUBAGENT_CATALOG_CACHE_FILE"
+```
+
+Extract path from: `[**name**](path)`
+
+### Step 2: Fetch definition
+
+```bash
+tmp_file=$(mktemp)
+if curl -sf "$SUBAGENT_CATALOG_REPO_URL/{{PATH}}" -o "$tmp_file"; then
+  cat "$tmp_file"
+  rm -f "$tmp_file"
+else
+  rm -f "$tmp_file"
+  subagent_catalog_log_error "failed to fetch. try /subagent-catalog:search first"
+fi
+```
+
+### Step 3: Display and offer options
+
+Show the definition with frontmatter parsed, then offer:
+1. save locally (`~/.claude/agents/<name>.md`)
+2. customize for project
+3. spawn as Task
+
+### Error handling
+
+| error | suggestion |
+|-------|------------|
+| not found | run `/subagent-catalog:search <partial>` |
+| multiple matches | list them, ask user to specify |
+| network error | check connection, retry |

package/subagents/tools/subagent-catalog/invalidate.md

@@ -0,0 +1,47 @@
+---
+name: invalidate
+description: "Invalidate the subagent-catalog cache. Use when results seem stale or user explicitly asks to refresh or clear cache."
+---
+
+# Subagent Catalog - Invalidate
+
+Force-refresh the cached catalog by deleting the local cache file. The next `search` or `fetch` call will pull fresh data from the repository.
+
+## Input: $ARGUMENTS
+
+No arguments required. Optional: pass `--fetch` to immediately refresh after invalidation.
+
+## Instructions
+
+### Step 1: Source config
+
+```bash
+source ~/.claude/commands/subagent-catalog/config.sh
+```
+
+### Step 2: Invalidate (and optionally refresh)
+
+**Invalidate only** (default):
+
+```bash
+subagent_catalog_invalidate_cache
+```
+
+**Invalidate and refresh** (if `$ARGUMENTS` contains `--fetch` or user explicitly asks to refresh):
+
+```bash
+subagent_catalog_invalidate_cache
+subagent_catalog_refresh_cache
+```
+
+### Step 3: Confirm
+
+Report the result:
+- If invalidated only: "cache invalidated. next search/fetch will pull fresh data."
+- If refreshed: "cache invalidated and refreshed with latest catalog."
+
+### When to use
+
+- After the upstream repo has been updated with new subagents
+- If you suspect the cache is corrupted
+- To troubleshoot stale results

package/subagents/tools/subagent-catalog/list.md

@@ -0,0 +1,54 @@
+---
+name: list
+description: "List all categories and agents in the subagent catalog. Use when user wants to see everything available or browse the full catalog."
+---
+
+# Subagent Catalog - List
+
+Browse all available categories and agents from the MindForge subagents catalog.
+
+## Input: $ARGUMENTS
+
+No arguments required.
+
+## Instructions
+
+### Step 1: Ensure cache is fresh
+
+```bash
+source ~/.claude/commands/subagent-catalog/config.sh
+subagent_catalog_ensure_cache
+```
+
+### Step 2: Extract and display categories
+
+Parse the catalog and display all categories with their agents:
+
+```bash
+# extract category headers and agent entries
+grep -E "^### \[|^\- \[\*\*" "$SUBAGENT_CATALOG_CACHE_FILE"
+```
+
+### Step 3: Format output
+
+Display as a scannable list:
+
+```
+## Subagent Catalog
+
+### 01. Core Development
+api-designer, backend-developer, frontend-developer, fullstack-developer, ...
+
+### 02. Language Specialists
+typescript-pro, python-pro, rust-engineer, golang-pro, ...
+
+### 03. Infrastructure
+cloud-architect, devops-engineer, kubernetes-specialist, terraform-engineer, ...
+
+[...continue for all 10 categories...]
+```
+
+### Tips
+
+- use `/subagent-catalog:search <query>` to filter by keyword
+- use `/subagent-catalog:fetch <name>` to get full definition

package/subagents/tools/subagent-catalog/search.md

@@ -0,0 +1,58 @@
+---
+name: search
+description: "Search the MindForge subagents catalog. Use when user wants to find, discover, or browse available subagents by name, category, or capability."
+---
+
+# Subagent Catalog - Search
+
+Find agents by name, description, or category.
+
+## Input: $ARGUMENTS
+
+## Example output
+
+```
+## Results for "kubernetes"
+
+| Agent | Description |
+|-------|-------------|
+| [kubernetes-specialist](https://github.com/sairam0424/MindForge/blob/develop/subagents/categories/03-infrastructure/kubernetes-specialist.md) | Container orchestration master |
+| [devops-engineer](https://github.com/sairam0424/MindForge/blob/develop/subagents/categories/03-infrastructure/devops-engineer.md) | CI/CD and automation expert |
+
+→ use `/subagent-catalog:fetch <name>` to get full definition
+```
+
+## Instructions
+
+### Step 1: Get catalog
+
+```bash
+source ~/.claude/commands/subagent-catalog/config.sh
+subagent_catalog_ensure_cache
+cat "$SUBAGENT_CATALOG_CACHE_FILE"
+```
+
+### Step 2: Match and return
+
+Search the catalog content for matches (case-insensitive substring):
+- agent names
+- descriptions
+- category names
+
+Format each match as a table row with GitHub link.
+
+### Step 3: Handle edge cases
+
+- **no results**: suggest related terms or `/subagent-catalog:list`
+- **too many results**: ask user to narrow the query
+- **category match**: show all agents in that category
+
+## Query examples
+
+| query | matches |
+|-------|---------|
+| `kubernetes` | kubernetes-specialist, devops-engineer |
+| `security` | security-engineer, security-auditor, penetration-tester |
+| `python` | python-pro, django-developer |
+| `review` | code-reviewer, architect-reviewer |
+| `infrastructure` | entire category 03 |