/curate

name: curate
description: Adds developer-authored annotations to the gauntlet knowledge base. Use when capturing tribal knowledge or rationale not visible in code.

Curate Knowledge

Add developer-authored annotations to the knowledge base.

When NOT To Use

• Knowledge derivable from the code itself (use `gauntlet:extract`)
• The DSA problem bank (use `gauntlet:problem-bank`)

Steps

1. Identify the module to annotate 2. Ask for the concept (key insight or rule) 3. Ask for the why (rationale, history, context) 4. Generate YAML annotation file 5. Save to `.gauntlet/annotations/<slug>.yaml` 6. Confirm saved and will be included in future challenges

Exit Criteria

• [ ] A YAML file exists at `.gauntlet/annotations/<slug>.yaml`

after the skill completes, where `<slug>` is derived from the annotated module and concept

• [ ] The YAML file contains at minimum a `concept` field (key

insight or rule) and a `why` field (rationale/history/context)

• [ ] Confirmation message states the annotation will be included

in future challenges, indicating it is on the discovery path for `gauntlet:extract`

• [ ] Annotation does not duplicate an existing entry under the

same slug (checked before saving)