Refine Skill

Reflect on the current session and update documentation with lessons learned.

Instructions

1. Identify friction: Review what happened in this session:

- Run git diff main...HEAD --stat to see what files were touched - Think about: what was slow, what failed, what required multiple attempts, what information was missing or hard to find

1. Read current docs: Read the docs that were relevant to this session:

- docs/validation.md - docs/enterprise.md - Any skills that were invoked

1. Propose updates: For each piece of friction, decide if it warrants a doc update:

- Missing knowledge: Information you had to discover that should be documented - Wrong guidance: Instructions that led you astray - Missing validation rule: A check that should be in the validation matrix - New pattern: A codebase pattern worth capturing for next time

1. Apply updates: Edit the relevant docs/ files. Keep changes minimal and specific — add only what would have saved time this session.

1. Report: Summarize what was added/changed and why.

Rules

• Only add knowledge confirmed by this session — no speculative additions
• Keep docs concise — add a line or two, not a paragraph
• If a whole new doc is needed, create it in docs/ and add a pointer in CLAUDE.md
• Don't update skills unless a coding pattern was genuinely wrong
• Don't add things Claude already knows — only Windmill-specific knowledge