dev-reports

Developer reporting skill for work documentation and communication. Use when writing journals, devlogs, status updates (22A/22B), progress reports, or documenting development work. Generates reports from git history or manual input.

⭐2stars🔀1forks📁View on GitHub🕐Updated Jan 2, 2026⬇️1downloads

When & Why to Use This Skill

The dev-reports skill is a specialized Claude agent tool designed to automate the creation of professional development documentation and work logs. By transforming git commit history or manual notes into structured formats like PPP (Progress, Plans, Problems) updates, devlogs, and journals, it bridges the communication gap between technical execution and project management, ensuring consistent and high-quality reporting with minimal manual effort.

Use Cases

  • Automated Daily Standups: Quickly generate a structured summary of the day's technical work by pulling data directly from git commit history to prepare for team syncs.
  • Formal Status Reporting: Create standardized 22A (Full) or 22B (Condensed) status reports to communicate project progress, upcoming plans, and critical blockers to stakeholders and leadership.
  • Technical Knowledge Retention: Write narrative-style devlogs that document the context behind architectural decisions and complex refactors, building a searchable history of institutional knowledge.
  • Sprint Retrospectives: Compile a comprehensive journal of work completed during a sprint to facilitate data-driven retrospective meetings and performance reviews.
namedev-reports
descriptionDeveloper reporting skill for work documentation and communication. Use when writing journals, devlogs, status updates (22A/22B), progress reports, or documenting development work. Generates reports from git history or manual input.

Dev Reports

Document and communicate development work. From git commits to polished reports.

Report Types

This skill supports multiple report formats:

Type When to Use Trigger Phrases
Git Journal Summarize work from commits "journal this", "journal today's work"
Devlog Narrative work documentation "devlog", "write a devlog"
Status (22A) Full Progress/Plans/Problems "22A", "PPP update", "full status"
Status (22B) Condensed status update "22B", "quick status"

How to Use This Skill

  1. Identify the report type from the request
  2. Load the appropriate template from examples/:
    • Git journal → Read examples/github-journal.md
    • Devlog → Read examples/devlog.md
    • Status (full) → Read examples/form-22a.md
    • Status (condensed) → Read examples/form-22b.md
  3. Follow the workflow in that template
  4. Generate the report in the specified format

Quick Reference

Request Template
"Journal this", "journal the last 4 hours" examples/github-journal.md
"Write a devlog", "devlog update" examples/devlog.md
"22A", "PPP update", "progress report" examples/form-22a.md
"22B", "quick status" examples/form-22b.md

Report Purposes

Git Journal

Generates structured journal entries from git commit history. Great for:

  • End of day summaries
  • Sprint retrospectives
  • Documenting refactors or features

Devlog

Narrative-style work logs with context and decisions. Great for:

  • Explaining technical decisions
  • Sharing learnings with the team
  • Building institutional knowledge

Status Updates (22A/22B)

Structured Progress/Plans/Problems format. Great for:

  • Team standups
  • Leadership updates
  • Weekly reports

Part of the dev-* Family

Skill Purpose
dev-inquiry Technical investigation and decision-making
dev-reason Problem-solving and debugging (future)
dev-reports Work documentation and communication