Skip to content
cccskills
FreePublished on GitHub

to-issues

Break a plan/PRD into independent vertical-slice Beads issues with explicit dependencies.

The English summary is being prepared. Showing the original description.

See how to install

Files included (1)

  • SKILL.md2.2 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

to-issues

Convert a plan, PRD, or feature brief into small, independently executable Beads tasks.

When to use

  • User asks to break work into tickets/issues.
  • You have a PRD/plan and need execution-ready slices.

Process

1) Gather source context

Use available material first:

  • Conversation context
  • PRD/plan text
  • Existing bead (bd show <id>)
  • Relevant codebase context

If user provides an external issue/URL, map it into local context before decomposition.

2) Draft tracer-bullet vertical slices

Each slice must be an end-to-end path through relevant layers (contract, logic, integration, verification), not a single-layer chunk.

Rules:

  • Demoable/verifiable on its own
  • Prefer many thin slices over few large slices
  • Minimize cross-slice coupling
  • Mark slices as:
    • AFK: can execute without user intervention
    • HITL: requires human decision/review checkpoint

3) Review slice plan with user

Present a numbered list with:

  • Title
  • Type (AFK/HITL)
  • Blocked by (if any)
  • User stories covered (if source has stories)

Refine until approved.

4) Create Beads issues

Create issues in dependency order so blockers exist first.

Use this issue body format:

<issue-template> ## What to build Concise vertical-slice behavior description.

Acceptance criteria

  • Criterion 1
  • Criterion 2
  • Criterion 3

Blocked by

  • None - can start immediately or
  • <bead-id>

Notes

  • Type: AFK/HITL
  • Risks or assumptions </issue-template>

Commands:

bd create --type task --title "<slice title>" --description "<template markdown>" --priority 2 --repo .
bd dep add <blocked-id> <slice-id>   # the blocked issue first: it depends on the slice that blocks it

If slices derive from a parent PRD/feature, attach children:

bd create --type task --parent <parent-id> --title "<slice title>" --description "<template markdown>" --priority 2 --repo .

5) Validate and report

  • Verify dependency graph (bd children <parent-id> and/or bd graph)
  • Confirm no orphaned critical-path work
  • Add worklog: comment to parent summarizing decomposition decisions

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Capture free-text work as a tracked Beads issue. Use when the user runs /add-bead or wants to quickly file a Beads issue.

The English summary is being prepared. Showing the original description.

jupes/agent-forge-harness2Updated Oct 19, 2026

Register a new sub-repo in the knowledge base.

The English summary is being prepared. Showing the original description.

jupes/agent-forge-harness2Updated Oct 19, 2026

Add focused Bun unit tests for mission-critical behavior and edge cases — not blanket coverage.

The English summary is being prepared. Showing the original description.

jupes/agent-forge-harness2Updated Oct 19, 2026

ask

Free

Answer questions about the codebase from knowledge files. Use when the user runs /ask or asks a domain/knowledge question about the repos.

The English summary is being prepared. Showing the original description.

jupes/agent-forge-harness2Updated Oct 19, 2026

Meta-skill for creating Agent Forge skills under .claude/skills/ with SKILL.md, optional references/ and scripts/, and Bun scaffolds. Use when the user wants to add or author a skill, scaffold a new skill folder, or align skill docs with harness conventions (JSON script output, Beads for tasks).

The English summary is being prepared. Showing the original description.

jupes/agent-forge-harness2Updated Oct 19, 2026

Choose Beads issue priority (P0–P4, numeric, or named) from urgency, impact, and risk when creating or triaging work.

The English summary is being prepared. Showing the original description.

jupes/agent-forge-harness2Updated Oct 19, 2026

See all skills by jupes

Report a problem with this skill