Generate structured task completion reports in two synchronized formats - a concise chat summary and a detailed documentation file. Use this skill when completing tasks that require formal documentation, audit trails, or reproducible records of work performed. Particularly useful for specification-driven development, API implementation, or any workflow requiring both user-facing summaries and comprehensive technical documentation.
This skill provides a standardized protocol for generating task completion reports that serve dual purposes: immediate user communication and long-term documentation.
Invoke this skill upon successful completion of any tasks
Generate both outputs synchronously upon task completion:
Deliver a concise, user-friendly summary directly to the chat interface:
Create a comprehensive Markdown file with full implementation details:
reports/{specifications_document_name}/task_{task_number}_completed.mdreports/ast-transcription-api/task_10_1_completed.mdreferences/report-template.mdStructure the detailed documentation file with these sections in order:
Chat Interface Output
Task Overview
Execution Timeline
Inputs/Outputs
Error Handling
Final Status
Before finalizing reports, verify:
Create the reports/ directory structure as needed:
reports/
├── {specification-name-1}/
│ ├── task_1_completed.md
│ ├── task_2_completed.md
│ └── task_3_completed.md
└── {specification-name-2}/
└── task_1_completed.md
Follow these patterns strictly:
ast-transcription-api)task_{number}_completed.md or task_{number}_{subnumber}_completed.mdtask_1_completed.md, task_10_1_completed.mdAfter implementing a REST API endpoint:
Chat: "Successfully implemented the /api/users endpoint with GET and POST methods. Returns user list with pagination, creates new users with validation. All tests passing."
File: reports/user-management-api/task_3_completed.md containing:
After completing a database schema update:
Chat: "Database migration completed successfully. Added 'preferences' table with foreign key to users. Backfilled data for 1,247 existing users. No downtime required."
File: reports/user-preferences-feature/task_2_1_completed.md containing:
For detailed template structure with placeholders, see references/report-template.md.