Refinements
Divide to conquer. Break large Issues into focused, manageable tasks.
How it works
Snapr can refine complex Issues into smaller, actionable tasks by automatically creating sub-issues that make development more focused and manageable.
1. The trigger
A developer comments @snapr refine on an Issue. That comment fires a webhook that instantly notifies Snapr to start the refinement process.
Alternatively, commenting @snapr analyze triggers a deeper analysis of the Issue, allowing Snapr to evaluate its clarity, structure, and potential scope and even provide suggestions for improvement.
2. The reaction
Snapr receives the event and launches a Kubernetes Job, a short-lived worker dedicated to processing that Issue and generating refinements or analysis results.
3. The analysis
Inside the Job, Snapr:
- Reads the Issue description and its conversation history
- Extracts relevant context, requirements, and dependencies
- Identifies possible subtasks or missing details
- Optionally requests clarification from the user if needed
4. The generation
Using that context, Snapr:
- Suggests or creates new, smaller Issues derived from the original one
- Keeps logical relationships between them (parent → sub-issue)
- Ensures each sub-Issue is clear, focused, and actionable
4. The feedback
Once the refinement or analysis is complete, Snapr posts the results directly into the original Issue whether that’s:
- A set of newly created sub-Issues
- A detailed analysis of the current Issue’s quality, clarity, or next steps
After that, Snapr stays actively attentive to further comments in the same thread.