uv-suite 0.2.0 → 0.3.0

package/agents/claude-code/anti-slop-guard.md

@@ -9,14 +9,18 @@ tools:
   - Read
   - Grep
   - Glob
-disallowedTools:
   - Write
+disallowedTools:
   - Edit
 effort: high
 ---
 
 You are the **Anti-Slop Guard** — your job is to catch AI-generated low-quality output that looks plausible but adds no value or actively hurts the codebase.
 
+## Artifact Output
+
+Write the slop report to `uv-out/slop-check-YYYY-MM-DD.md`. Create the directory if needed. Summarize findings in the conversation.
+
 ## What You Scan For
 
 ### Comment Slop

package/agents/claude-code/architect.md

@@ -49,6 +49,14 @@ For each key decision, document:
 - [ ] [Concrete, testable check]
 ```
 
+## Artifact Output
+
+Write all output to `uv-out/architecture/`:
+- `uv-out/architecture/decisions.md` — architecture decision records
+- `uv-out/architecture/acts-plan.md` — Acts breakdown with tasks and cycle budgets
+
+Create the directory if needed. Summarize the design in the conversation.
+
 ### 4. Task Dependency Graph
 Mermaid diagram showing parallelism opportunities.
 

package/agents/claude-code/cartographer.md

@@ -11,8 +11,8 @@ tools:
   - Grep
   - Glob
   - Bash
-disallowedTools:
   - Write
+disallowedTools:
   - Edit
 effort: high
 ---
@@ -86,6 +86,15 @@ Report: graphify-out/GRAPH_REPORT.md
 ### If manual exploration:
 Produce all 6 sections (Architecture Overview, Tech Stack, Dependency Graph, Business Domain Map, Sequence Diagrams, Entry Points) as Mermaid + Markdown.
 
+## Artifact Output
+
+Write all output to `uv-out/`. Create the directory if it doesn't exist.
+
+- `uv-out/map-codebase.md` — the written analysis (business domain map, sequence diagrams, entry points)
+- `uv-out/graphify-out/` — Graphify outputs if used (graph.html, graph.json, GRAPH_REPORT.md)
+
+After writing, tell the human: "Artifacts written to uv-out/map-codebase.md" and summarize key findings in the conversation.
+
 ## Rules
 
 - Graphify first, manual second. Always check.

package/agents/claude-code/eval-writer.md

@@ -44,6 +44,10 @@ You are the **Eval Writer** — your job is to write evaluations that verify AI/
     rubric: "Scoring criteria"
 ```
 
+## Artifact Output
+
+Write evals to `uv-out/evals/`. Create the directory if needed. Match the project's eval framework format (DeepEval preferred).
+
 ## Grading Rubric (be this specific)
 
 ```yaml

package/agents/claude-code/reviewer.md

@@ -10,8 +10,8 @@ tools:
   - Grep
   - Glob
   - Bash
-disallowedTools:
   - Write
+disallowedTools:
   - Edit
 effort: high
 ---
@@ -63,6 +63,10 @@ You are the **Reviewer** — your job is to catch bugs, security issues, perform
 | **Medium** | Style, naming, minor refactor | Fix if easy |
 | **Low** | Nitpick, suggestion | Author's discretion |
 
+## Artifact Output
+
+Write the review report to `uv-out/review-YYYY-MM-DD.md`. Create the directory if needed. Summarize key findings in the conversation.
+
 ## Common Findings (be this specific)
 
 **Null dereference:**

package/agents/claude-code/security.md

@@ -10,8 +10,8 @@ tools:
   - Grep
   - Glob
   - Bash
-disallowedTools:
   - Write
+disallowedTools:
   - Edit
 effort: high
 ---
@@ -31,6 +31,10 @@ You are the **Security Agent** — your job is to find security vulnerabilities
 - A09: Logging Failures — Are security events logged? Is PII excluded from logs?
 - A10: SSRF — Are outbound requests validated?
 
+## Artifact Output
+
+Write the security report to `uv-out/security-review-YYYY-MM-DD.md`. Create the directory if needed. Summarize critical/high findings in the conversation.
+
 ## Process
 
 1. Read the code diff or specified files

package/agents/claude-code/spec-writer.md

@@ -60,6 +60,10 @@ How do we know this is done?
 Unit, integration, e2e, load?
 ```
 
+## Artifact Output
+
+Write the spec to `uv-out/specs/[feature-name]-spec.md`. Create the directory if needed. Summarize the spec in the conversation.
+
 ## Process
 
 1. Parse the input into discrete requirements

package/install.sh

@@ -142,6 +142,69 @@ if [ "$INSTALL_MODE" = "project" ]; then
   done
 fi
 
+# --- Write UV Suite context to CLAUDE.md (before bundled tools, which can be slow) ---
+if [ "$INSTALL_MODE" = "project" ]; then
+  PROJECT_ROOT="$(dirname "$TARGET_DIR")"
+  CLAUDE_MD="$PROJECT_ROOT/CLAUDE.md"
+  UV_VERSION=$(grep '"version"' "$UV_SUITE_DIR/package.json" 2>/dev/null | head -1 | sed 's/.*": "//;s/".*//')
+
+  # Remove existing UV Suite section if present
+  if [ -f "$CLAUDE_MD" ] && grep -q "## UV Suite" "$CLAUDE_MD" 2>/dev/null; then
+    echo "Updating UV Suite section in CLAUDE.md..."
+    # Create temp file without UV Suite section
+    awk '/^## UV Suite$/{found=1; next} /^## [^U]/{if(found){found=0}} !found' "$CLAUDE_MD" > "$CLAUDE_MD.tmp"
+    mv "$CLAUDE_MD.tmp" "$CLAUDE_MD"
+  else
+    echo "Adding UV Suite section to CLAUDE.md..."
+    # Create CLAUDE.md if it doesn't exist
+    touch "$CLAUDE_MD"
+  fi
+
+  # Determine active hooks text
+  HOOKS_TEXT=""
+  case "$PERSONA" in
+    professional)
+      HOOKS_TEXT="- auto-lint (on file write), slop check (on file write), danger zone (on file edit), destructive block (on bash), review reminder (on session end)" ;;
+    auto)
+      HOOKS_TEXT="- auto-lint (on file write), destructive block (on bash)" ;;
+    sport)
+      HOOKS_TEXT="- auto-lint (on file write)" ;;
+    spike)
+      HOOKS_TEXT="- doc slop check (on file write)" ;;
+  esac
+
+  cat >> "$CLAUDE_MD" << EOF
+
+## UV Suite
+
+This project uses [UV Suite](https://github.com/utsavanand/uv-suite) v${UV_VERSION} for AI-assisted development.
+
+**Active persona:** ${PERSONA_LABEL}
+
+### Skills
+
+/map-codebase, /map-stack, /spec, /architect, /review, /write-tests, /write-evals, /slop-check, /prototype, /security-review
+
+### Artifacts
+
+Agent output is written to uv-out/. Agents read prior artifacts automatically:
+- /map-codebase writes uv-out/map-codebase.md (read by /architect, /review, /security-review)
+- /spec writes uv-out/specs/ (read by /architect, /write-tests, /write-evals)
+- /architect writes uv-out/architecture/ (read by /review, /write-tests, /slop-check)
+- /review writes uv-out/review-*.md (read by /slop-check, /security-review)
+
+### Hooks
+
+${HOOKS_TEXT}
+
+### Personas
+
+Start sessions with: ./uv.sh spike | sport | pro | auto
+EOF
+
+  echo "  ✓ UV Suite section added to CLAUDE.md"
+fi
+
 # --- Install bundled tools ---
 echo "Installing bundled integrations..."
 
@@ -162,7 +225,7 @@ if [ -n "$PIP_CMD" ]; then
       echo "  ✓ $label (already installed)"
     else
       echo "  Installing $label..."
-      $PIP_CMD install "$pkg" --quiet 2>/dev/null
+      timeout 60 $PIP_CMD install "$pkg" --quiet 2>/dev/null
       if command -v "$cmd" &>/dev/null || $PIP_CMD show "$pkg" &>/dev/null; then
         echo "  ✓ $label installed"
       else
@@ -221,6 +284,100 @@ else
   fi
 fi
 
+# --- Write UV Suite context to CLAUDE.md ---
+if [ "$INSTALL_MODE" = "project" ]; then
+  PROJECT_ROOT="$(dirname "$TARGET_DIR")"
+  CLAUDE_MD="$PROJECT_ROOT/CLAUDE.md"
+
+  # Check if UV Suite section already exists
+  if [ -f "$CLAUDE_MD" ] && grep -q "## UV Suite" "$CLAUDE_MD" 2>/dev/null; then
+    echo "Updating UV Suite section in CLAUDE.md..."
+    # Remove old UV Suite section and rewrite
+    sed -i.bak '/^## UV Suite$/,/^## [^U]/{ /^## [^U]/!d; }' "$CLAUDE_MD" 2>/dev/null || true
+    rm -f "$CLAUDE_MD.bak" 2>/dev/null
+  else
+    echo "Adding UV Suite section to CLAUDE.md..."
+  fi
+
+  cat >> "$CLAUDE_MD" << CLAUDEMD
+
+## UV Suite
+
+This project uses [UV Suite](https://github.com/utsavanand/uv-suite) for AI-assisted development.
+
+**Active persona:** $PERSONA_LABEL
+**Version:** $(cat "$UV_SUITE_DIR/package.json" 2>/dev/null | grep '"version"' | head -1 | sed 's/.*: "//;s/".*//')
+
+### Available skills (slash commands)
+
+| Command | Agent | What it does |
+|---------|-------|-------------|
+| /map-codebase [dir] | Cartographer | Build knowledge graph of codebase |
+| /map-stack [dir] | Cartographer | Map multiple services and their connections |
+| /spec [requirements] | Spec Writer | Write technical specification |
+| /architect [spec] | Architect | Design architecture, decompose into Acts |
+| /review | Reviewer | Code review (correctness, security, perf, slop) |
+| /write-tests [file] | Test Writer | Generate tests matching project conventions |
+| /write-evals [prompt] | Eval Writer | Write AI/LLM evaluation cases |
+| /slop-check | Anti-Slop Guard | Detect 6 categories of AI-generated slop |
+| /prototype [concept] | Prototype Builder | Build static React prototype |
+| /security-review | Security Agent | OWASP audit, dependency scan, secret detection |
+
+### Artifacts
+
+All agent output is written to \`uv-out/\`. Each agent reads relevant prior artifacts from this directory automatically.
+
+| Artifact | Written by | Read by |
+|----------|-----------|---------|
+| uv-out/map-codebase.md | /map-codebase | /architect, /review, /security-review |
+| uv-out/specs/*.md | /spec | /architect, /write-tests, /write-evals |
+| uv-out/architecture/*.md | /architect | /review, /write-tests, /slop-check |
+| uv-out/review-*.md | /review | /slop-check, /security-review |
+| uv-out/security-review-*.md | /security-review | — |
+| uv-out/slop-check-*.md | /slop-check | — |
+
+### Active hooks
+
+Hooks fire automatically on every relevant action. You do not invoke these.
+
+$(if [ "$PERSONA" = "professional" ]; then
+cat << 'HOOKS'
+- **auto-lint** (on file write) — runs prettier/ruff/gofmt
+- **slop check** (on file write) — Haiku scans for obvious slop
+- **danger zone** (on file edit) — warns if file is in DANGER-ZONES.md
+- **destructive block** (on bash) — blocks rm -rf, force push
+- **review reminder** (on session end) — reminds to /review if uncommitted changes
+HOOKS
+elif [ "$PERSONA" = "auto" ]; then
+cat << 'HOOKS'
+- **auto-lint** (on file write) — runs prettier/ruff/gofmt
+- **destructive block** (on bash) — blocks rm -rf, force push
+HOOKS
+elif [ "$PERSONA" = "sport" ]; then
+cat << 'HOOKS'
+- **auto-lint** (on file write) — runs prettier/ruff/gofmt
+HOOKS
+elif [ "$PERSONA" = "spike" ]; then
+cat << 'HOOKS'
+- **doc slop check** (on file write) — Haiku checks documentation quality
+HOOKS
+fi)
+
+### Personas
+
+Switch persona by starting a new session:
+
+\`\`\`
+./uv.sh spike    # Research & docs (Opus, max)
+./uv.sh sport    # New projects (Sonnet, high)
+./uv.sh pro      # Production code (all hooks, all guardrails)
+./uv.sh auto     # Fully autonomous (max, everything approved)
+\`\`\`
+CLAUDEMD
+
+  echo "  ✓ UV Suite section added to CLAUDE.md"
+fi
+
 # --- Install launcher script ---
 echo "Installing session launcher..."
 cp "$UV_SUITE_DIR/uv.sh" "$TARGET_DIR/../uv.sh" 2>/dev/null || true

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uv-suite",
-  "version": "0.2.0",
+  "version": "0.3.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/skills/architect/SKILL.md

@@ -24,3 +24,15 @@ $ARGUMENTS
 ## Project context
 
 !`cat CLAUDE.md 2>/dev/null || echo "No CLAUDE.md found"`
+
+## Prior analysis
+
+### Codebase map
+
+!`cat uv-out/map-codebase.md 2>/dev/null | head -100 || echo "No codebase map — run /map-codebase first for better architecture context"`
+
+### Spec (if written)
+
+!`ls uv-out/specs/*.md 2>/dev/null | head -5 || echo "No specs found"`
+
+!`cat $(ls -t uv-out/specs/*.md 2>/dev/null | head -1) 2>/dev/null | head -80 || echo ""`

package/skills/map-codebase/SKILL.md

@@ -48,3 +48,7 @@ cat graphify-out/GRAPH_REPORT.md 2>/dev/null | head -80 || echo "No existing gra
 ## Danger zones
 
 !`cat DANGER-ZONES.md 2>/dev/null || echo "No DANGER-ZONES.md found"`
+
+## Prior analysis (if re-mapping)
+
+!`cat uv-out/map-codebase.md 2>/dev/null | head -30 || echo "No prior map — fresh scan"`

package/skills/map-stack/SKILL.md

@@ -38,6 +38,10 @@ This is NOT a single-repo mapping. You are mapping an entire tech stack — mult
 
 !`cat CLAUDE.md 2>/dev/null || echo "No CLAUDE.md found"`
 
+## Prior codebase maps (from /map-codebase runs)
+
+!`cat uv-out/map-codebase.md 2>/dev/null | head -80 || echo "No prior codebase map — will scan from scratch"`
+
 ## Discover services
 
 ```!

package/skills/review/SKILL.md

@@ -37,3 +37,17 @@ $ARGUMENTS
 ## Danger zones
 
 !`cat DANGER-ZONES.md 2>/dev/null || echo "No DANGER-ZONES.md found"`
+
+## Prior analysis (from other UV Suite agents)
+
+### Architecture map
+
+!`cat uv-out/map-codebase.md 2>/dev/null | head -100 || echo "No codebase map — run /map-codebase first for better review context"`
+
+### Architecture decisions
+
+!`cat uv-out/architecture/decisions.md 2>/dev/null | head -60 || echo "No architecture decisions found"`
+
+### Acts plan
+
+!`cat uv-out/architecture/acts-plan.md 2>/dev/null | head -60 || echo "No acts plan found"`

package/skills/security-review/SKILL.md

@@ -40,6 +40,20 @@ $ARGUMENTS
 
 !`cat DANGER-ZONES.md 2>/dev/null || echo "No DANGER-ZONES.md found"`
 
+## Prior analysis
+
+### Codebase map
+
+!`cat uv-out/map-codebase.md 2>/dev/null | head -80 || echo "No codebase map found"`
+
+### Recent code review findings
+
+!`cat $(ls -t uv-out/review-*.md 2>/dev/null | head -1) 2>/dev/null | head -60 || echo "No prior review found"`
+
+### Recent slop check
+
+!`cat $(ls -t uv-out/slop-check-*.md 2>/dev/null | head -1) 2>/dev/null | head -40 || echo "No prior slop check found"`
+
 ## Available security tools
 
 ```!

package/skills/slop-check/SKILL.md

@@ -28,3 +28,13 @@ $ARGUMENTS
 ### Full diff
 
 !`git diff --cached 2>/dev/null || git diff 2>/dev/null || echo ""`
+
+## Prior analysis
+
+### Architecture decisions (check code against stated rationale)
+
+!`cat uv-out/architecture/decisions.md 2>/dev/null | head -40 || echo "No architecture decisions found"`
+
+### Recent review findings
+
+!`cat $(ls -t uv-out/review-*.md 2>/dev/null | head -1) 2>/dev/null | head -40 || echo "No prior review found"`

package/skills/write-evals/SKILL.md

@@ -26,3 +26,9 @@ $ARGUMENTS
 ## Existing eval framework
 
 !`find . -name "*eval*" -o -name "*evals*" 2>/dev/null | head -10 || echo "No eval files found"`
+
+## Prior analysis
+
+### Spec (requirements to evaluate against)
+
+!`cat $(ls -t uv-out/specs/*.md 2>/dev/null | head -1) 2>/dev/null | head -60 || echo "No spec found"`

package/skills/write-tests/SKILL.md

@@ -38,3 +38,13 @@ $ARGUMENTS
 ## Project test command
 
 !`cat package.json 2>/dev/null | grep -A2 '"test"' || echo "No package.json test script"`
+
+## Prior analysis
+
+### Spec (what to test against)
+
+!`cat $(ls -t uv-out/specs/*.md 2>/dev/null | head -1) 2>/dev/null | head -60 || echo "No spec found — test based on code behavior"`
+
+### Acts plan (current task context)
+
+!`cat uv-out/architecture/acts-plan.md 2>/dev/null | head -40 || echo "No acts plan found"`