matt wilkie
6e506b6ddd
Add PR preflight and contributor intake guidance ( #3470 )
...
* Handle legacy PR status contexts
* docs: add contributor PR intake checklist
* docs: wire PR preflight into agent guidance
2026-04-24 15:44:06 -07:00
cwalv
e31428f053
docs: replace "git-backed" with "Dolt-powered", add git-free usage guide
...
Beads' storage backend is Dolt, not git. Git integration (hooks, repo
discovery, identity) is optional — `BEADS_DIR` + `--stealth` provides
fully functional git-free operation with zero git calls.
Changes across 15 files:
- Replace all "git-backed" references with "Dolt-powered" or "Dolt-backed"
- Add "Git-Free Usage" section to README.md documenting BEADS_DIR + --stealth
- Fix stale "JSONL" storage reference in llms-full.txt
- Update SKILL.md to mark git as optional prerequisite
Complements GH#2522 (stale command cleanup) — that PR fixed removed
commands, this one fixes misleading storage backend framing.
2026-03-13 11:44:50 -07:00
matt wilkie
1c5423637d
docs: replace bd sync with bd dolt push/pull in agent instructions (GH#2563)
...
bd sync has been a deprecated no-op since v0.51. Two agent instruction
files still actively directed agents to use it:
- .agent/workflows/resolve-beads-conflict.md
- .github/copilot-instructions.md
Remaining references in CHANGELOG, DISCOVERY.md, audit docs, and
claude-plugin deprecation notices are intentionally preserved as
historical/redirect documentation.
Amp-Thread-ID: https://ampcode.com/threads/T-019ce85a-0496-70fd-afdc-7e066f2f5826
Co-authored-by: Amp <amp@ampcode.com>
2026-03-13 11:01:06 -07:00
beads/crew/elinor
90da8f6028
docs: remove stale JSONL references from ~73 markdown files (bd-9ni.4)
...
Replace JSONL storage/sync references with Dolt-native equivalents across
documentation, plugin resources, website docs, agent instructions, and
example READMEs. Preserves legitimate JSONL references (bd import/export
commands, CHANGELOG history, routes.jsonl/interactions.jsonl concepts).
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-22 22:18:02 -08:00
topaz
062aedbed7
docs: remove stale daemon references from all documentation (GH#1982)
...
Sweep 65 markdown files across docs/, website/, claude-plugin/, examples/,
integrations/, and root to replace removed `bd daemon` references with
current Dolt server mode equivalents. CHANGELOG.md preserved per policy.
Key replacements:
- `bd daemon start/stop/status` → `bd dolt start/stop` / `bd doctor`
- `bd daemons killall/health/logs` → `bd dolt stop` / `bd doctor`
- `--no-daemon` flag → removed (embedded mode is default)
- `BEADS_NO_DAEMON` / `BEADS_DAEMON_MODE` env vars → removed
- `.beads/bd.sock` → removed
- "daemon mode" / "direct mode" → "server mode" / "embedded mode"
- daemon.pid/daemon.log → .beads/dolt/sql-server.pid/.log
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Executed-By: beads/polecats/topaz
Rig: beads
Role: polecats
2026-02-22 17:57:53 -08:00
beads/crew/jane
34fa1c1239
refactor(sync): make bd sync a deprecated no-op, update agent instructions
...
bd sync was calling CommitPending + Push on every invocation, causing
perceived slowness when agents call it at high velocity. Now prints a
deprecation message and exits immediately without opening the database.
Updated AGENTS.md, AGENT_INSTRUCTIONS.md, SKILL.md, copilot-instructions,
and init templates to reference bd dolt push/pull instead.
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
2026-02-21 19:07:02 -08:00
Valeriy Pavlovich
4f3b6591b0
docs: use --claim when starting work ( #1920 )
2026-02-20 09:22:13 -08:00
emma
85ba9bd49f
cleanup: remove stale sqlite refs, fix lint warnings, update Makefile benchmarks
...
- Remove .golangci.yml rule for deleted internal/storage/sqlite/ files
- Update Makefile bench/bench-quick targets from sqlite to dolt backend
- Remove stale SQLite-only CGO comment in Makefile
- Update copilot-instructions.md: storage is now Dolt, not SQLite
- Update AGENT_INSTRUCTIONS.md: remove sqlite/ from directory layout
- Fix unparam lint: performContentMerge error return was always nil
- Fix gosec G204: annotate readFromGitRef exec.Command as safe
Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>
Executed-By: beads/crew/emma
Rig: beads
Role: crew
2026-02-16 00:49:18 -08:00
Steve Yegge
bf74160f05
Fix GH#366: Encourage descriptions when creating issues
...
Addresses GitHub Discussion #366 where users reported Claude Code
creating issues with titles but no descriptions.
Two-pronged solution:
1. Documentation improvements (bd-na8r):
- Updated AGENTS.md with prominent guidance section
- Added good/bad examples showing why/what/how to include
- Updated all bd create examples to include --description
- Enhanced MCP tool docstring with importance note
- Updated .github/copilot-instructions.md
2. Code validation (bd-bcrt):
- Added friendly yellow warning when description is empty
- Warning skips test issues (title contains "test")
- Works in both CLI and daemon modes
- Non-blocking to preserve quick workflows
Evidence from our own projects showed significant empty description
rates:
- ~/src/beads: 110/630 (17.5%)
- ~/wyvern: 8/119 (6.7%)
- ~/src/vc: 3/170 (1.8%)
Fixes bd-0tr0, bd-na8r, bd-bcrt
🤖 Generated with [Claude Code](https://claude.com/claude-code )
Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-23 14:14:40 -08:00
Steve Yegge
605fff151e
feat: Add GitHub Copilot support with .github/copilot-instructions.md
...
Addresses GH #298 - GitHub Copilot inconsistently interpreting AGENTS.md
Changes:
- Create .github/copilot-instructions.md (132 lines, Copilot-optimized)
- Update AGENTS.md with prominent Copilot callout
- Enhance bd onboard command to generate copilot-instructions.md
Architecture: Two-file approach for different AI agents
- AGENTS.md (626 lines): Comprehensive guide for all AI agents
- .github/copilot-instructions.md (132 lines): Concise, auto-loaded for Copilot
Note: Untested with GitHub Copilot yet. Feedback from Copilot users welcome!
Co-authored-by: Claude <noreply@anthropic.com>
2025-11-21 20:52:18 -05:00