docs: split reference sections out of AGENTS.md#506
Merged
Conversation
Move the situational/procedural reference material out of AGENTS.md into docs/ and leave one-line pointers in their place, keeping the always-loaded guidelines file focused on the terse guardrail rules that shape every change. - Debugging And QA details + the scripts/bb-dev-app local dev QA launcher how-to -> docs/debugging-and-qa.md - CLI/guide/skill surface-sync checklist -> docs/cli-guide-and-skill.md Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Move the situational/procedural reference material out of
AGENTS.mdintodocs/and leave one-line pointers in its place, so the always-loaded guidelines file stays focused on the terse guardrail rules that shape every change.What moved
scripts/bb-dev-applocal dev QA launcher how-to →docs/debugging-and-qa.md. Kept the "observe real state, don't assume" rule inline plus a pointer.docs/cli-guide-and-skill.md. Kept the core "keep discoverable surfaces in sync" rule inline plus a pointer.What stayed inline
The terse guardrails that constrain code directly: Simplicity, Types And Contracts, Server/Daemon boundaries, Data Access, UI theming, Build/Typecheck, Testing.
🤖 Generated with Claude Code