Bruno Postle
e37930605e
Follow-up to the previous commit: user flagged that quality_width/ quality_proportion's "stricter of both" (max target, min sigma) combination for a fused leaf's two codes was an ad hoc hack. Tried two more principled alternatives and A/B'd all three against the harbor-house/health-centre example programmes (20k evals x 3 seeds each): 1. stricter-of-both (original) -> health-centre +24.5% worse 2. precision-weighted Gaussian product -> health-centre -13.9% better 3. mixture (max of two Gaussians) -> health-centre +20.4% worse Landed #2 (fitness._gaussian_product): combining two Gaussian evidence sources about the same quantity via precision-weighting gives an intermediate target with a narrower spread, unlike the naive max/min hack. #3's building block (_clipped_gaussian) is kept, documented, and unit-tested as a recorded negative alternative -- somewhat counterintuitively, the more philosophically appealing "let the leaf collapse toward whichever code fits" mixture model was empirically worse, because max() lets a leaf score 1.0 by satisfying only the weaker of the two codes' targets. multi_use stays default OFF -- the precision-weighted result improves both example programmes on average but isn't the clean sweep needed for a default flip (harbor-house loses 1/3 seeds). DESIGN.md §33 rewritten with the full three-way comparison. Co-Authored-By: Claude Sonnet 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01R8agJBT2ZpmF3ErW7wi2wY |
||
|---|---|---|
| .. | ||
| hooks | ||
| .gitignore | ||
| config.yaml | ||
| issues.jsonl | ||
| metadata.json | ||
| README.md | ||
Beads - AI-Native Issue Tracking
Welcome to Beads! This repository uses Beads for issue tracking - a modern, AI-native tool designed to live directly in your codebase alongside your code.
What is Beads?
Beads is issue tracking that lives in your repo, making it perfect for AI coding agents and developers who want their issues close to their code. No web UI required - everything works through the CLI and integrates seamlessly with git.
Learn more: github.com/steveyegge/beads
Quick Start
Essential Commands
# Create new issues
bd create "Add user authentication"
# View all issues
bd list
# View issue details
bd show <issue-id>
# Update issue status
bd update <issue-id> --claim
bd update <issue-id> --status done
# Sync with Dolt remote
bd dolt push
Working with Issues
Issues in Beads are:
- Git-native: Stored in Dolt database with version control and branching
- AI-friendly: CLI-first design works perfectly with AI coding agents
- Branch-aware: Issues can follow your branch workflow
- Always in sync: Auto-syncs with your commits
Why Beads?
✨ AI-Native Design
- Built specifically for AI-assisted development workflows
- CLI-first interface works seamlessly with AI coding agents
- No context switching to web UIs
🚀 Developer Focused
- Issues live in your repo, right next to your code
- Works offline, syncs when you push
- Fast, lightweight, and stays out of your way
🔧 Git Integration
- Automatic sync with git commits
- Branch-aware issue tracking
- Dolt-native three-way merge resolution
Get Started with Beads
Try Beads in your own projects:
# Install Beads
curl -sSL https://raw.githubusercontent.com/steveyegge/beads/main/scripts/install.sh | bash
# Initialize in your repo
bd init
# Create your first issue
bd create "Try out Beads"
Learn More
- Documentation: github.com/steveyegge/beads/docs
- Quick Start Guide: Run
bd quickstart - Examples: github.com/steveyegge/beads/examples
Beads: Issue tracking that moves at the speed of thought ⚡