beads/docs
Steve Yegge e7fd1dd3b6 Document files created by bd init and clarify .gitattributes should be committed
Fixes #299

Added comprehensive documentation to help new users understand what files
should be committed vs ignored after running bd init:

1. README.md:
   - New "Files Created by bd init" section
   - Clear lists of files to commit vs ignore
   - Explains purpose of .gitattributes for team collaboration

2. docs/GIT_INTEGRATION.md:
   - Enhanced .gitattributes section with IMPORTANT notice
   - Explains why it must be committed (merge driver config)
   - Lists benefits of intelligent JSONL merging

Key clarification: .gitattributes should be COMMITTED (not ignored) as it
configures git merge behavior for the entire team.

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

Co-Authored-By: Claude <noreply@anthropic.com>
2025-11-20 21:29:20 -05:00
..
adr feat(agent-mail): Add Python adapter library for Agent Mail integration 2025-11-08 00:15:07 -08:00
ADAPTIVE_IDS.md Implement adaptive ID length scaling (bd-ea2a13) 2025-10-30 21:40:52 -07:00
ADVANCED.md Fix #264 and #262: Remove stale --resolve-collisions references 2025-11-08 13:18:50 -08:00
AGENT_MAIL.md docs: Add comprehensive Agent Mail integration guide 2025-11-08 00:49:41 -08:00
AGENT_MAIL_DEPLOYMENT.md Add Agent Mail multi-workspace deployment guide and scripts 2025-11-08 04:16:44 -08:00
AGENT_MAIL_MULTI_WORKSPACE_SETUP.md Add Agent Mail multi-workspace deployment guide and scripts 2025-11-08 04:16:44 -08:00
AGENT_MAIL_QUICKSTART.md Complete Agent Mail documentation (bd-nl8z) 2025-11-08 02:36:27 -08:00
ARCHITECTURE.md Fix race condition in auto-flush mechanism (issue bd-52) 2025-11-20 21:24:31 -05:00
ATTRIBUTION.md Reorganize project structure: move Go files to internal/beads, docs to docs/ 2025-11-05 21:04:00 -08:00
CLAUDE.md Fix #264 and #262: Remove stale --resolve-collisions references 2025-11-08 13:18:50 -08:00
CLI_REFERENCE.md Refactor AGENTS.md: extract supplemental docs 2025-11-08 01:03:28 -08:00
COLLISION_MATH.md Remove obsolete collision remapping code and tests 2025-10-31 00:19:42 -07:00
CONFIG.md Reorganize project structure: move Go files to internal/beads, docs to docs/ 2025-11-05 21:04:00 -08:00
contributor-workflow-analysis.md docs: Complete multi-repo documentation gaps 2025-11-05 14:19:11 -08:00
DAEMON.md Refactor AGENTS.md: extract supplemental docs 2025-11-08 01:03:28 -08:00
EXCLUSIVE_LOCK.md Reorganize project structure: move Go files to internal/beads, docs to docs/ 2025-11-05 21:04:00 -08:00
EXTENDING.md Fix SQLite driver name mismatch causing "unknown driver" errors (#252) 2025-11-07 14:19:14 -08:00
FAQ.md Fix #264 and #262: Remove stale --resolve-collisions references 2025-11-08 13:18:50 -08:00
GIT_INTEGRATION.md Document files created by bd init and clarify .gitattributes should be committed 2025-11-20 21:29:20 -05:00
HASH_ID_DESIGN.md Document external_ref in content hash behavior (bd-9f4a) 2025-11-08 02:22:15 -08:00
import-bug-analysis-bd-3xq.md Add import bug analysis for bd-3xq 2025-11-04 12:25:53 -08:00
INSTALLING.md Add uv prerequisite to Claude Code plugin documentation (#293) 2025-11-12 10:49:38 -08:00
LABELS.md Reorganize project structure: move Go files to internal/beads, docs to docs/ 2025-11-05 21:04:00 -08:00
LINTING.md Document -short flag, update linting baseline, clarify bd edit MCP exclusion 2025-11-06 19:42:01 -08:00
MULTI_REPO_AGENTS.md Add multi-repo patterns documentation for AI agents (bd-4b6u) 2025-11-06 19:53:29 -08:00
MULTI_REPO_HYDRATION.md Extract SQLite migrations into separate files (bd-fb95094c.7) 2025-11-06 20:06:45 -08:00
MULTI_REPO_MIGRATION.md feat: Add bd init --contributor and --team wizards 2025-11-05 19:04:14 -08:00
PLUGIN.md Reorganize project structure: move Go files to internal/beads, docs to docs/ 2025-11-05 21:04:00 -08:00
PROTECTED_BRANCHES.md Add comprehensive protected branch workflow documentation (bd-5ce8) 2025-11-02 18:41:51 -08:00
QUICKSTART.md Fix #349: Improve compact error messages, remove bogus merge suggestion, add daemon/maintenance docs 2025-11-20 20:58:57 -05:00
README_TESTING.md Reorganize project structure: move Go files to internal/beads, docs to docs/ 2025-11-05 21:04:00 -08:00
RELEASING.md Fix RELEASING.md: Homebrew formula uses GoReleaser artifacts, not source tarball 2025-11-08 03:59:59 -08:00
ROUTING.md Add routing integration tests and documentation 2025-11-04 23:12:42 -08:00
TEST_OPTIMIZATION.md Reorganize project structure: move Go files to internal/beads, docs to docs/ 2025-11-05 21:04:00 -08:00
TROUBLESHOOTING.md Fix #264 and #262: Remove stale --resolve-collisions references 2025-11-08 13:18:50 -08:00
vc-feedback-on-multi-repo.md new design docs 2025-11-03 20:54:00 -08:00