eama-status-reporting
Use when generating status reports showing progress across all roles (Architect, Orchestrator, Integrator). Trigger with status report requests.
SKILL.md
| Name | eama-status-reporting |
| Description | Use when generating status reports showing progress across all roles (Architect, Orchestrator, Integrator). Trigger with status report requests. |
name: eama-status-reporting description: Use when generating status reports showing progress across all roles (Architect, Orchestrator, Integrator). Trigger with status report requests. version: 1.0.0 compatibility: Requires AI Maestro installed. context: fork agent: eama-main user-invocable: true triggers:
- when user asks for status
- when generating progress reports
- when summarizing work across roles
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 |
Note: Blockers are reported to the user IMMEDIATELY when received, not held for the next scheduled status report. Status reports should include a summary of currently blocked tasks and their status (waiting for user, waiting for resource, etc.) but the initial notification always happens immediately.
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
## 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
## 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-session-memory 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