uv-suite 0.11.0 → 0.12.0

package/hooks/doc-slop-grep.sh

@@ -0,0 +1,50 @@
+#!/bin/bash
+# UV Suite Hook: Fast deterministic doc-slop check
+# Event: PostToolUse (Write) — Spike persona
+# Greps for vague adjectives and buzzwords in documentation files. No LLM.
+
+INPUT=$(cat)
+FILE_PATH=$(echo "$INPUT" | jq -r '.tool_input.file_path // empty')
+
+if [ -z "$FILE_PATH" ] || [ ! -f "$FILE_PATH" ]; then
+  exit 0
+fi
+
+EXT="${FILE_PATH##*.}"
+
+# Only check markdown and text files
+case "$EXT" in
+  md|txt|rst|adoc) ;;
+  *) exit 0 ;;
+esac
+
+FINDINGS=""
+
+# Vague adjectives that say nothing
+MATCH=$(grep -in "robust\|scalable\|comprehensive\|extensible\|maintainable\|enterprise-grade\|battle-tested\|cutting-edge\|state-of-the-art" "$FILE_PATH" 2>/dev/null | head -3)
+if [ -n "$MATCH" ]; then
+  FINDINGS="${FINDINGS}Vague adjectives — replace with specific facts: $(echo "$MATCH" | head -1 | sed 's/"/\\"/g'). "
+fi
+
+# Evasive verbs
+MATCH=$(grep -in "leverages\|utilizes\|facilitates\|empowers\|enables seamless" "$FILE_PATH" 2>/dev/null | head -3)
+if [ -n "$MATCH" ]; then
+  FINDINGS="${FINDINGS}Evasive verbs — say what it actually does: $(echo "$MATCH" | head -1 | sed 's/"/\\"/g'). "
+fi
+
+# Authority appeals without specifics
+MATCH=$(grep -in "best practices\|industry-standard\|widely adopted\|production-ready" "$FILE_PATH" 2>/dev/null | head -3)
+if [ -n "$MATCH" ]; then
+  FINDINGS="${FINDINGS}Name the specific practice instead of citing authority: $(echo "$MATCH" | head -1 | sed 's/"/\\"/g'). "
+fi
+
+if [ -n "$FINDINGS" ]; then
+  cat <<EOF
+{
+  "continue": true,
+  "systemMessage": "Doc slop: ${FINDINGS}"
+}
+EOF
+fi
+
+exit 0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uv-suite",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "Portable framework for AI-assisted software development. 10 agents, 9 skills, 5 hooks, 4 personas. Works with Claude Code, Cursor, and Codex.",
   "author": "Utsav Anand",
   "license": "MIT",

package/personas/spike.json

@@ -49,11 +49,10 @@
         "matcher": "Write",
         "hooks": [
           {
-            "type": "prompt",
-            "prompt": "The agent just wrote a documentation or analysis file. Check for documentation slop: (1) vague adjectives like 'robust', 'scalable', 'comprehensive', 'leverages', 'facilitates', (2) feature lists that could describe any system, (3) overview sections that don't say what the system actually does, (4) claims without specifics ('industry-standard best practices'). If you find slop, respond {\"ok\": false, \"reason\": \"Doc slop: [finding]. Fix: replace with specific facts.\"}. If clean, respond {\"ok\": true}.",
-            "model": "claude-haiku-4-5",
-            "timeout": 15,
-            "statusMessage": "Checking documentation quality..."
+            "type": "command",
+            "command": "\"$CLAUDE_PROJECT_DIR\"/.claude/hooks/doc-slop-grep.sh",
+            "timeout": 3,
+            "statusMessage": "Doc quality check..."
           }
         ]
       }