kb-query

KB-Query — Search the Super-Skills Knowledge Base

Grep-based and structured search across all KB artifacts accumulated by the super-skills pipeline. Structured claim grammar, alias maps, and indexes improve grep before any vector dependency is needed.

---

Query Interface

When the user (or agent) says any of:

• "search KB for [topic]"
• "have we decided on [topic] before?"
• "any PATTERN-DEBT for [module]?"
• "what's the risk assessment for [feature]?"
• "find ADRs related to [keyword]"

→ run this skill.

---

Search Targets

docs/superskills/adrs/          — Architecture Decision Records
docs/superskills/pattern-debt.md — PATTERN-DEBT registry
docs/superskills/specs/         — Design specs with risk assessments
docs/superskills/plans/         — Implementation plans
docs/superskills/qbr-calibration.md — QBR accuracy history

---

The Process

Step 1: Validate KB exists

# KB state snapshot (auto-injected at skill load):
!echo "=== ADRs ===" && ls docs/superskills/adrs/ 2>/dev/null | wc -l | xargs echo "count:"
!echo "=== Open PATTERN-DEBTs ===" && grep -c "status: OPEN" docs/superskills/pattern-debt.md 2>/dev/null || echo "0"
!echo "=== Specs ===" && ls docs/superskills/specs/ 2>/dev/null | wc -l | xargs echo "count:"

[ -d docs/superskills ] || { echo "KB not initialized — run skill-init first"; exit 1; }

Step 2: Run targeted searches

QUERY="<search term>"

echo "=== ADRs ==="
grep -rl "$QUERY" docs/superskills/adrs/ 2>/dev/null \
  && grep -l "$QUERY" docs/superskills/adrs/*.md | while read f; do
       echo "--- $f ---"
       grep -n "$QUERY\|^## [0-9]\|^# ADR" "$f" | head -20
     done

echo "=== PATTERN-DEBT ==="
grep -A 12 "PATTERN-DEBT" docs/superskills/pattern-debt.md \
  | grep -i "$QUERY\|PATTERN-DEBT\|status:\|owner:\|resolution_trigger:"

echo "=== SPECS (Risk Assessments) ==="
grep -rl "$QUERY" docs/superskills/specs/ 2>/dev/null \
  | while read f; do
      echo "--- $f ---"
      grep -n "$QUERY\|## Risk Assessment\|Gate Result" "$f" | head -10
    done

echo "=== QBR HISTORY ==="
grep -i "$QUERY" docs/superskills/qbr-calibration.md 2>/dev/null | head -10