Agent skill
retrospective-workflow
Systematic post-story retrospective process with automated metrics gathering, structured feedback collection, and Agent Package Manager handoff generation
Install this agent skill to your Project
npx add-skill https://github.com/vineethsoma/agent-packages/tree/main/skills/retrospective-workflow
SKILL.md
Retrospective Workflow
Facilitate structured retrospectives after story completion to capture learnings and drive continuous improvement.
What This Provides
Templates
- retro-process.md: Complete retrospective facilitation guide
- Retro document template with metrics, successes, improvements
- YAML handoff spec template for Agent Package Manager
Scripts
- init-retrospective.sh: Initialize retro directory structure
- gather-retro-metrics.sh: Collect commits, tests, coverage, duration
- validate-retro.sh: Verify completeness before handoff
Prompts
- /facilitate-retrospective: AI-guided retro facilitation
- /create-handoff-spec: Generate YAML for Agent Package Manager
When to Use
Trigger: After story merge to main Owner: Retro Specialist Duration: 30-45 minutes
Quick Start
# 1. Initialize retrospective
./scripts/init-retrospective.sh us-001
# 2. Gather metrics automatically
./scripts/gather-retro-metrics.sh us-001
# 3. Facilitate retro (use prompt)
/facilitate-retrospective us-001
# 4. Validate before handoff
./scripts/validate-retro.sh us-001
Directory Structure
specs/{feature}/stories/us-{number}/retro/
├── retro.md # Retrospective document
└── handoff.yml # Agent Package Manager handoff spec
Integration
Triggers: Feature Lead after story merge
Output: Handoff to Agent Package Manager for primitive updates
Tracks: .memory/retro-log.md for historical learnings
Validation
Retro is complete when:
- ✅ All metrics filled (no [Fill] placeholders)
- ✅ Successes and improvements documented
- ✅ Action items have owners and targets
- ✅ Handoff YAML valid syntax
- ✅ Changes list version bumps required
Recommended Agent Skills
Expand your agent's capabilities with these related and highly-rated skills.
mcp-specialist
MCP server lifecycle management, catalog maintenance, and agent tool provisioning Use when working with management, provision, server, specialist.
agent-package-manager
Agent for creating and managing APM agent packages with kebab-case naming enforcement Use when working with agent, compliance, create, lifecycle, manager.
docker-compose
Docker Compose management for orchestrating MCP servers and multi-container applications. Use when deploying MCP servers, managing container lifecycles, or configuring service dependencies.
vector-search
Semantic search using vector embeddings and similarity metrics. Apply when implementing search with embeddings (OpenAI, Sentence Transformers) or distance-based ranking. Covers cosine similarity, Euclidean distance, dot product, and threshold selection.
secure-development
Security best practices for production applications including PII protection, input validation, SQL injection prevention, XSS mitigation, and secure logging. Apply when handling user data, authentication, or external inputs.
fullstack-expertise
Full-stack development expertise covering backend, frontend, database, DevOps, and testing domains
Didn't find tool you were looking for?