Status Reporting Skill
Overview
Generate comprehensive status reports showing progress across all roles (Architect, Orchestrator, Integrator).
Prerequisites
- •AI Maestro messaging system must be running for role queries
- •GitHub CLI (
gh) must be installed for issue/PR status - •Session memory files must be accessible
- •
docs_dev/reports/directory must exist
Instructions
- •Determine the type of report needed (quick status, progress, handoff summary, blocker)
- •Query each role via AI Maestro for their current status
- •Query GitHub for issue and PR status using
ghCLI - •Read session memory files for context
- •Compile all information into unified report format
- •Save report to
docs_dev/reports/status-{date}.md - •Present formatted report to user
Report Types
| Type | Frequency | Content |
|---|---|---|
| Quick Status | On demand | Current state summary |
| Progress Report | Daily/Weekly | Work completed, in progress, blocked |
| Handoff Summary | On transition | What was handed to whom |
| Blocker Report | As needed | What's blocking progress |
Report Generation Workflow
- •Query each role via AI Maestro for current status
- •Query GitHub for issue/PR status
- •Read session memory files
- •Compile into unified report
- •Format for user consumption
Output
| Report Type | Format | Location |
|---|---|---|
| Quick Status | Markdown summary | docs_dev/reports/status-{date}.md |
| Progress Report | Markdown with sections | docs_dev/reports/progress-{date}.md |
| Handoff Summary | Markdown with task lists | docs_dev/reports/handoff-{date}.md |
| Blocker Report | Markdown with blocker details | docs_dev/reports/blockers-{date}.md |
Report Sections
Quick Status Format
- •Current active task
- •% complete estimate
- •Next milestone
- •Blockers (if any)
Progress Report Format
- •Period covered
- •Tasks completed (with evidence)
- •Tasks in progress (with estimates)
- •Tasks blocked (with reasons)
- •Tasks added (new scope)
- •Risks identified
Output Location
Reports saved to: docs_dev/reports/status-{date}.md
Examples
Example 1: Quick Status Report
markdown
## Quick Status - 2025-01-30 **Current Active Task**: Implementing user authentication **% Complete**: 65% **Next Milestone**: Complete login endpoint by EOD **Blockers**: None
Example 2: Progress Report
markdown
## Progress Report - Week of 2025-01-27 ### Period Covered 2025-01-27 to 2025-01-30 ### Tasks Completed - [EAA] Auth system design approved (PR #45) - [EOA] Login endpoint implemented (5 files) - [EIA] Code review completed, 2 issues fixed ### Tasks In Progress - [EOA] Logout endpoint (in progress) - [EAA] Session management design (in progress) ### Tasks Blocked - [EOA] Password reset - blocked by email service config ### Risks Identified - Email service integration may delay password reset feature
Error Handling
| Error | Cause | Resolution |
|---|---|---|
| Agent not responding | Agent unreachable | Mark as "status unknown" and continue |
| GitHub API failure | Auth or rate limit | Use cached data, note staleness |
| Memory file not found | Not initialized | Report "no session data available" |
| Report directory missing | First report | Create docs_dev/reports/ automatically |
Resources
- •eama-role-routing SKILL - Role status queries
- •eama-approval-workflows SKILL - Approval status
- •eama-shared SKILL - Session memory access
Checklist
Copy this checklist and track your progress:
- • Determine the type of report needed (quick status, progress, handoff summary, blocker)
- • Verify AI Maestro messaging system is running
- • Verify GitHub CLI is installed and authenticated
- • Query each role via AI Maestro for current status
- • Query GitHub for issue and PR status
- • Read session memory files for context
- • Compile all information into unified report format
- • Create
docs_dev/reports/directory if it doesn't exist - • Save report to
docs_dev/reports/status-{date}.md - • Present formatted report to user