dev-issues

Decompose unstructured brain-dumps into discrete issue files with collision-checking.

118|12|Updated May 5, 2026
One-click install
npx skills add https://github.com/alecs5am/ralphy --skill dev-issues
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: dev-issues
Source: https://github.com/alecs5am/ralphy/tree/main/.agents/skills/dev-issues
Command: npx skills add https://github.com/alecs5am/ralphy --skill dev-issues

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Turn a free-form brain-dump into a clean, ordered set of notes/issues work items. The user tags /dev-issues and writes a long stream of everything in their head — features, refactors, bugs, half-formed ideas, product direction. This skill decomposes that stream into discrete, well-shaped, individually-actionable issue files, asks clarifying questions only where a decision is genuinely the user's, collision-checks against the existing notes inbox so it updates rather than duplicates, then commits the batch. The end state: every thought is captured as an issue a downstream agent (or /dev-loop) can pick up and execute.

Core Features & Use Cases

  • Decomposes a brain-dump into discrete issues
  • Collision-checks against existing notes/issues to avoid duplicates
  • Pairs with the dev-loop to execute the issues
  • Commits the batch to notes/issues

Quick Start

Tag your input with /dev-issues and write a long brain-dump to start converting it into tracked issues.

Frequently Asked Questions about dev-issues

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I convert unstructured brain-dumps into actionable development issues?

To convert unstructured brain-dumps into actionable development issues, this skill decomposes long-form text streams into discrete issue files. It applies strict collision-checking against existing notes and enforces concrete scope and acceptance criteria to enable downstream execution.

What is the best way to track feature ideas and refactor notes without creating duplicates?

Tracking feature ideas and refactor notes without duplicates requires collision-checking against an existing notes inbox. This process updates overlapping items rather than duplicating them, ensuring a clean, ordered set of individually-actionable issue files.

How does issue decomposition handle half-formed ideas in a brainstorm?

Issue decomposition handles half-formed ideas by breaking down long-form brainstorms into discrete, well-shaped work items. It asks clarifying questions only where a genuine decision is required, capturing every thought as an issue a downstream agent can execute.

Can I use these generated issues directly with my development loop?

You can use these generated issues directly with your development loop. Each issue file enforces monotonic numbering and concrete acceptance criteria, producing notes specifically designed for a downstream agent or dev-loop to pick up and execute.

Does converting a brain-dump into tracked issues require manual batch formatting?

Converting a brain-dump into tracked issues does not require manual batch formatting. You simply tag an unstructured stream of features, bugs, and ideas, and the system automatically structures, collision-checks, and commits the batch of notes.

What limitations exist when decomposing long-form text into issue files?

A limitation when decomposing long-form text into issue files is that the process enforces strict collision-checking and monotonic numbering at a flat top level. It will pause to ask clarifying questions only where a decision is genuinely yours to make.