tools-only /project-report
Generate a project status report by analysing tasks, meetings, decisions, risks, and timeline data from the vault. Uses four parallel agents to gather different project dimensions simultaneously.
When to Use This Skill
- Preparing regular project status updates
- Creating reports for steering committees
- Summarising project health for stakeholders
- Generating RAG (Red/Amber/Green) status reports
- End-of-sprint or end-of-phase reports
Usage
/project-report <project-name> [--period weekly|monthly|custom] [--format rag|detailed|exec]
Parameters
| Parameter | Description | Required |
|---|---|---|
project |
Project name or path to project note | Yes |
--period |
Reporting period (default: weekly) |
No |
--format |
Report format (default: rag) |
No |
Instructions
Phase 1: Identify Project Context
- Find the project note — Search for the project by name
- Identify related content:
- Tasks linked to this project
- Meetings mentioning this project
- ADRs related to this project
- Workstreams under this project
- Determine reporting period — Calculate date range
Phase 2: Parallel Data Gathering — Agent Team
Launch four agents simultaneously using the Task tool.
Agent 1: Task Status Agent (Haiku) Task: Analyse task status for the project
- Find all tasks linked to or mentioning the project
- Categorise by status: completed, in-progress, blocked, not started
- Calculate completion percentage
- Identify overdue tasks
- Track velocity (tasks completed per week/sprint) Return: Task summary with completion metrics and burndown data
Agent 2: Meeting and Decision Agent (Haiku) Task: Extract project-relevant meetings and decisions
- Find meetings within the reporting period that mention the project
- Extract decisions made in those meetings
- Identify action items and their status (complete/pending)
- Find ADRs created or modified in the period Return: Meeting summary, decision log, and pending actions
Agent 3: Risk and Issue Agent (Sonnet) Task: Assess project risks and issues
- Search for risks mentioned in project notes, meetings, or tasks
- Categorise: risk (potential) vs issue (realised)
- Score risks: probability x impact
- Identify new risks raised in the period
- Check mitigation status for known risks
- Assess overall project health (RAG status) Return: Risk/issue register with RAG assessment
Agent 4: Timeline Agent (Haiku) Task: Assess timeline and milestone progress
- Extract project milestones and deadlines
- Check which milestones were hit/missed in the period
- Calculate schedule variance (ahead/behind/on track)
- Identify upcoming milestones and their readiness
- Flag dependencies that could affect timeline Return: Timeline assessment with milestone status and forecast
Phase 3: Synthesise Project Report
Combine agent results tailored to the requested format:
RAG format: Concise status with colour-coded indicators Detailed format: Full analysis with all dimensions Exec format: One-page summary for senior stakeholders
Output Format
# Project Status Report: <Project Name>
**Period:** <date range> | **Date:** YYYY-MM-DD | **Status:** 🟢/🟡/🔴
## RAG Summary
| Dimension | Status | Trend | Comment |
|------------|--------|-------|----------------------------------|
| Scope | 🟢 | → | On track, no scope changes |
| Schedule | 🟡 | ↓ | 1 milestone at risk |
| Budget | 🟢 | → | Within budget |
| Risk | 🟡 | → | 2 high risks being mitigated |
| Quality | 🟢 | ↑ | Test coverage improving |
## Key Highlights
- **Completed:** <Major achievement this period>
- **In Progress:** <Key items being worked on>
- **At Risk:** <Items that need attention>
## Task Progress
| Metric | This Period | Overall |
|---------------------|-------------|---------|
| Completed | X | X/Y |
| In Progress | X | — |
| Blocked | X | — |
| Overdue | X | — |
| **Completion %** | — | **X%** |
## Milestones
| Milestone | Due Date | Status | Notes |
|--------------------------|------------|-----------|---------------------|
| <Milestone 1> | YYYY-MM-DD | Complete | |
| <Milestone 2> | YYYY-MM-DD | On Track | |
| <Milestone 3> | YYYY-MM-DD | At Risk | Dependency on X |
## Decisions Made
| Decision | Date | Impact |
|-----------------------------|------------|---------------------------|
| <Decision> | YYYY-MM-DD | <What it means> |
## Risks and Issues
### Active Risks
| Risk | Prob | Impact | Score | Mitigation | Owner |
|-------------------------|------|--------|-------|---------------------|----------|
| <Risk> | X/5 | X/5 | X/25 | <Action> | <Name> |
### Active Issues
| Issue | Severity | Impact | Resolution |
|-------------------------|----------|-----------------------|----------------------|
| <Issue> | High | <What's affected> | <Resolution plan> |
## Actions and Next Steps
| Action | Owner | Due Date | Status |
|---------------------------------|------------|-------------|---------|
| <Action> | <Name> | YYYY-MM-DD | Pending |
## Next Period Focus
1. <Priority 1>
2. <Priority 2>
3. <Priority 3>
Examples
Example 1: Weekly RAG Report
/project-report "Order Migration" --period weekly --format rag
Example 2: Monthly Detailed Report
/project-report "Platform Modernisation" --period monthly --format detailed
Example 3: Executive Summary
/project-report "Data Platform" --format exec
Invoke with: /project-report <project-name> to generate a project status report from vault data