Files

Steve Yegge 584608a14e feat: add llms.txt standard support for AI agent discoverability (#784 )

Cherry-picked website/, scripts/generate-llms-full.sh, and deploy-docs.yml
from joyshmitz's PR. Fixed workflow to trigger on main branch instead of
docs/docusaurus-site.

Features:
- Docusaurus documentation site with llms.txt support
- Environment-variable driven config (defaults to steveyegge org)
- Automated llms-full.txt generation from docs
- GitHub Pages deployment workflow

Co-authored-by: joyshmitz <joyshmitz@users.noreply.github.com>

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

Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>

Executed-By: beads/crew/dave
Rig: beads
Role: crew

2025-12-30 18:27:50 -08:00

2.3 KiB

Raw Blame History

id, title, sidebar_position

id	title	sidebar_position
wisps	Wisps	5

Wisps

Wisps are ephemeral workflows that don't sync to git.

What are Wisps?

Wisps are "vapor phase" molecules:

Stored in .beads-wisp/ (gitignored)
Don't sync with git
Auto-expire after completion
Perfect for temporary operations

Use Cases

Scenario	Why Wisp?
Local experiments	No need to pollute git history
CI/CD pipelines	Ephemeral by nature
Scratch workflows	Quick throwaway work
Agent coordination	Local-only coordination

Creating Wisps

# Create wisp from formula
bd wisp create <formula> [--var key=value]

# Example
bd wisp create quick-check --var target=auth-module

Wisp Commands

# List wisps
bd wisp list
bd wisp list --json

# Show wisp details
bd wisp show <wisp-id>

# Delete wisp
bd wisp delete <wisp-id>

# Delete all completed wisps
bd wisp cleanup

Wisp vs Molecule

Aspect	Molecule	Wisp
Storage	`.beads/`	`.beads-wisp/`
Git sync	Yes	No
Persistence	Permanent	Ephemeral
Use case	Tracked work	Temporary ops

Phase Control

Use bd mol bond to control phase:

# Force liquid (persistent molecule)
bd mol bond <formula> <target> --pour

# Force vapor (ephemeral wisp)
bd mol bond <formula> <target> --wisp

Example: Quick Check Workflow

Create a wisp for running checks:

# .beads/formulas/quick-check.formula.toml
formula = "quick-check"
description = "Quick local checks"

[[steps]]
id = "lint"
title = "Run linter"

[[steps]]
id = "test"
title = "Run tests"
needs = ["lint"]

[[steps]]
id = "build"
title = "Build project"
needs = ["test"]

Use as wisp:

bd wisp create quick-check
# Work through steps...
bd wisp cleanup  # Remove when done

Auto-Expiration

Wisps can auto-expire:

[wisp]
expires_after = "24h"  # Auto-delete after 24 hours

Or cleanup manually:

bd wisp cleanup --all  # Remove all wisps
bd wisp cleanup --completed  # Remove only completed

Best Practices

Use wisps for local-only work - Don't sync to git
Clean up regularly - bd wisp cleanup
Use molecules for tracked work - Wisps are ephemeral
Consider CI/CD wisps - Perfect for pipeline steps

2.3 KiB Raw Blame History