Report

/report — Report to Me

Brief the user as if they are the CEO or product owner. Plain language. Outcomes over output. No technical jargon unless translated into business or user impact.

Context

Today's date: !date +%Y-%m-%d

Config: @_core/config.yaml Processing logic: @_core/PROCESSING.md Preview rules: @.claude/rules/preview-formats.md (when --preview)

Usage

Copy code
/report
/report project-a
/report all
/report project-a --week
/report all --preview
/report project-a --save --preview

Flags

Session Task Progress

Copy code
TaskCreate: "Gather vault signals"
  activeForm: "Reading vault for executive signals..."

TaskCreate: "Translate to impact"
  activeForm: "Translating to business and user impact..."

TaskCreate: "Deliver brief"
  activeForm: "Preparing your briefing..."

Voice & Rules

You are briefing a decision-maker, not an engineer.

Always

• Lead with what matters most to the business
• Explain what changed for users (faster, safer, clearer, unblocked)
• Explain what changed for the business (revenue, risk, speed, cost, trust)
• Use short sentences. No acronyms without plain-English translation
• Quantify when data exists ("3 items shipped", "1 blocker overdue")
• End with what needs their decision or attention

Never

• Stack traces, API names, framework choices, sprint mechanics
• "We merged PR #412" → say what capability that unlocks for users
• "Blocked on Redis" → say "users may see slower checkout until caching is fixed"
• Jira ticket IDs, branch names, implementation details
• Passive voice that hides ownership

Translation examples

Processing Steps

1. Parse Input

• Project: specific id, or all (default: all active projects from config)
• Timeframe: --week or --since

2. Gather Signals

Scan vault (same sources as /progress, different lens):

3. Synthesize Executive Brief

Structure output in this order:

markdownCopy code
# Briefing — {Project or All Projects}
**{Date}** · {Period covered}

## Bottom Line
{2-3 sentences. Most important thing first. What should they walk away knowing?}

## What Users Get (or Will Get)
- {Shipped capabilities in user language}
- {In-progress capabilities — expected value, not ETA unless due date exists}

## Business Impact
- {Revenue, risk reduction, speed, cost, compliance, trust — only what's evidenced in vault}

## What's at Risk
- {Open blockers translated to user/business consequences}
- {Overdue items flagged clearly}

## Decisions Made (Recent)
- {Decision → why it matters to product/business, not technical rationale}

## Needs Your Attention
- {Explicit asks: approve, escalate, decide, unblock}
- {If nothing: "No decisions needed from you this period."}

For --risks-only, output only: Bottom Line, What's at Risk, Needs Your Attention.

4. Deliver

Default: Output to terminal. This is a spoken brief — concise, scannable.

Do not create files unless --save or --preview.

5. Optional: Save

If --save:

• Write markdown to reports/{date}-executive-brief-{project}.md
• Append vault log (action: report)

6. Optional: Preview

If --preview:

• Follow /preview workflow with shell-executive.html
• {{LEAD}} = Bottom Line paragraph
• {{CONTENT}} = remaining sections as HTML
• Output: reports/previews/{date}-executive-brief-{project}.html
• Open in browser unless --no-open passed through

7. Coaching Close

End with one direct line (PM Coach style):

"The one thing I'd escalate: {highest-impact risk or decision}."

Or if clear:

"You're in good shape — keep momentum on {top WIP theme}."

Output Example

Copy code
# Briefing — Project A
**2026-06-29** · Jun 22 – Jun 29

## Bottom Line
Checkout is live for most users, but peak-hour failures are still possible until we resolve the API limit blocker. No decisions needed from you today.

## What Users Get (or Will Get)
- Company sign-in is live — fewer password reset support tickets
- Order shipping alerts are in progress — users will know when packages leave the warehouse

## Business Impact
- Sign-in migration reduces support load and improves enterprise deal readiness
- Shipping alerts expected to cut "where is my order?" contacts

## What's at Risk
- API rate limits may cause checkout failures during promotions — backend team owns fix, due Friday

## Decisions Made (Recent)
- Chose PostgreSQL for billing data — stronger protection for payment records

## Needs Your Attention
- No decisions needed from you this period.

---
The one thing I'd escalate: API rate limit blocker before next marketing push.

Relationship to Other Skills

Empty Vault Handling

If no data in timeframe:

Copy code
No meaningful updates in the last 7 days for {project}.
Suggest: run /daily to start capturing, or widen with --since.

Do not fabricate impact statements.