[nixos-configs-7hd] Add Claude skill for parallel bead processing workflow #11

Merged
johno merged 3 commits from bead/nixos-configs-7hd into main 2026-01-10 11:43:14 -08:00
Owner

Summary

Add a Claude skill that orchestrates parallel bead processing using subagents.

Bead Reference

Implements bead: nixos-configs-7hd

Changes

  • Add home/roles/development/skills/ directory for local Claude skills
  • Create parallel_beads.md skill with 4-phase workflow:
    1. Selection: Multi-select beads from bd ready output
    2. Implementation: Parallel subagents create worktrees, implement, commit, push, and open PRs
    3. Review: Parallel subagents review each PR against acceptance criteria
    4. Cleanup: Remove worktrees and provide summary with PR links/status
  • Update default.nix to install local skills alongside humanlayer plugins
  • Support both gh (GitHub) and tea (Gitea/Forgejo) based on origin URL detection

Acceptance Criteria

  • Skill is added to home development role configuration
  • Skill prompts user with multi-select for bead selection
  • Subagents create isolated worktrees for each bead
  • Subagents work until acceptance criteria met or report blockers
  • Changes are committed and pushed
  • PRs are opened automatically
  • PR descriptions reference the bead ID
  • PR descriptions include linked external issue numbers from the bead
  • Review subagents provide meaningful feedback
  • Worktrees are cleaned up after completion
  • Final summary includes PR links, status, and any failures
## Summary Add a Claude skill that orchestrates parallel bead processing using subagents. ## Bead Reference Implements bead: nixos-configs-7hd ## Changes - Add `home/roles/development/skills/` directory for local Claude skills - Create `parallel_beads.md` skill with 4-phase workflow: 1. **Selection**: Multi-select beads from `bd ready` output 2. **Implementation**: Parallel subagents create worktrees, implement, commit, push, and open PRs 3. **Review**: Parallel subagents review each PR against acceptance criteria 4. **Cleanup**: Remove worktrees and provide summary with PR links/status - Update `default.nix` to install local skills alongside humanlayer plugins - Support both `gh` (GitHub) and `tea` (Gitea/Forgejo) based on origin URL detection ## Acceptance Criteria - [x] Skill is added to home development role configuration - [x] Skill prompts user with multi-select for bead selection - [x] Subagents create isolated worktrees for each bead - [x] Subagents work until acceptance criteria met or report blockers - [x] Changes are committed and pushed - [x] PRs are opened automatically - [x] PR descriptions reference the bead ID - [x] PR descriptions include linked external issue numbers from the bead - [x] Review subagents provide meaningful feedback - [x] Worktrees are cleaned up after completion - [x] Final summary includes PR links, status, and any failures
johno added 4 commits 2026-01-10 11:15:07 -08:00
- Add skills/ directory for local Claude skills
- Create parallel_beads.md skill that orchestrates:
  - Phase 1: Multi-select bead selection from bd ready
  - Phase 2: Parallel subagents for implementation (worktree, implement, commit, PR)
  - Phase 3: Parallel review subagents
  - Phase 4: Cleanup and summary
- Update default.nix to install local skills alongside humanlayer plugins
- Support both gh (GitHub) and tea (Gitea/Forgejo) based on origin URL
johno reviewed 2026-01-10 11:18:39 -08:00
@@ -88,0 +89,4 @@
for file in ${./skills}/*.md; do
if [ -f "$file" ]; then
filename=$(basename "$file" .md)
dest="$HOME/.claude/commands/humanlayer:''${filename}.md"
Author
Owner

we don't need the humanlayer prefix here

we don't need the humanlayer prefix here
Author
Owner

test reply

test reply
johno added 1 commit 2026-01-10 11:21:42 -08:00
Local skills don't need the humanlayer: prefix since they're not
from the humanlayer/claude-plugins repo.
Author
Owner

Fixed in 0e5b11e - removed the humanlayer: prefix from local skills.

Fixed in 0e5b11e - removed the humanlayer: prefix from local skills.
johno reviewed 2026-01-10 11:24:14 -08:00
johno left a comment
Author
Owner

Fixed in 0e5b11e - removed the humanlayer: prefix from local skills.

Fixed in 0e5b11e - removed the humanlayer: prefix from local skills.
johno reviewed 2026-01-10 11:24:25 -08:00
johno left a comment
Author
Owner

Fixed in 0e5b11e - removed the humanlayer: prefix from local skills.

Fixed in 0e5b11e - removed the humanlayer: prefix from local skills.
johno merged commit 0e5b11e55d into main 2026-01-10 11:43:14 -08:00
Sign in to join this conversation.
No Reviewers
No Label
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: johno/nixos-configs#11