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