skills/workflows/README.md
dan fb15000877 refactor: restructure for cross-repo deployment
- Rename reviews/ to lenses/ (clearer terminology)
- Add workflows/ for beads proto templates
- Extract code-review proto to workflows/molecules.jsonl
- Update ai-skills.nix module:
  - Add enableLenses option (deploys to ~/.config/lenses/)
  - Add enableWorkflows option (deploys to ~/.beads/molecules.jsonl)
  - Derive repoRoot from skillsPath for sibling directories
- Update lens paths in proto to use deployed location

🤖 Generated with [Claude Code](https://claude.com/claude-code)

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
2025-12-26 01:18:19 -05:00

1.1 KiB

Workflows

Beads molecule templates (protos) for structured agent workflows.

Concept

  • Proto: A template workflow that can be instantiated
  • Molecule: A persistent instance of a proto
  • Wisp: An ephemeral instance (local-only, not synced)

Available Protos

ID Name Variables
skills-fvc Code Review: {{target}} target

Usage

Spawn as wisp (ephemeral):

bd wisp create skills-fvc --var target=src/main.py

Pour as molecule (persistent):

bd pour skills-fvc --var target=src/main.py

After completion:

bd mol squash <molecule-id>  # Compress to digest
bd mol burn <molecule-id>    # Delete without trace

Deployment

These protos are deployed to ~/.beads/molecules.jsonl via home-manager, making them available in any repository.

Creating New Protos

  1. Create an epic with child tasks using bd create
  2. Use {{variable}} placeholders in titles/descriptions
  3. Add the template label: bd label add <epic-id> template
  4. Export to workflows/molecules.jsonl