whip-lesson-learn

name	whip-lesson-learn
description	Create a real-world whip case-study or lessons-learned markdown file under .whip/lesson-learn/<file-name>.md. Use when the user wants to capture an actual whip run, prompts, decisions, IRC coordination, outcomes, or lessons learned.
user_invocable	true

Use this skill when the user wants to turn a real whip run into a reusable case study, lesson learned, postmortem, or discussion draft.

Goal

Create or update a markdown file at:

.whip/lesson-learn/<file-name>.md

After writing it, tell the user:

• the final path
• whether a new file was created or an existing file was updated
• a short summary of what was captured

Language

• If the user explicitly requests a language, write in that language.
• Otherwise write in the language the user is currently using.
• Do not mix languages except for literal commands, file paths, URLs, issue numbers, PR numbers, and short quoted fragments.

Prompt language rule

• If the document language and the original user prompt language differ, translate the prompt into the document language while preserving intent and important literals such as $whip-plan, $whip-start, URLs, branch names, and issue numbers.
• Only keep the original-language prompt verbatim if the user explicitly asks for verbatim preservation.

Path and naming

• Always write under .whip/lesson-learn/.
• Use the user-provided file name when given.
• If the user does not provide a file name, derive one as YYYY-MM-DD-<short-case-name>.md.
• Use lowercase hyphen-case and keep it concise.
• Create the directory if it does not exist.
• If the same case already exists, update it instead of creating a duplicate unless the user asks for a new file.

Required structure

Use these sections, translated into the chosen output language:

1. Used tools / 사용한 도구
2. Actual user prompts / 실제 유저가 쳤던 프롬프트
3. What the AI judged and executed / AI 가 판단하고 실행한 영역
4. What actually happened / 실제로 진행한 방향
5. IRC coordination highlights / IRC 로 실제로 중요했던 대화
6. Results and lessons learned / 결과와 레슨런

If IRC did not matter for the case, omit section 5.

Workflow

1. Gather concrete artifacts from the run:
   • user prompts
   • tools and backends used
   • worktree, branch, and PR topology
   • review findings
   • IRC messages that changed decisions
   • final merge, cleanup, and issue-closing results
2. Preserve literal commands and identifiers exactly.
3. Distinguish initial plan from final corrected execution if review changed the direction.
4. Include only IRC messages that materially changed decisions; do not dump full transcripts.
5. Keep operator mistakes and recovery steps when they are part of the lesson.
6. Create or update the markdown file.
7. Tell the user the path and a concise summary.

Writing rules

• Prefer factual chronology over promotional tone.
• Keep the file concrete; this is a case study, not a generic manual.
• Use plain #123 issue and PR references, not backticked issue numbers, when GitHub linking is useful.
• Keep secrets, tokens, and sensitive values out of the document.
• If the user wants a public discussion post, write the local .whip/lesson-learn/ file first, then adapt from there.

Default outline

## Used tools

- ...

## Actual user prompts

> ...

## What the AI judged and executed

- ...

## What actually happened

### 1. ...

- ...

## IRC coordination highlights

- ...

## Results and lessons learned

### Final result

- ...

### Lessons learned

- ...