bead-polishing-ralph

Polish Ralph-TUI beads to fit one agent context window.

2|Updated Mar 21, 2026
One-click install
npx skills add https://github.com/vnnkl/agentflywheel --skill bead-polishing-ralph
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: bead-polishing-ralph
Source: https://github.com/vnnkl/agentflywheel/tree/main/skills/bead-polishing-ralph
Command: npx skills add https://github.com/vnnkl/agentflywheel --skill bead-polishing-ralph

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Iteratively refine beads for ralph-tui execution through 4-6 polishing rounds until convergence, ensuring each bead fits one agent context window, has quality gates appended, uses correct bd/br CLI syntax, and follows schema-backend-UI dependency ordering.

Core Features & Use Cases

  • Enforces one-context-window bead size to prevent execution stalls.
  • Appends universal quality gates and explicit acceptance criteria to every bead.
  • Guides dependency ordering (schema -> backend -> UI) and prevents circular dependencies.
  • Provides a self-contained bead description suitable for fresh-agent execution.
  • Supports creating or polishing beads from a source PRD for Ralph-TUI runs.

Quick Start

Run the bead polishing workflow for Ralph-TUI beads against the current PRD to converge to one-context beads.

Frequently Asked Questions about bead-polishing-ralph

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

FAQPage Schema
How do I refine beads for Ralph-TUI to fit within a single agent context window?

Bead polishing iteratively refines Ralph-TUI beads through 4-6 rounds until convergence, ensuring each bead fits one agent context window. This prevents execution stalls caused by oversized beads exceeding context limits.

What quality gates are appended to beads during the polishing workflow?

Bead polishing appends universal quality gates and explicit acceptance criteria to every bead. It validates size constraints, dependency integrity, description completeness, and alignment with the source PRD.

How do I manage dependency ordering when polishing beads for Ralph-TUI execution?

Bead polishing guides dependency ordering following schema-backend-UI sequence and prevents circular dependencies. Correct bd/br CLI syntax is enforced to maintain dependency integrity across the workflow.

Can I create beads from a source PRD or only polish existing ones?

Bead polishing supports both creating and polishing beads from a source PRD for Ralph-TUI runs. It produces self-contained bead descriptions suitable for fresh-agent execution without additional context.

Why does my Ralph-TUI bead execution stall on oversized beads?

Execution stalls occur when beads exceed a single agent context window. Bead polishing enforces one-context-window bead size through iterative refinement rounds, preventing stalls and ensuring convergence.

Does bead polishing work with the Agentic Coding Flywheel workflow?

Bead polishing supports end-to-end bead refinement workflows within the Agentic Coding Flywheel. It applies to polishing tasks for Ralph-TUI beads, quality gates, and dependency management across the flywheel.