Communitygithub.com

Ralph TUI - Crear Beads (beads-rust)

Convierte PRDs en beads (epic + tareas hijas) para ejecución autónoma con ralph-tui usando beads-rust (CLI br).

¿Qué es Ralph TUI - Crear Beads (beads-rust)?

Este skill convierte un Documento de Requisitos del Producto (PRD) en un conjunto de 'beads' (un epic y tareas hijas) que pueden ser ejecutados de manera autónoma por ralph-tui utilizando beads-rust (comando `br`). Es útil cuando tienes un PRD y quieres usar ralph-tui con beads-rust como fuente de tareas. El skill extrae los 'Quality Gates' del PRD, crea un epic que vincula al PRD original, genera beads hijos para cada historia de usuario (con los Quality Gates añadidos a sus criterios de aceptación), establece dependencias entre beads (esquema → backend → UI), y produce la salida lista para `ralph-tui run --tracker beads-rust`. Soporta división de historias grandes en cambios más pequeños y manejables que caben en una iteración de ralph-tui.

Compatible con~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/ComeOnOliver/skillshub/tree/HEAD/skills/aiskillstore/marketplace/subsy/ralph-tui-create-beads-rust

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

¿Qué hace Ralph TUI - Crear Beads (beads-rust)?

Convierte PRDs a beads (epic + tareas hijas) para ejecución autónoma con ralph-tui usando beads-rust (br CLI).

Nota: Este skill usa el comando br de beads-rust. Si tienes instalado el beads original (bd), usa el skill ralph-tui-create-beads.


El Trabajo

Tomar un PRD (archivo markdown o texto) y crear beads usando comandos br:

  1. Extraer Quality Gates de la sección "Quality Gates" del PRD
  2. Crear un bead epic para la funcionalidad
  3. Crear beads hijos para cada historia de usuario (con los quality gates añadidos)
  4. Establecer dependencias entre beads (esquema → backend → UI)
  5. Salida lista para ralph-tui run --tracker beads-rust

Paso 1: Extraer Quality Gates

Buscar la sección "Quality Gates" en el PRD:

## Quality Gates

Estos comandos deben pasar para cada historia de usuario:
- `pnpm typecheck` - Verificación de tipos
- `pnpm lint` - Linting

Para historias de UI, incluir también:
- Verificar en navegador usando el skill dev-browser

Extraer:

  • Gates universales: Comandos que aplican a TODAS las historias (ej., pnpm typecheck)
  • Gates de UI: Comandos que aplican solo a historias de UI (ej., verificación en navegador)

Si no existe sección de Quality Gates: Preguntar al usuario qué comandos deben pasar, o usar un valor predeterminado sensato como npm run typecheck.


Formato de Salida

Los beads usan el comando br create con sintaxis HEREDOC para manejar caracteres especiales de forma segura:

# Crear epic (enlace de vuelta al PRD fuente)
br create --type=epic \
  --title="[Nombre de Funcionalidad]" \
  --description="$(cat <<'EOF'
[Descripción de funcionalidad del PRD]
EOF
)" \
  --external-ref="prd:./tasks/feature-name-prd.md"

# Crear bead hijo (con quality gates en criterios de aceptación)
br create \
  --parent=EPIC_ID \
  --title="[Título de Historia]" \
  --description="$(cat <<'EOF'
[Descripción de historia con criterios de aceptación INCLUYENDO quality gates]
EOF
)" \
  --priority=[1-4]

CRÍTICO: Usar siempre <<'EOF' (con comillas simples) para el delimitador HEREDOC. Esto evita la interpretación por parte del shell de acentos graves, $variables, y () en las descripciones.


Tamaño de Historia: La Regla #1

Cada historia debe poder completarse en UNA iteración de ralph-tui (~una ventana de contexto de agente).

ralph-tui crea una instancia de agente nueva por iteración sin memoria del trabajo anterior. Si una historia es demasiado grande, el agente se queda sin contexto antes de terminarla.

Historias con tamaño correcto:

  • Añadir una columna de base de datos + migración
  • Añadir un componente UI a una página existente
  • Actualizar una server action con nueva lógica
  • Añadir un desplegable de filtro a una lista

Demasiado grandes (dividir estas):

  • "Construir todo el dashboard" → Dividir en: esquema, consultas, componentes UI, filtros
  • "Añadir autenticación" → Dividir en: esquema, middleware, UI de inicio de sesión, manejo de sesiones
  • "Refactorizar la API" → Dividir en una historia por endpoint o patrón

Regla general: Si no puedes describir el cambio en 2-3 oraciones, es demasiado grande.


Orden de Historias: Dependencias Primero

Las historias se ejecutan en orden de dependencia. Las historias anteriores no deben depender de las posteriores.

Orden correcto:

  1. Cambios de esquema/base de datos (migraciones)
  2. Server actions / lógica backend
  3. Componentes UI que usan el backend
  4. Vistas de dashboard/resumen que agregan datos

Orden incorrecto:

  1. ❌ Componente UI (depende de un esquema que aún no existe)
  2. ❌ Cambio de esquema

Dependencias con br dep add

Usar el comando br dep add para especificar qué beads deben completarse primero:

# Crear los beads primero
br create --parent=epic-123 --title="US-001: Añadir esquema" ...
br create --parent=epic-123 --title="US-002: Crear API" ...
br create --parent=epic-123 --title="US-003: Construir UI" ...

# Luego añadir dependencias (issue depende-de blocker)
br dep add ralph-tui-002 ralph-tui-001  # US-002 depende de US-001
br dep add ralph-tui-003 ralph-tui-002  # US-003 depende de US-002

Sintaxis: br dep add <issue> <depende-de> — el issue depende de (está bloqueado por) depende-de.

ralph-tui:

  • Mostrará los beads bloqueados como "bloqueados" hasta que las dependencias se completen
  • Nunca seleccionará un bead para ejecución mientras sus dependencias estén abiertas
  • Incluirá el contexto de dependencia en el prompt al trabajar en un bead

Orden correcto de dependencias:

  1. Cambios de esquema/base de datos (sin dependencias)
  2. Lógica backend (depende del esquema)
  3. Componentes UI (dependen del backend)
  4. Integración/pulido (depende de UI)

Criterios de Aceptación: Quality Gates + Específicos de Historia

La descripción de cada bead debe incluir criterios de aceptación con:

  1. Criterios específicos de la historia del PRD (lo que esta historia logra)
  2. Quality gates de la sección de Quality Gates del PRD (añadidos al final)

Criterios buenos (verificables):

  • "Añadir columna investorType a la tabla investor con valor por defecto 'cold'"
  • "El desplegable de filtro tiene opciones: All, Cold, Friend"
  • "Al hacer clic en el toggle se muestra un diálogo de confirmación"

Criterios malos (vagos):

  • ❌ "Funciona correctamente"
  • ❌ "El usuario puede hacer X fácilmente"
  • ❌ "Buena experiencia de usuario"
  • ❌ "Maneja casos límite"

Reglas de Conversión

  1. Extraer Quality Gates del PRD primero
  2. Cada historia de usuario → un bead
  3. Primera historia: Sin dependencias (crea la base)
  4. Historias siguientes: Dependen de sus predecesoras (UI depende de backend, etc.)
  5. Prioridad: Basada en orden de dependencia, luego orden del documento (0=crítica, 2=media, 4=backlog)
  6. Todas las historias: status: "open"
  7. Criterios de aceptación: Criterios de historia + quality gates añadidos
  8. Historias de UI: También añadir gates específicos de UI (verificación en navegador)

División de PRDs Grandes

Si un PRD tiene funcionalidades grandes, dividirlas:

Original:

"Añadir flujo de contactos amigos con diferentes mensajes"

Dividir en:

  1. US-001: Añadir campo investorType a la base de datos
  2. US-002: Añadir toggle de tipo a la lista de inversores en UI
  3. US-003: Crear lógica de progresión de fase específica para amigos
  4. US-004: Crear plantillas de mensajes para amigos
  5. US-005: Conectar generación de tareas para amigos
  6. US-006: Añadir filtro por tipo
  7. US-007: Actualizar formulario de nuevo inversor
  8. US-008: Actualizar contadores del dashboard

Cada una es un cambio enfocado que puede completarse y verificarse independientemente.


Ejemplo

PRD de entrada:

# PRD: Contactos Amigos

Añadir capacidad de marcar inversores como "amigos" para contacto cálido.

## Quality Gates

Estos comandos deben pasar para cada historia de usuario:
- `pnpm typecheck` - Verificación de tipos
- `pnpm lint` - Linting

Para historias de UI, incluir también:
- Verificar en navegador usando el skill dev-browser

## Historias de Usuario

### US-001: Añadir campo investorType a la tabla investor
**Descripción:** Como desarrollador, necesito categorizar inversores como 'cold' o 'friend'.

**Criterios de Aceptación:**
- [ ] Añadir columna investorType: 'cold' | 'friend' (valor por defecto 'cold')
- [ ] Generar y ejecutar migración exitosamente

### US-002: Añadir toggle de tipo a filas de lista de inversores
**Descripción:** Como Ryan, quiero cambiar el tipo de inversor directamente desde la lista.

**Criterios de Aceptación:**
- [ ] Cada fila tiene un toggle Cold | Friend
- [ ] Al cambiar muestra un diálogo de confirmación
- [ ] Al confirmar: actualiza el tipo en la base de datos

### US-003: Filtrar inversores por tipo
**Descripción:** Como Ryan, quiero filtrar la lista para ver solo amigos o cold.

**Criterios de Aceptación:**
- [ ] Desplegable de filtro: All | Cold | Friend
- [ ] El filtro persiste en parámetros de URL

Beads de salida:

# Crear epic (enlace de vuelta al PRD fuente)
br create --type=epic \
  --title="Flujo de Contactos Amigos" \
  --description="$(cat <<'EOF'
Contacto cálido para feedback de deck
EOF
)" \
  --external-ref="prd:./tasks/friends-outreach-prd.md"

# US-001: Sin deps (primera - crea esquema)
br create --parent=ralph-tui-abc \
  --title="US-001: Añadir campo investorType a la tabla investor" \
  --description="$(cat <<'EOF'
Como desarrollador, necesito categorizar inversores como 'cold' o 'friend'.

## Criterios de Aceptación
- [ ] Añadir columna investorType: 'cold' | 'friend' (valor por defecto 'cold')
- [ ] Generar y ejecutar migración exitosamente
- [ ] pnpm typecheck pasa
- [ ] pnpm lint pasa
EOF
)" \
  --priority=1

# US-002: Historia de UI (también recibe verificación en navegador)
br create --parent=ralph-tui-abc \
  --title="US-002: Añadir toggle de tipo a filas de lista de inversores" \
  --description="$(cat <<'EOF'
Como Ryan, quiero cambiar el tipo de inversor directamente desde la lista.

## Criterios de Aceptación
- [ ] Cada fila tiene un toggle Cold | Friend
- [ ] Al cambiar muestra un diálogo de confirmación
- [ ] Al confirmar: actualiza el tipo en la base de datos
- [ ] pnpm typecheck pasa
- [ ] pnpm lint pasa
- [ ] Verificar en navegador usando el skill dev-browser
EOF
)" \
  --priority=2

# Añadir dependencia: US-002 depende de US-001
br dep add ralph-tui-002 ralph-tui-001

# US-003: Historia de UI
br create --parent=ralph-tui-abc \
  --title="US-003: Filtrar inversores por tipo" \
  --description="$(cat <<'EOF'
Como Ryan, quiero filtrar la lista para ver solo amigos o cold.

## Criterios de Aceptación
- [ ] Desplegable de filtro: All | Cold | Friend
- [ ] El filtro persiste en parámetros de URL
- [ ] pnpm typecheck pasa
- [ ] pnpm lint pasa
- [ ] Verificar en navegador usando el skill dev-browser
EOF
)" \
  --priority=3

# Añadir dependencia: US-003 depende de US-002
br dep add ralph-tui-003 ralph-tui-002

Sincronizar Cambios

Después de crear beads, sincronizar para exportar a JSONL (para seguimiento con git):

br sync --flush-only

Esto exporta la base de datos SQLite a .beads/issues.jsonl para control de versiones.


Ubicación de Salida

Los beads se almacenan en: directorio .beads/ (BD SQLite + exportación JSONL)

Después de la creación, ejecutar ralph-tui:

# Trabajar en un epic específico
ralph-tui run --tracker beads-rust --epic ralph-tui-abc

# O dejar que seleccione automáticamente la mejor tarea
ralph-tui run --tracker beads-rust

ralph-tui:

  1. Trabajará en los beads dentro del epic especificado (o seleccionará la mejor tarea disponible)
  2. Cerrará cada bead cuando esté completo
  3. Cerrará el epic cuando todos los hijos estén hechos
  4. Mostrará <promise>COMPLETE</promise> cuando el epic esté terminado

Lista de Verificación Antes de Crear Beads

  • Quality Gates extraídos del PRD (o preguntados al usuario si faltan)
  • Cada historia se puede completar en una iteración (suficientemente pequeña)
  • Las historias están ordenadas por dependencia (esquema → backend → UI)
  • Quality gates añadidos a los criterios de aceptación de cada bead
  • Las historias de UI tienen verificación en navegador (si se especifica en Quality Gates)
  • Los criterios de aceptación son verificables (no vagos)
  • Ninguna historia depende de una historia posterior (solo de anteriores)
  • Dependencias añadidas con br dep add después de crear beads
  • Ejecutado br sync --flush-only para exportar para seguimiento con git

Diferencias con beads (versión Go)

Comandobeads (bd)beads-rust (br)
Crearbd createbr create
Dependenciasbd dep addbr dep add
Sincronizarbd syncbr sync --flush-only
Cerrarbd closebr close
Almacenamiento.beads/beads.jsonl.beads/*.db + exportación JSONL

Individual skills in this repo

This repo contains 20 individual skills — each has its own dedicated page.

ComeOnOliver/skillshub

Create stunning, animation-rich HTML presentations from scratch or by converting PowerPoint files. Use when the user wants to build a presentation, convert a PPT/PPTX to web, or create slides for a talk/pitch. Helps non-designers discover their aesthetic through visual exploration rather than abstract choices.

ComeOnOliver/skillshub

Next.js 16+ 和 Turbopack — 增量打包、文件系统缓存、开发速度,以及何时使用 Turbopack 与 webpack。

ComeOnOliver/skillshub

SwiftUI architecture patterns, state management with @Observable, view composition, navigation, performance optimization, and modern iOS/macOS UI best practices.

ComeOnOliver/skillshub

See, Understand, Act on video and audio. See- ingest from local files, URLs, RTSP/live feeds, or live record desktop; return realtime context and playable stream links. Understand- extract frames, build visual/semantic/temporal indexes, and search moments with timestamps and auto-clips. Act- transcode and normalize (codec, fps, resolution, aspect ratio), perform timeline edits (subtitles, text/image overlays, branding, audio overlays, dubbing, translation), generate media assets (image, audio, video), and create real time alerts for events from live streams or desktop capture.

ComeOnOliver/skillshub

AI-assisted video editing workflows for cutting, structuring, and augmenting real footage. Covers the full pipeline from raw capture through FFmpeg, Remotion, ElevenLabs, fal.ai, and final polish in Descript or CapCut. Use when the user wants to edit video, cut footage, create vlogs, or build video content.

ComeOnOliver/skillshub

Next.js 15 애플리케이션을 위한 프론트엔드 개발 가이드라인. React 19, TypeScript, Shadcn/ui, Tailwind CSS를 사용한 모던 패턴. Server Components, Client Components, App Router, 파일 구조, Shadcn/ui 컴포넌트, 성능 최적화, TypeScript 모범 사례 포함. 컴포넌트, 페이지, 기능 생성, 데이터 페칭, 스타일링, 라우팅, 프론트엔드 코드 작업 시 사용.

ComeOnOliver/skillshub

Provides Tamagui patterns for config v4, compiler optimization, styled context, and cross-platform styling. Must use when working with Tamagui projects (tamagui.config.ts, @tamagui imports).

ComeOnOliver/skillshub

Create distinctive, production-grade frontend interfaces with high design quality. Use this skill when the user asks to build web components, pages, or applications. Generates creative, polished code that avoids generic AI aesthetics.

ComeOnOliver/skillshub

Create high-converting, visually distinctive landing pages. Use when building marketing pages, product launches, SaaS homepages, or any single-page conversion-focused website. Guides section-by-section composition with anti-AI-slop principles.

ComeOnOliver/skillshub

Auto-loaded context for Portfolio Buddy 2 development. Use for ANY task involving: React 19 development, TypeScript, portfolio analysis features, metrics calculations, trading strategy comparison, or working with the Portfolio Buddy 2 codebase. Contains tech stack, known issues, and architectural constraints.

ComeOnOliver/skillshub

Next.js development tooling via MCP. Inspect routes, components, build info, and debug Next.js apps. Use when working on Next.js applications, debugging routing, or inspecting app structure. NOT for general React or non-Next.js projects.

ComeOnOliver/skillshub

Implement UI using Shadcn MCP (atoms/theme) and 21st.dev MCP (complex sections). Use when adding buttons, layouts, or generating landing pages.

ComeOnOliver/skillshub

A conceptual skill for building an API client in Next.js that handles JWT tokens

ComeOnOliver/skillshub

Best practices and patterns for Next.js App Router, Server Actions, and Routing in this project.

ComeOnOliver/skillshub

The Design System, Theme, and UX rules for the Physical AI Hub.

ComeOnOliver/skillshub

Comprehensive frontend development skill for building modern, performant web applications using ReactJS, NextJS, TypeScript, Tailwind CSS. Includes component scaffolding, performance optimization, bundle analysis, and UI best practices. Use when developing frontend features, optimizing performance, implementing UI/UX designs, managing state, or reviewing frontend code.

ComeOnOliver/skillshub

This document captures learnings from fixing keyboard navigation issues when floating components (Select, DropdownMenu, Popover) have CSS open/close animations.

ComeOnOliver/skillshub

Build Next.js 16 applications with correct patterns and distinctive design. Use when creating pages, layouts, dynamic routes, upgrading from Next.js 15, or implementing proxy.ts. Covers breaking changes (async params/searchParams, Turbopack, cacheComponents) and frontend aesthetics. NOT when building non-React or backend-only applications.

ComeOnOliver/skillshub

Comprehensive Framer Motion animation library for React. Covers motion components, variants, gestures, page transitions, and scroll animations. Use when adding animations to React/Next.js applications.

ComeOnOliver/skillshub

Build interfaces that resonate, not just render. This skill enforces bold, intentional

Skills relacionados