1

Change-V5.2.0:-Plugin-Enhancements-Proposal.-

Leo Miranda edited this page 2026-01-28 19:15:30 +00:00

Table of Contents

• V5.2.0 Plugin Enhancements
• Overview
• Implementations
• Sprint 3: Hooks (6 items) - COMPLETED
• git-flow (2 items)
• clarity-assist (1 item)
• data-platform (1 item)
• contract-validator (2 items)
• Lessons Learned
• Sprint 4: Commands (18 items) - COMPLETED
• projman (1 item)
• pr-review (2 items)
• data-platform (3 items)
• viz-platform (3 items)
• contract-validator (1 item)
• doc-guardian (3 items)
• claude-config-maintainer (2 items)
• cmdb-assistant (3 items)
• Sprint 5: Documentation (4 items)
• git-flow (1 item)
• clarity-assist (1 item)
• Additional docs
• Parked Items (Future Sprints)
• Technical Notes
• Hook Implementation Pattern
• Valid Hook Events
• Hook Types

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	Implemented
Sprint 4	Commands (new user-facing features)	18	Implemented
Sprint 5	Documentation (guides, best practices)	4	In Progress

Implementations

• Sprint 3: Hooks - Completed 2026-01-28
• Sprint 4: Commands - Completed 2026-01-28
• Sprint 5: Documentation - In Progress

---

Sprint 3: Hooks (6 items) - COMPLETED

Foundational enforcement and detection hooks that other features may depend on.

Completed: 2026-01-28 Issues: #225, #226, #227, #228, #229, #230 Milestone: Sprint 3 - Hooks

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) - DONE
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) - DONE

clarity-assist (1 item)

3. Auto-suggest hook - UserPromptSubmit hook with vagueness detection, suggests /clarity-assist when needed - DONE

data-platform (1 item)

4. Schema diff detection - Hook to warn on breaking schema changes. Hook type: PostToolUse on file edits to schema files - DONE

contract-validator (2 items)

5. SessionStart auto-validate hook - Smart mode (only runs when plugin files changed since last check) - DONE
6. Breaking change detection - Warn when interface changes break consumers. Works with auto-validate hook. - DONE

Lessons Learned

• Background Agent Permissions Must Be Pre-Granted
• Agent Runaway Detection and Timeout Handling
• MCP Server Branch Detection Bug

---

Sprint 4: Commands (18 items) - COMPLETED

New user-facing commands and features.

Completed: 2026-01-28 Issues: #241-#258 Milestone: Sprint 4 - Commands PR: #261 (feat/sprint-4-commands)

projman (1 item)

7. Dynamic sprint diagram - /sprint-diagram command generating Mermaid diagram of sprint issues and dependencies - DONE

pr-review (2 items)

8. Confidence threshold config - Env var PR_REVIEW_CONFIDENCE_THRESHOLD to filter low-confidence warnings - DONE
9. pr-diff command - Formatted diff with annotations (review comments + inline agent analysis) - DONE

data-platform (3 items)

10. data-quality command - Run quality checks on dataframes (nulls, duplicates, types, outliers) - DONE
11. lineage-viz command - Mermaid wrapper around dbt_lineage for visual output - DONE
12. dbt-test command - User-friendly wrapper for dbt_test - DONE

viz-platform (3 items)

13. chart-export command - Export to PNG, SVG, PDF - DONE
14. Color blind validation - /accessibility-check command with WCAG validation - DONE
15. Responsive breakpoint config - /breakpoints command for mobile-first layout - DONE

contract-validator (1 item)

16. dependency-graph command - Mermaid visualization of plugin dependencies - DONE

doc-guardian (3 items)

17. changelog-gen command - Generate changelog from commit history - DONE
18. Doc coverage metrics - /doc-coverage command to measure documentation coverage - DONE
19. Stale doc warnings - /stale-docs command to flag outdated documentation - DONE

claude-config-maintainer (2 items)

20. config-diff command - Track CLAUDE.md changes over time - DONE
21. Linting best practices - /config-lint command for CLAUDE.md anti-pattern detection - DONE

cmdb-assistant (3 items)

22. cmdb-topology command - Visualize network/rack topology with Mermaid - DONE
23. Change audit trail - /change-audit command for CMDB modification tracking - DONE
24. IP conflict detection - /ip-conflicts command for overlapping IP detection - DONE

---

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

• Documentation updates discovered during Sprint 3/4 implementation (see #266)

---

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

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)