Progress Block Templates

Templates for sprint progress visualization during execution.

Version: 1.0.0 Created: 2026-01-28

Sprint Progress Block

Display during sprint-start and sprint-status commands:

┌─ Sprint Progress ────────────────────────────────────────────────┐
│  Sprint [N]: [Title]                                              │
│  ████████████░░░░░░░░░░░░░░░░░░ [XX]% complete                   │
│                                                                   │
│  ✅ Done: [n]    ⏳ Active: [n]    ⬚ Pending: [n]                 │
│                                                                   │
│  Current:                                                         │
│    #[num] ⏳ [Issue title truncated to fit...]                    │
│    #[num] ⏳ [Issue title truncated to fit...]                    │
└──────────────────────────────────────────────────────────────────┘

Progress Bar Calculation

Width: 30 characters

def render_progress_bar(completed: int, total: int) -> str:
    if total == 0:
        percentage = 0
    else:
        percentage = (completed / total) * 100
    
    filled = round(percentage * 30 / 100)
    empty = 30 - filled
    
    bar = '█' * filled + '░' * empty
    return f"{bar} {percentage:.0f}% complete"

Examples:

Completed	Total	Percentage	Bar
0	10	0%	`░░░░░░░░░░░░░░░░░░░░░░░░░░░░░░ 0%`
3	10	30%	`█████████░░░░░░░░░░░░░░░░░░░░░ 30%`
5	10	50%	`███████████████░░░░░░░░░░░░░░░ 50%`
8	10	80%	`████████████████████████░░░░░░ 80%`
10	10	100%	`██████████████████████████████ 100%`

Full Progress Block Example

┌─ Sprint Progress ────────────────────────────────────────────────┐
│  Sprint 6: Visual Branding Overhaul                               │
│  ████████████░░░░░░░░░░░░░░░░░░ 40% complete                     │
│                                                                   │
│  ✅ Done: 4    ⏳ Active: 2    ⬚ Pending: 4                       │
│                                                                   │
│  Current:                                                         │
│    #271 ⏳ Implement header component                             │
│    #272 ⏳ Update agent instructions                              │
└──────────────────────────────────────────────────────────────────┘

When to Display Progress Block

Event	Display Progress Block
`/sprint-start` begins	Yes - initial state
Issue completed	Yes - updated counts
`/sprint-status` called	Yes - current state
Before execution prompt	Yes - show what's active
Batch complete	Yes - show batch transition
`/sprint-close`	Yes - final summary

Batch Progress Display

During parallel execution, show batch progress:

┌─ Sprint Progress ────────────────────────────────────────────────┐
│  Sprint 6: Visual Branding Overhaul                               │
│  ████████████████████░░░░░░░░░░ 67% complete                     │
│                                                                   │
│  ✅ Done: 4    ⏳ Active: 2    ⬚ Pending: 0                       │
│                                                                   │
│  Batch 2 of 3:                                                    │
│    #273 ⏳ Update projman commands (75%)                          │
│    #274 ⏳ Add progress block to orchestrator (50%)               │
│                                                                   │
│  ✅ Batch 1 complete | ⬚ Batch 3 waiting                          │
└──────────────────────────────────────────────────────────────────┘

Compact Progress (For Inline Updates)

When space is limited or for inline status:

Sprint 6: ████████████░░░░░░░░░░░░░░░░░░ 40% (4/10) | ⏳ #271, #272

Issue Status Line Format

For current/active issues in progress block:

#[issue_number] [status_icon] [title (max 50 chars)]

Status icons:

⏳ - In progress
🚫 - Blocked
⬚ - Pending (waiting in queue)

Title truncation: Truncate at 50 characters with ... if longer.

Integration with Orchestrator Agent

Add this section to plugins/projman/agents/orchestrator.md:

### Sprint Progress Block

**Display progress block after header during sprint execution.**

**When to Display:**
- At start of sprint-start command
- After each issue completion
- Before generating next execution prompt
- When user requests status
- In final sprint summary

**Data Sources:**
- `list_issues(milestone=current)` - Get all sprint issues
- `get_milestone(milestone_id)` - Get sprint metadata
- Issue labels for status (Status/In-Progress, etc.)

**Calculation:**
- Total: Count all issues in milestone
- Done: Count closed issues
- Active: Count issues with Status/In-Progress label
- Pending: Total - Done - Active

See: [[branding/progress-templates]] for format specification.

Integration with sprint-status Command

Add this section to plugins/projman/commands/sprint-status.md:

## Visual Output

Display header followed by progress block:

[Header from branding/header-templates]

[Progress block from branding/progress-templates]

Then show detailed breakdown (existing format).

branding/visual-spec - Central visual specification
branding/plugin-registry - Plugin icons and display names
branding/header-templates - Copy-paste header templates