context-report

Context Report

Overview

Diagnostic snapshot of the MTK toolkit's active configuration. Shows what's loaded, what's not, and why. Use this when debugging review behavior, understanding why a linter pattern fired, or verifying that a domain pack is active.

When To Use

• After running /mtk-setup to verify configuration
• When a review misses something and you want to see what references loaded
• When onboarding to a new repo to understand the MTK setup
• When debugging linter false positives or false negatives

When NOT To Use

• As part of normal implementation flow (context-engineering handles loading)

Workflow

STEP 1 — Gather state

Collect the following diagnostic data and present it in a single structured report.

1a. Tech Stack

echo "--- Tech Stack ---"
cat .claude/tech-stack 2>/dev/null || echo "(not set)"
if [ -f .claude/tech-stack-pm ]; then echo "Package Manager: $(cat .claude/tech-stack-pm)"; fi

1b. Active Domains

echo "--- Domains ---"
if [ -f .claude/domains ]; then
  cat .claude/domains
else
  echo "(none — create .claude/domains with one domain per line to activate domain packs)"
fi

1c. Linter Packs

echo "--- Linter Packs ---"
PATTERNS_DIR="hooks/linter-patterns"

echo "Core:"
if [ -d "$PATTERNS_DIR/core" ]; then
  for f in "$PATTERNS_DIR"/core/*.txt; do
    [ -f "$f" ] && echo "  $(basename "$f") ($(grep -c '^[^#]' "$f" 2>/dev/null || echo 0) rules)"
  done
else
  echo "  (flat-file layout — pre-6.2)"
fi

STACK="$(cat .claude/tech-stack 2>/dev/null | tr -d '[:space:]')"
if [ -n "$STACK" ]; then
  echo "Stack ($STACK):"
  if [ -d "$PATTERNS_DIR/stack-$STACK" ]; then
    for f in "$PATTERNS_DIR"/stack-"$STACK"/*.txt; do
      [ -f "$f" ] && echo "  $(basename "$f") ($(grep -c '^[^#]' "$f" 2>/dev/null || echo 0) rules)"
    done
  else
    echo "  (not found)"
  fi
fi

echo "Domain:"
if [ -f .claude/domains ]; then
  while IFS= read -r domain; do
    domain="$(echo "$domain" | tr -d '[:space:]')"
    [ -z "$domain" ] && continue
    [[ "$domain" == \#* ]] && continue
    if [ -d "$PATTERNS_DIR/domain-$domain" ]; then
      for f in "$PATTERNS_DIR"/domain-"$domain"/*.txt; do
        [ -f "$f" ] && echo "  $domain/$(basename "$f") ($(grep -c '^[^#]' "$f" 2>/dev/null || echo 0) rules)"
      done
    else
      echo "  $domain: (pack not found at $PATTERNS_DIR/domain-$domain/)"
    fi
  done < .claude/domains
else
  echo "  (no .claude/domains file)"
fi

echo "Project-local:"
project_count=0
if [ -d "$PATTERNS_DIR/project" ]; then
  for f in "$PATTERNS_DIR"/project/*.txt; do
    [ -f "$f" ] && echo "  $(basename "$f") ($(grep -c '^[^#]' "$f" 2>/dev/null || echo 0) rules)" && project_count=$((project_count+1))
  done
fi
[ "$project_count" -eq 0 ] && echo "  (none — add .txt files to hooks/linter-patterns/project/)"