Initial commit

skills/project-status-report/SKILL.md

@@ -0,0 +1,106 @@
+---
+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
+
+```bash
+python scripts/report.py
+```
+
+### From Claude Code
+
+```
+/project-report
+```
+
+### Programmatic
+
+```python
+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