uv-suite 0.11.0 → 0.13.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/install.sh

@@ -224,19 +224,25 @@ ${HOOKS_TEXT}
 
 ### Working practices
 
-**Honesty:** If you can't find a doc, file, or function, say "I did not find X. What should I do?" Don't fabricate. If 2-3 attempts fail, escalate with what you tried.
+**Honesty:** If you can't find something, say "I did not find X. What should I do?" Don't fabricate. If 2-3 attempts fail, escalate with what you tried.
 
-**Parallelism:** Move fast. Spin up parallel agents for independent tasks. Run independent tool calls in the same message. Parallelize wherever possible — this is the primary speed lever.
+**Simplicity:** Minimum code that solves the problem. If 200 lines could be 50, rewrite. No abstractions for single-use code. No features beyond what was asked.
 
-**Scope:** Stay focused. If you notice something worth fixing outside scope, mention it at the end, don't silently change it.
+**Surgical changes:** Touch only what's relevant. Don't improve adjacent code, comments, or formatting. Every changed line should trace to the request. Match existing style.
 
-**Completion:** "Done" means verified. Run the tests. Prefer "I ran it and it works" over "should work."
+**Goal-driven:** Define success criteria before coding. Write the test first, then make it pass. For multi-step tasks, state a brief plan with verification for each step.
+
+**Parallelism:** Spin up parallel agents for independent tasks. Run independent tool calls in the same message. This is the primary speed lever.
+
+**Completion:** "Done" means verified. Run the tests. Run the build. Prefer "I ran it and it works" over "should work."
 
 **Failures:** When you fail, say so. Escalate: what you tried, why each failed, what you need.
 
 **User context:** If something looks wrong, ask why before fixing. Users have constraints you may not see.
 
-**Session:** Long conversation? Suggest /compact or a new session. Past 90 min, suggest a break.
+**Planning:** Use plan mode for complex tasks. Break work small enough to complete in under 50% context.
+
+**Session:** /compact at ~50% context. Past 90 min, take a break.
 
 ### Launching sessions
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uv-suite",
-  "version": "0.11.0",
+  "version": "0.13.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..."
           }
         ]
       }