Project Status Report

Generate comprehensive project health and status reports for rapid developer onboarding.

When to Use

• Session start: Get full project context before deciding what to work on
• Mid-session check: Quick health check without session overhead
• Context switching: Rapid re-immersion after days away from project
• Before major changes: Understand current state before refactoring

What It Reports

Priority 1: Health Indicators 🏥

• Test status (passing/failing)
• Linting errors
• Coverage metrics
• Build status
• Context health (from claude-context-manager if available)

Priority 2: Git Status 📍

• Current branch
• Uncommitted changes
• Sync status with remote
• Active branches (recent activity)

Priority 3: Recent Session 📖

• Last checkpoint summary
• What was accomplished
• Where you left off

Priority 4: Open Work Items 📋

• Session objectives
• TODOs in code
• FIXMEs in code

Priority 5: Backlog 📚

• Planned features (if configured)
• Technical debt items

Priority 6: AI Suggestions 💡

• Recommended next actions based on project state
• Effort estimates
• Priority guidance

Usage

Standalone

python scripts/report.py

From Claude Code

/project-report

Programmatic

from report import ReportGenerator

generator = ReportGenerator()
report = generator.generate()
print(report)

Output Format

Markdown report with sections in priority order. Designed for quick scanning with emojis and clear hierarchy.

Integration

Used by session-management: Automatically invoked during /session-start to provide onboarding context.

Standalone utility: Can be run independently without session management.

Configuration

No configuration required. Automatically detects:

• Git repository
• Test frameworks (pytest)
• Session state (.sessions/ directory)
• CCMP plugin state (.ccmp/state.json)

Best Practices

Quick check: Run /project-report anytime you need project overview

Before work: Check health indicators before starting new work

After context switch: First command after returning to project

Share with team: Generate report for handoffs or status updates

See Also

• session-management: Uses this skill for session start onboarding
• claude-context-manager: Provides context health metrics