Refine Skill

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

Instructions

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

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

• docs/validation.md

• docs/enterprise.md

• docs/autonomous-mode.md

• Any skills that were invoked

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

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

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