[Sprint 3] feat: Implement auto-suggest hook for clarity-assist #227

New Issue

lmiranda · 2026-01-27T21:51:30Z

lmiranda commented

2026-01-27 21:51:30 +00:00

Description

Implement a UserPromptSubmit hook that analyzes user prompts for vagueness and suggests /clarity-assist when needed. Non-blocking.

Implementation

Wiki: Sprint 3: Hooks Implementation

Plugin: plugins/clarity-assist/

Technical Details

Hook Configuration

Event: UserPromptSubmit
Behavior: Suggest only (non-blocking)

Vagueness Patterns

Short prompts without clear action
Ambiguous pronouns ("fix it")
Missing specifics ("make it better")

Files to Create/Modify

plugins/clarity-assist/hooks/
  hooks.json           # UserPromptSubmit hook
  detect-vagueness.sh  # Detection script

Acceptance Criteria

Hook in hooks/hooks.json
Detects vagueness patterns
Non-blocking suggestions
Avoids false positives
ND-friendly design

Technical Notes

CRITICAL: Hooks must be in hooks/hooks.json, NOT inline in plugin.json.

## Description Implement a `UserPromptSubmit` hook that analyzes user prompts for vagueness and suggests `/clarity-assist` when needed. Non-blocking. ## Implementation **Wiki:** [Sprint 3: Hooks Implementation](https://gitea.hotserv.cloud/personal-projects/leo-claude-mktplace/wiki/Change-V5.2.0%3A-Plugin-Enhancements-Proposal-%28Sprint-3-Hooks%29) **Plugin:** `plugins/clarity-assist/` ## Technical Details ### Hook Configuration - **Event:** `UserPromptSubmit` - **Behavior:** Suggest only (non-blocking) ### Vagueness Patterns - Short prompts without clear action - Ambiguous pronouns ("fix it") - Missing specifics ("make it better") ### Files to Create/Modify ``` plugins/clarity-assist/hooks/ hooks.json # UserPromptSubmit hook detect-vagueness.sh # Detection script ``` ## Acceptance Criteria - [ ] Hook in `hooks/hooks.json` - [ ] Detects vagueness patterns - [ ] Non-blocking suggestions - [ ] Avoids false positives - [ ] ND-friendly design ## Technical Notes **CRITICAL:** Hooks must be in `hooks/hooks.json`, NOT inline in plugin.json.