[docs] Consolidate developer specs into dev.md v4.2#22653
Merged
Conversation
- Add engine-specific capability notes: max-turns is Claude/Custom only (not supported by Copilot); firewall support matrix across engines - Add Related Documentation links for token-budget-guidelines.md and actions.md (Custom GitHub Actions Build System) - Bump version to v4.2, update coverage to 62 spec files Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
github-actions
bot
added
automation
documentation
pelikhan
deleted the
docs/consolidate-dev-specs-2026-03-24-8e24cdd75a2c2400
branch
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.
Developer documentation consolidation run for 2026-03-24.
Changes Made
max-turnsis supported by Claude and Custom engines only (not Copilot);firewallsupport matrix across enginestoken-budget-guidelines.md(max-turns restrictions, timeout-minutes config, Copilot prompt optimization) andactions.md(Custom Go-based actions build system)Files Modified
scratchpad/dev.md(v4.1 → v4.2, +7 lines)Validation
✅ All 62 spec files analyzed for tone — zero issues found
✅ Consistent technical tone throughout dev.md
✅ No broken links introduced
✅ Mermaid diagrams unchanged (10 retained)
Context
The
max-turnsengine restriction (Claude/Custom only, not Copilot) was documented intoken-budget-guidelines.mdbut absent from the consolidateddev.md. This is a critical note for developers using Copilot workflows who might mistakenly configuremax-turns. Theactions.mdspec (1044 lines, Custom GitHub Actions Build System) was also previously unlinked.Triggered by commit
2379b27(feat: wrap qmd documentation index step summary in details/summary HTML section #22623).