markdown-report

Markdown Report Skill

Gerar relatorios estruturados e profissionais em Markdown.

Docs Location (OBRIGATORIO)

PROJECT_ROOT="$(git rev-parse --show-toplevel 2>/dev/null || pwd)"
[ "$PROJECT_ROOT" = "$HOME/Claude" ] && { echo "Erro: workspace raiz, nao projeto"; exit 1; }
DEST="$PROJECT_ROOT/docs/{reports|diagnosticos}/<slug>.md"

Decidir entre reports/ (executivo, sumario, sprint review) vs diagnosticos/ (tecnico, RCA, analise de bug). NUNCA salvar em ~/Claude/docs/ — bloqueado por hook. Detalhes: ~/Claude/.claude/shared/patterns/docs-location.md.

Estrutura Padrao

---
title: "Report Title"
author: "Author Name"
date: "2026-03-26"
version: "1.0"
status: "draft|review|final"
---

# Report Title

> One-line summary of the report purpose.

## Table of Contents

- [Section 1](#section-1)
- [Section 2](#section-2)
- [Appendix](#appendix)

---

## Section 1

Content here.

## Section 2

Content here.

---

## Appendix

Supporting data, references, raw data.

Templates por Tipo

Relatorio Tecnico

# [Titulo] — Technical Report

**Date**: YYYY-MM-DD | **Author**: Name | **Status**: Draft

## Executive Summary
- Key finding 1
- Key finding 2
- Recommendation

## Context
Why this analysis was needed.

## Methodology
How the analysis was conducted.

## Findings

### Finding 1: [Title]
**Severity**: High/Medium/Low
**Impact**: Description
**Evidence**: Data/screenshots

### Finding 2: [Title]
...

## Recommendations

| # | Action | Priority | Effort | Impact |
|---|--------|----------|--------|--------|
| 1 | Do X   | P0       | Low    | High   |
| 2 | Do Y   | P1       | Medium | Medium |

## Next Steps
- [ ] Action item 1
- [ ] Action item 2

## References
- [Link 1](url)
- [Link 2](url)

Relatorio Executivo

# [Titulo] — Executive Summary

**Period**: Month YYYY | **Prepared for**: Stakeholder

## Highlights
- Metric 1: **+15%** vs last period
- Metric 2: **3 of 5** milestones completed
- Risk: [brief description]

## Key Metrics

| Metric | Target | Actual | Status |
|--------|--------|--------|--------|
| Revenue | $100K | $115K | On Track |
| Users | 1000 | 850 | At Risk |

## Decisions Needed
1. **[Decision 1]**: Options A vs B — recommend A because...
2. **[Decision 2]**: Approve budget for...