- 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>
46 lines
1.1 KiB
Markdown
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`
|