feat(plugins): implement Sprint 4 commands (#241-#258)
Sprint 4 - Plugin Commands implementation adding 18 new user-facing commands across 8 plugins as part of V5.2.0 Plugin Enhancements. **projman:** - #241: /sprint-diagram - Mermaid visualization of sprint issues **pr-review:** - #242: Confidence threshold config (PR_REVIEW_CONFIDENCE_THRESHOLD) - #243: /pr-diff - Formatted diff with inline review comments **data-platform:** - #244: /data-quality - DataFrame quality checks (nulls, duplicates, outliers) - #245: /lineage-viz - dbt lineage as Mermaid diagrams - #246: /dbt-test - Formatted dbt test runner **viz-platform:** - #247: /chart-export - Export charts to PNG/SVG/PDF via kaleido - #248: /accessibility-check - Color blind validation (WCAG contrast) - #249: /breakpoints - Responsive layout configuration **contract-validator:** - #250: /dependency-graph - Plugin dependency visualization **doc-guardian:** - #251: /changelog-gen - Generate changelog from conventional commits - #252: /doc-coverage - Documentation coverage metrics - #253: /stale-docs - Flag outdated documentation **claude-config-maintainer:** - #254: /config-diff - Track CLAUDE.md changes over time - #255: /config-lint - 31 lint rules for CLAUDE.md best practices **cmdb-assistant:** - #256: /cmdb-topology - Infrastructure topology diagrams - #257: /change-audit - NetBox audit trail queries - #258: /ip-conflicts - Detect IP conflicts and overlaps Closes #241, #242, #243, #244, #245, #246, #247, #248, #249, #250, #251, #252, #253, #254, #255, #256, #257, #258 Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
This commit is contained in:
180
plugins/projman/commands/sprint-diagram.md
Normal file
180
plugins/projman/commands/sprint-diagram.md
Normal file
@@ -0,0 +1,180 @@
|
||||
---
|
||||
description: Generate Mermaid diagram of sprint issues with dependencies and status
|
||||
---
|
||||
|
||||
# Sprint Diagram
|
||||
|
||||
This command generates a visual Mermaid diagram showing the current sprint's issues, their dependencies, and execution flow.
|
||||
|
||||
## What This Command Does
|
||||
|
||||
1. **Fetch Sprint Issues** - Gets all issues for the current sprint milestone
|
||||
2. **Fetch Dependencies** - Retrieves dependency relationships between issues
|
||||
3. **Generate Mermaid Syntax** - Creates flowchart showing issue flow
|
||||
4. **Apply Status Styling** - Colors nodes based on issue state (open/closed/in-progress)
|
||||
5. **Show Execution Order** - Visualizes parallel batches and critical path
|
||||
|
||||
## Usage
|
||||
|
||||
```
|
||||
/sprint-diagram
|
||||
/sprint-diagram --milestone "Sprint 4"
|
||||
```
|
||||
|
||||
## MCP Tools Used
|
||||
|
||||
**Issue Tools:**
|
||||
- `list_issues(state="all")` - Fetch all sprint issues
|
||||
- `list_milestones()` - Find current sprint milestone
|
||||
|
||||
**Dependency Tools:**
|
||||
- `list_issue_dependencies(issue_number)` - Get dependencies for each issue
|
||||
- `get_execution_order(issue_numbers)` - Get parallel execution batches
|
||||
|
||||
## Implementation Steps
|
||||
|
||||
1. **Get Current Milestone:**
|
||||
```
|
||||
milestones = list_milestones(state="open")
|
||||
current_sprint = milestones[0] # Most recent open milestone
|
||||
```
|
||||
|
||||
2. **Fetch Sprint Issues:**
|
||||
```
|
||||
issues = list_issues(state="all", milestone=current_sprint.title)
|
||||
```
|
||||
|
||||
3. **Fetch Dependencies for Each Issue:**
|
||||
```python
|
||||
dependencies = {}
|
||||
for issue in issues:
|
||||
deps = list_issue_dependencies(issue.number)
|
||||
dependencies[issue.number] = deps
|
||||
```
|
||||
|
||||
4. **Generate Mermaid Diagram:**
|
||||
```mermaid
|
||||
flowchart TD
|
||||
subgraph Sprint["Sprint 4 - Commands"]
|
||||
241["#241: sprint-diagram"]
|
||||
242["#242: confidence threshold"]
|
||||
243["#243: pr-diff"]
|
||||
|
||||
241 --> 242
|
||||
242 --> 243
|
||||
end
|
||||
|
||||
classDef completed fill:#90EE90,stroke:#228B22
|
||||
classDef inProgress fill:#FFD700,stroke:#DAA520
|
||||
classDef open fill:#ADD8E6,stroke:#4682B4
|
||||
classDef blocked fill:#FFB6C1,stroke:#DC143C
|
||||
|
||||
class 241 completed
|
||||
class 242 inProgress
|
||||
class 243 open
|
||||
```
|
||||
|
||||
## Expected Output
|
||||
|
||||
```
|
||||
Sprint Diagram: Sprint 4 - Commands
|
||||
===================================
|
||||
|
||||
```mermaid
|
||||
flowchart TD
|
||||
subgraph batch1["Batch 1 - No Dependencies"]
|
||||
241["#241: sprint-diagram<br/>projman"]
|
||||
242["#242: confidence threshold<br/>pr-review"]
|
||||
244["#244: data-quality<br/>data-platform"]
|
||||
247["#247: chart-export<br/>viz-platform"]
|
||||
250["#250: dependency-graph<br/>contract-validator"]
|
||||
251["#251: changelog-gen<br/>doc-guardian"]
|
||||
254["#254: config-diff<br/>config-maintainer"]
|
||||
256["#256: cmdb-topology<br/>cmdb-assistant"]
|
||||
end
|
||||
|
||||
subgraph batch2["Batch 2 - After Batch 1"]
|
||||
243["#243: pr-diff<br/>pr-review"]
|
||||
245["#245: lineage-viz<br/>data-platform"]
|
||||
248["#248: color blind<br/>viz-platform"]
|
||||
252["#252: doc-coverage<br/>doc-guardian"]
|
||||
255["#255: linting<br/>config-maintainer"]
|
||||
257["#257: change-audit<br/>cmdb-assistant"]
|
||||
end
|
||||
|
||||
subgraph batch3["Batch 3 - Final"]
|
||||
246["#246: dbt-test<br/>data-platform"]
|
||||
249["#249: responsive<br/>viz-platform"]
|
||||
253["#253: stale-docs<br/>doc-guardian"]
|
||||
258["#258: IP conflict<br/>cmdb-assistant"]
|
||||
end
|
||||
|
||||
batch1 --> batch2
|
||||
batch2 --> batch3
|
||||
|
||||
classDef completed fill:#90EE90,stroke:#228B22
|
||||
classDef inProgress fill:#FFD700,stroke:#DAA520
|
||||
classDef open fill:#ADD8E6,stroke:#4682B4
|
||||
|
||||
class 241,242 completed
|
||||
class 243,244 inProgress
|
||||
```
|
||||
|
||||
## Status Legend
|
||||
|
||||
| Status | Color | Description |
|
||||
|--------|-------|-------------|
|
||||
| Completed | Green | Issue closed |
|
||||
| In Progress | Yellow | Currently being worked on |
|
||||
| Open | Blue | Ready to start |
|
||||
| Blocked | Red | Waiting on dependencies |
|
||||
|
||||
## Diagram Types
|
||||
|
||||
### Default: Dependency Flow
|
||||
Shows how issues depend on each other with arrows indicating blockers.
|
||||
|
||||
### Batch View (--batch)
|
||||
Groups issues by execution batch for parallel work visualization.
|
||||
|
||||
### Plugin View (--by-plugin)
|
||||
Groups issues by plugin for component-level overview.
|
||||
|
||||
## When to Use
|
||||
|
||||
- **Sprint Planning**: Visualize scope and dependencies
|
||||
- **Daily Standups**: Show progress at a glance
|
||||
- **Documentation**: Include in wiki pages
|
||||
- **Stakeholder Updates**: Visual progress reports
|
||||
|
||||
## Integration
|
||||
|
||||
The generated Mermaid diagram can be:
|
||||
- Pasted into GitHub/Gitea issues
|
||||
- Rendered in wiki pages
|
||||
- Included in PRs for context
|
||||
- Used in sprint retrospectives
|
||||
|
||||
## Example
|
||||
|
||||
```
|
||||
User: /sprint-diagram
|
||||
|
||||
Generating sprint diagram...
|
||||
|
||||
Milestone: Sprint 4 - Commands (18 issues)
|
||||
Fetching dependencies...
|
||||
Building diagram...
|
||||
|
||||
```mermaid
|
||||
flowchart LR
|
||||
241[sprint-diagram] --> |enables| 242[confidence]
|
||||
242 --> 243[pr-diff]
|
||||
|
||||
style 241 fill:#90EE90
|
||||
style 242 fill:#ADD8E6
|
||||
style 243 fill:#ADD8E6
|
||||
```
|
||||
|
||||
Open: 16 | In Progress: 1 | Completed: 1
|
||||
```
|
||||
Reference in New Issue
Block a user