Repository navigation
feat(code-context): docs may not match the code; say what the history shows (0.2.18) - #42
Merged
Merged
Conversation
… shows (0.2.18) doable-answer-questions now tells the agent never to assume the workspace's docs match its code. A README, docs page, spec, changelog or comment only routes the search; implemented behavior comes from inspected code alone, and a doc never fills in a step, label, route or outcome the code does not show. When a doc disagrees with the code, the agent reads the history of both and says in the conflict which one changed later and whether that change says it was intended, in product words with no commit ids, branch names or dates. It submits both findings and the conflict either way and does not decide which is wrong. Replay on trd's crewdesk-drift fixture (Opus 5.5, 4 runs per arm): stale README claims flagged 20/20 (0.2.17: 5/20), newer release notes wrongly called stale 0/4. Change Set: getdoable/trd docs/change-sets/code-context-stale-docs-history.yaml. Co-Authored-By: Claude Opus 5.5 <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
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.
Server side: getdoable/trd#715 (the same rule in the Round's question text).
What changes in behavior
doable-answer-questionsgains one answer rule. The agent must never assume the workspace's docs match its code:docs/page, spec, changelog or code comment only routes the search.implemented_behaviorcomes from inspected code alone.The new requirement costs one or two extra read-only
git log/git showcalls when docs and code disagree. No schema change: the history rides in the existing conflict description. A doc claim still arrives asdesired_behavior.Tests
npm test: release verifier for 0.2.18, workflow check, node tests 6/6.Version 0.2.18. TESTING.md scenario 32.
🤖 Generated with Claude Code