project-status-report
Generate comprehensive project health and status reports for rapid developer onboarding. Use when starting sessions, checking project health mid-work, or needing overview of git status, open work items, and suggested next actions.
When & Why to Use This Skill
The Project Status Report skill is a powerful utility designed to automate the generation of comprehensive project health and status overviews. It streamlines developer workflows by consolidating critical information—including git status, test results, linting errors, and open work items—into a single, actionable markdown report. This tool is essential for maintaining project momentum, ensuring code quality, and facilitating rapid context re-immersion for developers and teams.
Use Cases
- Rapid Developer Onboarding: New team members can instantly understand the project's current state, active branches, and suggested next actions to start contributing immediately.
- Context Switching & Re-immersion: Developers returning to a project after a break can quickly catch up on recent accomplishments, pending TODOs, and the last session's progress.
- Pre-Refactoring Health Check: Provides a high-level validation of test passing rates and build status to ensure a stable baseline before initiating major architectural changes.
- Automated Status Reporting: Generates structured, easy-to-read summaries for team handoffs or daily standups, highlighting technical debt and priority work items.
| name | project-status-report |
|---|---|
| description | Generate comprehensive project health and status reports for rapid developer onboarding. Use when starting sessions, checking project health mid-work, or needing overview of git status, open work items, and suggested next actions. |
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