understand

What problem does it solve?

This Skill gathers and synthesizes context about a repository and the user's stated problem so contributors can reason correctly without proposing solutions prematurely. It helps surface the current iteration, existing research notes, and gaps in understanding so work can be delegated or planned with confidence.

Core Features & Use Cases

• Iteration discovery: Detects the highest .thoughts/iteration-NN directory and collects relevant iteration artifacts.
• Agent planning: Designs focused research questions and composes a small team of web-searcher and code-searcher agents when external or local research is required.
• Synthesis: Merges agent outputs into a coherent .thoughts/iteration-NN/understanding/understanding-NN.md summary that describes the problem and current progress without proposing solutions.
• Use case: Onboarding a new contributor to a bugfix or feature by producing a single-file narrative of what is known, open questions, and where to look next.

Quick Start

Run the understand skill to analyze the repository, collect .thoughts artifacts for the current iteration, coordinate research agents as needed, and produce a synthesized understanding document in the current .thoughts iteration.