diff --git a/Change-V5.2.0%3A-Plugin-Enhancements-Proposal.md b/Change-V5.2.0%3A-Plugin-Enhancements-Proposal.md new file mode 100644 index 0000000..b795212 --- /dev/null +++ b/Change-V5.2.0%3A-Plugin-Enhancements-Proposal.md @@ -0,0 +1,133 @@ +> **Type:** Change Proposal +> **Version:** V5.2.0 +> **Status:** In Progress +> **Date:** 2026-01-27 +> **Scope:** Multi-plugin enhancement initiative + +# V5.2.0 Plugin Enhancements + +This proposal covers 26 enhancement items across 10 plugins, organized into 3 implementation sprints. + +## Overview + +| Sprint | Focus | Items | Status | +|--------|-------|-------|--------| +| Sprint 3 | Hooks (enforcement, validation, detection) | 6 | Planning | +| Sprint 4 | Commands (new user-facing features) | 16 | Backlog | +| Sprint 5 | Documentation (guides, best practices) | 4 | Backlog | + +## Implementations + +- [Sprint 3: Hooks](Change-V5.2.0%3A-Plugin-Enhancements-Proposal-%28Sprint-3-Hooks%29) - Current + +--- + +## Sprint 3: Hooks (6 items) + +Foundational enforcement and detection hooks that other features may depend on. + +### git-flow (2 items) +1. **Commit enforcement hook** - Validate conventional commit format on all commits (not just `/commit` command). Hook type: `PreToolUse` on Bash (git commit detection) +2. **Branch name validation hook** - Validate branch naming on creation (format: `type/description`, lowercase, max 50 chars). Hook type: `PreToolUse` on Bash (git checkout -b detection) + +### clarity-assist (1 item) +3. **Auto-suggest hook** - `UserPromptSubmit` hook with vagueness detection, suggests `/clarity-assist` when needed + +### data-platform (1 item) +4. **Schema diff detection** - Hook to warn on breaking schema changes. Hook type: `PostToolUse` on file edits to schema files + +### contract-validator (2 items) +5. **SessionStart auto-validate hook** - Smart mode (only runs when plugin files changed since last check) +6. **Breaking change detection** - Warn when interface changes break consumers. Works with auto-validate hook. + +--- + +## Sprint 4: Commands (16 items) + +New user-facing commands and features. + +### projman (1 item) +7. **Dynamic sprint diagram** - Mermaid diagram showing current sprint's issues, dependencies, and flow. Integrate with `/sprint-status` or new `/sprint-diagram` command. + +### pr-review (2 items) +8. **Confidence threshold config** - Env var `PR_REVIEW_CONFIDENCE_THRESHOLD` to filter low-confidence warnings +9. **pr-diff command** - Formatted diff with annotations (review comments + inline agent analysis) + +### data-platform (3 items) +10. **data-quality command** - Run quality checks on dataframes (nulls, duplicates, types, outliers) +11. **lineage-viz command** - Mermaid wrapper around `dbt_lineage` for visual output +12. **dbt-test command** - User-friendly wrapper for `dbt_test` + +### viz-platform (3 items) +13. **chart-export command** - Export to PNG, SVG, PDF +14. **Color blind validation** - Theme accessibility check for color blind users +15. **Responsive breakpoint config** - Mobile-first layout configuration + +### contract-validator (1 item) +16. **dependency-graph command** - Mermaid visualization of plugin dependencies + +### doc-guardian (3 items) +17. **changelog-gen command** - Generate changelog from commit history +18. **Doc coverage metrics** - Measure and report documentation coverage +19. **Stale doc warnings** - Flag docs older than X commits behind related code + +### claude-config-maintainer (2 items) +20. **config-diff command** - Track CLAUDE.md changes over time +21. **Linting best practices** - Warn on anti-patterns in CLAUDE.md + +### cmdb-assistant (3 items) +22. **cmdb-topology command** - Visualize network/rack topology with Mermaid +23. **Change audit trail** - Track CMDB modifications (wrapper around existing object_changes tools) +24. **IP conflict detection** - Warn on overlapping IP allocations + +--- + +## Sprint 5: Documentation (4 items) + +Guides and documentation improvements. + +### git-flow (1 item) +25. **Branching strategy documentation** - Document `development -> staging -> main` promotion flow + +### clarity-assist (1 item) +26. **ND support documentation** - Document how the plugin supports neurodivergent users + +### Additional docs +- Any documentation updates discovered during Sprint 3/4 implementation + +--- + +## Parked Items (Future Sprints) + +These items were discussed but deferred: +- Plugin branding / visual output overhaul +- CODEOWNERS integration +- Template library (clarity-assist + claude-config-maintainer) + +--- + +## Technical Notes + +### Hook Implementation Pattern + +**CRITICAL:** All hooks must be defined in `hooks/hooks.json`, NOT inline in plugin.json. + +``` +plugins/{name}/ + hooks/ + hooks.json <-- Hook definitions go here + *.sh <-- Shell scripts for command-type hooks +``` + +Reference: [Lesson - Plugin Hooks Must Be in Separate File](lessons%2Fpatterns%2Fplugin-hooks-must-be-in-separate-file-not-inline.-) + +### Valid Hook Events +- `PreToolUse` - Before tool execution (can block) +- `PostToolUse` - After tool execution +- `UserPromptSubmit` - When user submits prompt +- `SessionStart` - When session begins +- `SessionEnd` - When session ends + +### Hook Types +- `command` - Execute shell script (recommended for complex logic) +- `prompt` - Inject prompt text (lightweight, no execution)