Skip to main content

Board & Stats

Get instant visibility into your project's health with LeanSpec's board and stats commands.

Board Command​

Visual kanban view of your specs:

lean-spec board

Shows specs organized by status columns:

  • 📋 Planned - Specs ready to start
  • 🚧 In Progress - Active work
  • ✅ Complete - Finished specs

Project Completion Summary​

The board includes a project completion summary:

  • Total specs count
  • Distribution by status (planned, in-progress, complete)
  • Completion percentage
  • Active work in progress

Filtering​

Filter the board view:

# Show only high priority specs
lean-spec board --priority high

# Show specs with specific tag
lean-spec board --tag feature

# Combine filters
lean-spec board --priority high --tag api

Stats Command​

Quick project metrics:

lean-spec stats

Shows:

  • Total specs count
  • Status breakdown (planned, in-progress, complete)
  • Priority distribution
  • Most common tags
  • Recent activity summary

Full Analytics​

Get detailed analytics:

lean-spec stats --full

Provides comprehensive project insights:

  • Detailed status metrics
  • Priority breakdown
  • Tag frequency analysis
  • Completion trends
  • Average time in each status
  • Health indicators

Workflows​

Daily Standup​

# Quick project overview
lean-spec board

# See what's in progress
lean-spec board --status in-progress

# Check high priority items
lean-spec board --priority high

Sprint Planning​

# Review project health
lean-spec stats --full

# See what's ready to start
lean-spec board --status planned

# Check capacity
lean-spec stats

Weekly Review​

# Overall project metrics
lean-spec stats --full

# Review completed work
lean-spec board --status complete

# Identify bottlenecks
lean-spec board --status in-progress

Project Health Indicators​

The board and stats commands help identify:

⚠️ Warning Signs​

  • Too many in-progress specs (focus issues)
  • Old specs without updates (stale work)
  • High percentage of planned specs (execution gap)
  • Specs with unmet dependencies (check with lean-spec deps)

✅ Healthy Signals​

  • Steady completion rate
  • Balanced status distribution
  • Active recent updates
  • Clear priority focus

Best Practices​

  1. Check daily - Start your day with lean-spec board
  2. Review weekly - Use lean-spec stats --full for trends
  3. Limit WIP - Keep in-progress specs under control
  4. Update regularly - Keep status current with lean-spec update
  5. Use priorities - Focus on high-priority work first

Tips​

  • Use lean-spec board for visual overview
  • Use lean-spec stats for quick metrics
  • Combine with lean-spec deps to understand dependencies
  • Export stats for reporting (pipe to file or tools)
  • Use filtering to focus on specific areas

Example Output​

📊 LeanSpec Board

📋 Planned (3)
  • 045-new-feature [high] #feature
  • 046-refactor [medium] #tech-debt
  • 047-docs-update [low] #documentation

🚧 In Progress (2)
  • 043-launch [high] #release
  • 044-api-update [high] #feature

Project Completion: 71% (12/17 specs complete)
- 2 in progress, 3 planned, 12 complete

Learning More​