ralph-tui-create-beads

This skill acts as an intelligent bridge between high-level Product Requirement Documents (PRDs) and the execution-ready task format required by ralph-tui. By transforming markdown-based feature specifications into structured task beads, it enables an autonomous agent loop that maintains logical execution order and verification standards. The skill is specifically designed for developers and technical project managers using ralph-tui who need to ensure that their AI agents follow a disciplined, test-driven approach during development cycles.

The tool processes input PRDs by parsing the Quality Gates section to identify mandatory testing and verification steps. It automatically generates a parent epic bead and a series of child beads representing individual user stories. It enforces dependency logic, ensuring that tasks are ordered correctly—typically from database schema migrations through backend logic to frontend UI components—which allows the agent to build systems incrementally without context loss. Because ralph-tui operates in isolated iterations, this skill is critical for breaking down large feature sets into manageable, verifiable units that fit within the agent's context window.

• Automatically extracts universal and UI-specific quality gates from PRD markdown files.

• Generates shell-safe bd create commands using HEREDOC syntax to preserve complex task descriptions.

• Handles dependency chain creation using bd dep add to enforce execution order (schema, then backend, then UI).

• Defines acceptance criteria by merging specific user story requirements with global quality gate commands.

• Supports granular task decomposition to prevent context exhaustion in long-running agent workflows.

• Integrates directly with the beads-rust tracker plugin and the native beads storage format.

• Always ensure PRDs contain a clear Quality Gates section; if omitted, the skill will prompt for defaults like npm run typecheck.

• Follow the 'One Story, One Iteration' rule to ensure the AI agent can complete each task within its memory limit.

• Use the generated beads.jsonl file as the primary task source for the ralph-tui run command.

• The output uses single-quoted HEREDOC delimiters (cat <<'EOF') to prevent shell character interference in task descriptions.

• Ideal for complex features like database schema updates, API implementation, and UI component integration.