Communitygithub.com

Crear Beads (Epic + tareas) para ralph-tui

Convierte PRDs en beads (epic + tareas hijas) para la ejecución autónoma de ralph-tui. Se activa con frases como 'crear beads', 'convertir PRD a beads', 'beads para ralph', 'beads de ralph'.

¿Qué es Crear Beads (Epic + tareas) para ralph-tui?

Este skill transforma un documento de requisitos (PRD) en una serie de beads (epic y tareas hijas) listos para ser ejecutados por ralph-tui con su plugin de tracker 'Beads'. La habilidad extrae primero las Puertas de Calidad (Quality Gates) del PRD, que son comandos de validación (como `pnpm typecheck` o `pnpm lint`) que deben aplicarse a todas las historias de usuario, y también identifica puertas específicas para historias de UI. Luego, analiza las historias de usuario del PRD y crea un bead de tipo epic para la característica principal, y beads hijo para cada historia de usuario. Cada bead hijo incluye en su descripción los criterios de aceptación originales más las puertas de calidad correspondientes. Las historias se ordenan en una secuencia de dependencias (esquema -> backend -> UI) usando el comando `bd dep add`, de modo que ralph-tui ejecute las tareas en el orden correcto: primero las que crean la base (esquema/backend) y luego las de UI. El skill sigue estrictamente la regla de que cada historia debe ser completable en una sola iteración de ralph-tui (un contexto de agente), por lo que si una historia es demasiado grande (por ejemplo, "construir todo el dashboard"), se divide en historias más pequeñas y enfocadas. El resultado final es un archivo `.beads/beads.jsonl` que ralph-tui puede leer para ejecutar las tareas de forma autónoma.

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

Preguntar en tu IA favorita

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

Documentación

Ralph TUI - Crear Beads

Convierte PRDs en beads (epic + tareas hijas) para la ejecución autónoma de ralph-tui.

Nota: Este skill está incluido con el plugin de tracker Beads de ralph-tui. Los futuros plugins de tracker (Linear, GitHub Issues, etc.) incluirán sus propios skills de creación de tareas.


El Trabajo

Toma un PRD (archivo markdown o texto) y crea beads en .beads/beads.jsonl:

  1. Extraer Puertas de Calidad de la sección "Quality Gates" del PRD
  2. Crear un bead epic para la funcionalidad
  3. Crear beads hijo para cada historia de usuario (con las puertas de calidad añadidas)
  4. Configurar dependencias entre beads (esquema → backend → UI)
  5. Salida lista para ralph-tui run --tracker beads

Paso 1: Extraer Puertas de Calidad

Busca 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, incluye también:
- Verificar en el navegador usando el skill dev-browser

Extrae:

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

Si no existe la sección "Quality Gates": Pregunta al usuario qué comandos deberían pasar, o usa un valor predeterminado sensato como npm run typecheck.


Formato de Salida

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

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

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

CRÍTICO: Usa siempre <<'EOF' (con comillas simples) para el delimitador HEREDOC. Esto evita que el shell interprete backticks, $variables y () en las descripciones.


Tamaño de la Historia: La Regla #1

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

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

Historias de tamaño adecuado:

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

Demasiado grandes (dividir estas):

  • "Construir todo el dashboard" → Dividir en: esquema, consultas, componentes UI, filtros
  • "Agregar 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 las 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 de 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 bd dep add

Usa el comando bd dep add para especificar qué beads deben completarse primero:

# Crear primero los beads
bd create --parent=epic-123 --title="US-001: Agregar esquema" ...
bd create --parent=epic-123 --title="US-002: Crear API" ...
bd create --parent=epic-123 --title="US-003: Construir UI" ...

# Luego agregar dependencias (la tarea depende del bloqueador)
bd dep add ralph-tui-002 ralph-tui-001  # US-002 depende de US-001
bd dep add ralph-tui-003 ralph-tui-002  # US-003 depende de US-002

Sintaxis: bd dep add <tarea> <depende-de> — la tarea depende de (está bloqueada por) depende-de.

ralph-tui hará lo siguiente:

  • 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 de dependencia correcto:

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

Criterios de Aceptación: Puertas de Calidad + Específicos de la 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 logra esta historia)
  2. Puertas de calidad de la sección "Quality Gates" del PRD (añadidas al final)

Bueno criterios (verificables):

  • "Agregar columna investorType a la tabla investor con valor predeterminado 'cold'"
  • "El menú desplegable de filtro tiene opciones: Todas, Cold, Friend"
  • "Al hacer clic en el toggle se muestra un diálogo de confirmación"

Malos criterios (vagos):

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

Reglas de Conversión

  1. Extraer Puertas de Calidad 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 del backend, etc.)
  5. Prioridad: Basada en el orden de dependencia, luego en el orden del documento (0=crítico, 2=medio, 4=backlog)
  6. Todas las historias: status: "open"
  7. Criterios de aceptación: Criterios de la historia + puertas de calidad añadidas
  8. Historias de UI: También añadir puertas específicas de UI (verificación en navegador)

División de PRDs Grandes

Si un PRD tiene funcionalidades grandes, divídelas:

Original:

"Agregar seguimiento de contactos de amigos con mensajería diferente"

Dividido en:

  1. US-001: Agregar campo investorType a la base de datos
  2. US-002: Agregar toggle de tipo a la lista de inversionistas 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: Implementar generación de tareas para amigos
  6. US-006: Agregar filtro por tipo
  7. US-007: Actualizar formulario de nuevo inversionista
  8. US-008: Actualizar conteos del dashboard

Cada uno es un cambio enfocado que se puede completar y verificar de forma independiente.


Ejemplo

PRD de entrada:

# PRD: Seguimiento de Amigos

Agregar la capacidad de marcar inversionistas 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, incluye también:
- Verificar en el navegador usando el skill dev-browser

## Historias de Usuario

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

**Criterios de Aceptación:**
- [ ] Agregar columna investorType: 'cold' | 'friend' (predeterminado 'cold')
- [ ] Generar y ejecutar migración exitosamente

### US-002: Agregar toggle de tipo a las filas de la lista de inversionistas
**Descripción:** Como Ryan, quiero cambiar el tipo de inversionista directamente desde la lista.

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

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

**Criterios de Aceptación:**
- [ ] Menú desplegable de filtro: Todas | Cold | Friend
- [ ] El filtro persiste en los parámetros de URL

Beads de salida:

# Crear epic (enlazar al PRD fuente)
bd create --type=epic \
  --title="Seguimiento de Amigos" \
  --description="$(cat <<'EOF'
Contacto cálido para obtener retroalimentación de presentaciones
EOF
)" \
  --external-ref="prd:./tasks/friends-outreach-prd.md"

# US-001: Sin deps (primero - crea el esquema)
bd create --parent=ralph-tui-abc \
  --title="US-001: Agregar campo investorType a la tabla investor" \
  --description="$(cat <<'EOF'
Como desarrollador, necesito categorizar inversionistas como 'cold' o 'friend'.

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

# US-002: Historia de UI (también obtiene verificación en navegador)
bd create --parent=ralph-tui-abc \
  --title="US-002: Agregar toggle de tipo a las filas de la lista de inversionistas" \
  --description="$(cat <<'EOF'
Como Ryan, quiero cambiar el tipo de inversionista directamente desde la lista.

## Criterios de Aceptación
- [ ] Cada fila tiene un toggle Cold | Friend
- [ ] Al cambiar, se 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 el navegador usando el skill dev-browser
EOF
)" \
  --priority=2

# Agregar dependencia: US-002 depende de US-001
bd dep add ralph-tui-002 ralph-tui-001

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

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

# Agregar dependencia: US-003 depende de US-002
bd dep add ralph-tui-003 ralph-tui-002

Ubicación de Salida

Los beads se escriben en: .beads/beads.jsonl

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

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

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

ralph-tui hará lo siguiente:

  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 terminados
  4. Mostrará <promise>COMPLETE</promise> cuando el epic esté completo

Lista de Verificación Antes de Crear Beads

  • Extraídas las Puertas de Calidad del PRD (o preguntado al usuario si faltan)
  • Cada historia es completable en una iteración (suficientemente pequeña)
  • Las historias están ordenadas por dependencia (esquema → backend → UI)
  • Las puertas de calidad se han añadido a los criterios de aceptación de cada bead
  • Las historias de UI tienen verificación en navegador (si está especificado en las Puertas de Calidad)
  • Los criterios de aceptación son verificables (no vagos)
  • Ninguna historia depende de una historia posterior (solo de anteriores)
  • Se han agregado dependencias con bd dep add después de crear los beads

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