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

46 lines
1.1 KiB
Markdown

# 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):**
```bash
bd wisp create skills-fvc --var target=src/main.py
```
**Pour as molecule (persistent):**
```bash
bd pour skills-fvc --var target=src/main.py
```
**After completion:**
```bash
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`