Communitygithub.com

Conversão de PRDs em Beads para ralph-tui

Converte PRDs em beads (épico + tarefas filhas) para execução autônoma com ralph-tui. Use quando tiver um PRD e quiser usar o ralph-tui com beads como fonte de tarefas.

O que é Conversão de PRDs em Beads para ralph-tui?

Esta skill converte Documentos de Requisitos de Produto (PRDs) em beads, um formato de tarefa para o ralph-tui. Ela extrai Portões de Qualidade do PRD, cria um bead de épico para a funcionalidade, e beads filhas para cada história de usuário, com dependências configuradas entre elas (ex.: esquema → backend → UI). O resultado é um arquivo `.beads/beads.jsonl` pronto para execução com `ralph-tui run --tracker beads`. É fundamental que cada história seja pequena o suficiente para ser concluída em uma única iteração do agente, seguindo a ordem de dependências e anexando os portões de qualidade aos critérios de aceitação.

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

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Ralph TUI - Criar Beads

Converte PRDs em beads (épico + tarefas filhas) para execução autônoma com ralph-tui.

Nota: Esta skill acompanha o plugin de rastreador de Beads do ralph-tui. Plugins de rastreador futuros (Linear, GitHub Issues, etc.) incluirão suas próprias skills de criação de tarefas.


O Trabalho

Pegue um PRD (arquivo markdown ou texto) e crie beads em .beads/beads.jsonl:

  1. Extrair Portões de Qualidade da seção "Portões de Qualidade" do PRD
  2. Criar um bead de épico para a funcionalidade
  3. Criar beads filhas para cada história de usuário (com portões de qualidade anexados)
  4. Configurar dependências entre os beads (esquema → backend → UI)
  5. Saída pronta para ralph-tui run --tracker beads

Passo 1: Extrair Portões de Qualidade

Procure pela seção "Portões de Qualidade" no PRD:

## Portões de Qualidade

Estes comandos devem passar para cada história de usuário:
- `pnpm typecheck` - Verificação de tipos
- `pnpm lint` - Verificação de linting

Para histórias de UI, inclua também:
- Verificar no navegador usando a skill dev-browser

Extraia:

  • Portões universais: Comandos que se aplicam a TODAS as histórias (ex.: pnpm typecheck)
  • Portões de UI: Comandos que se aplicam apenas a histórias de UI (ex.: verificação no navegador)

Se não houver seção de Portões de Qualidade: Pergunte ao usuário quais comandos devem passar ou use um padrão sensato, como npm run typecheck.


Formato de Saída

Os beads usam o comando bd create com sintaxe HEREDOC para lidar com caracteres especiais com segurança:

# Criar épico (link de volta ao PRD fonte)
bd create --type=epic \
  --title="[Nome da Funcionalidade]" \
  --description="$(cat <<'EOF'
[Descrição da funcionalidade do PRD]
EOF
)" \
  --external-ref="prd:./tasks/nome-da-funcionalidade-prd.md"

# Criar bead filho (com portões de qualidade nos critérios de aceitação)
bd create \
  --parent=EPIC_ID \
  --title="[Título da História]" \
  --description="$(cat <<'EOF'
[Descrição da história com critérios de aceitação INCLUINDO portões de qualidade]
EOF
)" \
  --priority=[1-4]

IMPORTANTE: Sempre use <<'EOF' (com aspas simples) para o delimitador HEREDOC. Isso evita a interpretação de acentos graves, $variáveis e () pelo shell nas descrições.


Tamanho da História: A Regra #1

Cada história deve ser concluível em UMA iteração do ralph-tui (~um contexto de janela do agente).

O ralph-tui inicia uma nova instância do agente por iteração, sem memória do trabalho anterior. Se uma história for muito grande, o agente fica sem contexto antes de terminar.

Histórias de tamanho adequado:

  • Adicionar uma coluna ao banco + migração
  • Adicionar um componente de UI em uma página existente
  • Atualizar uma server action com nova lógica
  • Adicionar um dropdown de filtro a uma lista

Muito grande (divida estas):

  • "Construir o dashboard inteiro" → Divida em: esquema, consultas, componentes de UI, filtros
  • "Adicionar autenticação" → Divida em: esquema, middleware, UI de login, gerenciamento de sessão
  • "Refatorar a API" → Divida em uma história por endpoint ou padrão

Regra prática: Se você não consegue descrever a mudança em 2-3 frases, é muito grande.


Ordem das Histórias: Dependências Primeiro

As histórias executam na ordem de dependência. Histórias anteriores não devem depender de posteriores.

Ordem correta:

  1. Alterações de esquema/banco (migrações)
  2. Server actions / lógica de backend
  3. Componentes de UI que usam o backend
  4. Visualizações de dashboard/resumo que agregam dados

Ordem errada:

  1. ❌ Componente de UI (depende de esquema que ainda não existe)
  2. ❌ Alteração de esquema

Dependências com bd dep add

Use o comando bd dep add para especificar quais beads devem ser concluídos primeiro:

# Crie os beads primeiro
bd create --parent=epico-123 --title="US-001: Adicionar esquema" ...
bd create --parent=epico-123 --title="US-002: Criar API" ...
bd create --parent=epico-123 --title="US-003: Construir UI" ...

# Depois adicione as dependências (issue depende-de 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

Sintaxe: bd dep add <issue> <depende-de> — a issue depende de (é bloqueada por) depende-de.

O ralph-tui irá:

  • Mostrar beads bloqueados como "bloqueados" até que as dependências sejam concluídas
  • Nunca selecionar um bead para execução enquanto suas dependências estiverem abertas
  • Incluir contexto da dependência no prompt ao trabalhar em um bead

Ordem correta de dependência:

  1. Alterações de esquema/banco (sem dependências)
  2. Lógica de backend (depende do esquema)
  3. Componentes de UI (dependem do backend)
  4. Integração/polimento (depende da UI)

Critérios de Aceitação: Portões de Qualidade + Específicos da História

A descrição de cada bead deve incluir critérios de aceitação com:

  1. Critérios específicos da história do PRD (o que esta história realiza)
  2. Portões de qualidade da seção Portões de Qualidade do PRD (anexados ao final)

Bons critérios (verificáveis):

  • "Adicionar coluna investorType à tabela investor com padrão 'cold'"
  • "Dropdown de filtro tem opções: All, Cold, Friend"
  • "Clicar no toggle mostra diálogo de confirmação"

Maus critérios (vagos):

  • ❌ "Funciona corretamente"
  • ❌ "O usuário pode fazer X facilmente"
  • ❌ "Boa UX"
  • ❌ "Trata casos de borda"

Regras de Conversão

  1. Extrair Portões de Qualidade do PRD primeiro
  2. Cada história de usuário → um bead
  3. Primeira história: Sem dependências (cria a base)
  4. Histórias subsequentes: Dependem de suas antecessoras (UI depende do backend, etc.)
  5. Prioridade: Baseada na ordem de dependência, depois na ordem do documento (0=crítico, 2=médio, 4=backlog)
  6. Todas as histórias: status: "open"
  7. Critérios de aceitação: Critérios da história + portões de qualidade anexados
  8. Histórias de UI: Anexar também portões específicos de UI (verificação no navegador)

Dividindo PRDs Grandes

Se um PRD tiver funcionalidades grandes, divida-as:

Original:

"Adicionar rastreamento de outreach para amigos com mensagens diferentes"

Dividido em:

  1. US-001: Adicionar campo investorType ao banco
  2. US-002: Adicionar alternância de tipo à lista de investidores UI
  3. US-003: Criar lógica de progressão de fase específica para amigos
  4. US-004: Criar templates de mensagem para amigos
  5. US-005: Configurar geração de tarefas para amigos
  6. US-006: Adicionar filtro por tipo
  7. US-007: Atualizar formulário de novo investidor
  8. US-008: Atualizar contagens do dashboard

Cada uma é uma mudança focada que pode ser concluída e verificada independentemente.


Exemplo

PRD de entrada:

# PRD: Outreach para Amigos

Adicionar capacidade de marcar investidores como "amigos" para outreach caloroso.

## Portões de Qualidade

Estes comandos devem passar para cada história de usuário:
- `pnpm typecheck` - Verificação de tipos
- `pnpm lint` - Verificação de linting

Para histórias de UI, inclua também:
- Verificar no navegador usando a skill dev-browser

## Histórias de Usuário

### US-001: Adicionar campo investorType à tabela investor
**Descrição:** Como desenvolvedor, preciso categorizar investidores como 'cold' ou 'friend'.

**Critérios de Aceitação:**
- [ ] Adicionar coluna investorType: 'cold' | 'friend' (padrão 'cold')
- [ ] Gerar e executar migração com sucesso

### US-002: Adicionar alternância de tipo às linhas da lista de investidores
**Descrição:** Como Ryan, quero alternar o tipo do investidor diretamente da lista.

**Critérios de Aceitação:**
- [ ] Cada linha tem alternância Cold | Friend
- [ ] Alternar mostra diálogo de confirmação
- [ ] Ao confirmar: atualiza tipo no banco

### US-003: Filtrar investidores por tipo
**Descrição:** Como Ryan, quero filtrar a lista para ver apenas amigos ou cold.

**Critérios de Aceitação:**
- [ ] Dropdown de filtro: All | Cold | Friend
- [ ] Filtro persiste nos parâmetros da URL

Beads de saída:

# Criar épico (link de volta ao PRD fonte)
bd create --type=epic \
  --title="Funcionalidade de Outreach para Amigos" \
  --description="$(cat <<'EOF'
Outreach caloroso para feedback de deck
EOF
)" \
  --external-ref="prd:./tasks/friends-outreach-prd.md"

# US-001: Sem dependências (primeiro - cria esquema)
bd create --parent=ralph-tui-abc \
  --title="US-001: Adicionar campo investorType à tabela investor" \
  --description="$(cat <<'EOF'
Como desenvolvedor, preciso categorizar investidores como 'cold' ou 'friend'.

## Critérios de Aceitação
- [ ] Adicionar coluna investorType: 'cold' | 'friend' (padrão 'cold')
- [ ] Gerar e executar migração com sucesso
- [ ] pnpm typecheck passa
- [ ] pnpm lint passa
EOF
)" \
  --priority=1

# US-002: História de UI (também recebe verificação no navegador)
bd create --parent=ralph-tui-abc \
  --title="US-002: Adicionar alternância de tipo às linhas da lista de investidores" \
  --description="$(cat <<'EOF'
Como Ryan, quero alternar o tipo do investidor diretamente da lista.

## Critérios de Aceitação
- [ ] Cada linha tem alternância Cold | Friend
- [ ] Alternar mostra diálogo de confirmação
- [ ] Ao confirmar: atualiza tipo no banco
- [ ] pnpm typecheck passa
- [ ] pnpm lint passa
- [ ] Verificar no navegador usando a skill dev-browser
EOF
)" \
  --priority=2

# Adicionar dependência: US-002 depende de US-001
bd dep add ralph-tui-002 ralph-tui-001

# US-003: História de UI
bd create --parent=ralph-tui-abc \
  --title="US-003: Filtrar investidores por tipo" \
  --description="$(cat <<'EOF'
Como Ryan, quero filtrar a lista para ver apenas amigos ou cold.

## Critérios de Aceitação
- [ ] Dropdown de filtro: All | Cold | Friend
- [ ] Filtro persiste nos parâmetros da URL
- [ ] pnpm typecheck passa
- [ ] pnpm lint passa
- [ ] Verificar no navegador usando a skill dev-browser
EOF
)" \
  --priority=3

# Adicionar dependência: US-003 depende de US-002
bd dep add ralph-tui-003 ralph-tui-002

Local de Saída

Os beads são escritos em: .beads/beads.jsonl

Após a criação, execute o ralph-tui:

# Trabalhar em um épico específico
ralph-tui run --tracker beads --epic ralph-tui-abc

# Ou deixar que ele selecione a melhor tarefa automaticamente
ralph-tui run --tracker beads

O ralph-tui irá:

  1. Trabalhar nos beads dentro do épico especificado (ou selecionar a melhor tarefa disponível)
  2. Fechar cada bead quando concluído
  3. Fechar o épico quando todos os filhos estiverem prontos
  4. Gerar <promise>COMPLETE</promise> quando o épico for concluído

Lista de Verificação Antes de Criar Beads

  • Portões de Qualidade extraídos do PRD (ou perguntado ao usuário se ausentes)
  • Cada história é concluível em uma iteração (pequena o suficiente)
  • Histórias ordenadas por dependência (esquema → backend → UI)
  • Portões de qualidade anexados aos critérios de aceitação de cada bead
  • Histórias de UI têm verificação no navegador (se especificada nos Portões de Qualidade)
  • Critérios de aceitação são verificáveis (não vagos)
  • Nenhuma história depende de uma história posterior (apenas de anteriores)
  • Dependências adicionadas com bd dep add após criar 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

Habilidades Relacionadas