graduate

Graduating common mistakes moves an entry from common-mistakes.md into a date-stamped Markdown file under docs/learnings/. This transfers the item into a permanent knowledge base record while removing it from the original active list.

Archiving workflow mistakes into learnings documentation is handled by selecting an item by number or keyword, writing a kebab-case slug file, and deleting the original entry. This ensures your learnings repository stays organized without manual file creation.

Graduating a learning works by reading .claude/rules/common-mistakes.md, matching the target item via number or keyword, generating a YYYY-MM-DD-<slug>.md file in docs/learnings/, and removing the entry from the source list.

You need a .claude/rules/common-mistakes.md file containing your active items and a docs/learnings/ directory for output. The process validates this task flow by reading the source file before writing the formatted Markdown record.

You can select entries to graduate from a common mistakes list using either an item number or a keyword. The tool matches your input against the current items in common-mistakes.md before moving the matched entry to the learnings directory.

When you move a common mistake to permanent learnings, the original entry is removed from common-mistakes.md. The operation logs a summary to confirm the item was successfully transferred and deleted from the active list.