Refactor AGENTS.md: Extract detailed instructions to prevent context pollution

Fixes #340

Created AGENT_INSTRUCTIONS.md to house detailed operational instructions,
reducing AGENTS.md from 963 to 626 lines (~35% reduction).

Changes:
- New AGENT_INSTRUCTIONS.md with development, testing, and release procedures
- AGENTS.md now serves as quick overview with references to detailed docs
- Updated README.md link to "Landing the Plane" section
- Fixed broken team-workflow README links

Benefits:
- Prevents context pollution when multiple tools add instructions
- Better separation: quick reference vs detailed operations
- Enables tool-specific instruction files
- Maintains all content, just reorganized

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

Co-Authored-By: Claude <noreply@anthropic.com>
This commit is contained in:
Steve Yegge
2025-11-20 22:04:17 -05:00
parent be37a13ceb
commit 21a0656a4c
4 changed files with 412 additions and 366 deletions

View File

@@ -255,7 +255,7 @@ git checkout --ours .beads/beads.jsonl
bd import -i .beads/beads.jsonl
# Option 3: Use beads-merge tool (recommended)
# See AGENTS.md for beads-merge integration
# See docs/GIT_INTEGRATION.md for merge conflict resolution
git add .beads/beads.jsonl
git commit
@@ -369,7 +369,7 @@ bd daemon start --auto-commit --auto-push
### Issue: Merge conflicts in JSONL
Use beads-merge (see [AGENTS.md](../../AGENTS.md#advanced-intelligent-merge-tools)) or resolve manually:
Use beads-merge or resolve manually (see [GIT_INTEGRATION.md](../../docs/GIT_INTEGRATION.md)):
```bash
git checkout --theirs .beads/beads.jsonl
@@ -399,4 +399,4 @@ bd validate --checks=conflicts
- [Protected Branch Setup](../protected-branch/)
- [Contributor Workflow](../contributor-workflow/)
- [Multi-Repo Migration Guide](../../docs/MULTI_REPO_MIGRATION.md)
- [Advanced Merge Tools](../../AGENTS.md#advanced-intelligent-merge-tools)
- [Git Integration Guide](../../docs/GIT_INTEGRATION.md)