From 0b8f830921c5716baa235eb00a1dc7d1bd496dbb Mon Sep 17 00:00:00 2001 From: Hugo Nijhuis Date: Wed, 31 Dec 2025 15:20:32 +0100 Subject: [PATCH] Add /retro command for self-learning workflow MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Captures learnings from completed AI-assisted work and creates improvement issues in the AI repo. Creates a feedback loop where friction points and insights get tracked as actionable issues. 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 --- CLAUDE.md | 1 + commands/retro.md | 64 +++++++++++++++++++++++++++++++++++++++++++++++ 2 files changed, 65 insertions(+) create mode 100644 commands/retro.md diff --git a/CLAUDE.md b/CLAUDE.md index 8f346b8..df52a07 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -45,6 +45,7 @@ tea logins add --name flowmade --url https://git.flowmade.one --token ` | Review PR with diff and comments | | `/create-issue` | Create single or batch issues | +| `/retro` | Capture learnings from completed work, create improvement issues | ## Usage diff --git a/commands/retro.md b/commands/retro.md new file mode 100644 index 0000000..cc884b1 --- /dev/null +++ b/commands/retro.md @@ -0,0 +1,64 @@ +--- +description: Run a retrospective on completed work. Captures learnings and creates improvement issues in the AI repo. +argument-hint: [task-description] +--- + +# Retrospective + +Capture learnings from completed AI-assisted work to improve the workflow. + +## Process + +1. **Gather context**: If $1 is provided, use it as the task description. Otherwise, ask the user what task was just completed. + +2. **Reflect on the work**: Ask the user (or summarize from conversation context if obvious): + - What friction points were encountered? + - What worked well? + - Any specific improvement ideas? + +3. **Analyze and categorize**: Group learnings into: + - **Prompt improvements**: Better instructions for commands/skills + - **Missing capabilities**: New commands or skills needed + - **Tool issues**: Problems with tea CLI, git, or other tools + - **Context gaps**: Missing documentation or skills + +4. **Generate improvement issues**: For each actionable improvement, create an issue in the AI repo using: + +```bash +tea issues create -r flowmade-one/ai --title "" --description "<body>" +``` + +## Issue Format + +Use this structure for retrospective issues: + +```markdown +## Context +What task triggered this learning (brief). + +## Problem / Observation +What was the friction point or insight. + +## Suggested Improvement +Concrete, actionable change to make. + +## Affected Files +- commands/xxx.md +- skills/xxx/SKILL.md +``` + +## Labels + +Add appropriate labels: +- `retrospective` - Always add this +- `prompt-improvement` - For command/skill text changes +- `new-feature` - For new commands/skills +- `bug` - For things that are broken + +## Guidelines + +- Be specific and actionable - vague issues won't get fixed +- One issue per improvement (don't bundle unrelated things) +- Reference specific commands/skills when relevant +- Keep issues small and focused +- Skip creating issues for one-off edge cases that won't recur