docs(roadmap): consolidate architect guidance file to avoid clobber#625
Open
donbeave wants to merge 1 commit into
Open
docs(roadmap): consolidate architect guidance file to avoid clobber#625donbeave wants to merge 1 commit into
donbeave wants to merge 1 commit into
Conversation
The token-optimisation stack (caveman + RTK + headroom, jackin-the-architect PR #139) now ships a single `token-optimization.md` to `~/.claude/CLAUDE.md`, `~/.codex/AGENTS.md`, `~/.config/amp/AGENTS.md`, `~/.kimi-code/AGENTS.md`, and `~/.grok/AGENTS.md`. The code-intelligence pilot's plan to `COPY code-intelligence.md` to those same paths would clobber it (last COPY wins) and break its own `sha256sum` smoke check — the "no global ~/.claude/CLAUDE.md exists" assumption no longer holds. Record the decision: the code-intelligence router is a section appended into that one consolidated guidance file, not a competing COPY. Reconcile the per-runtime path list with the stack's (amp at ~/.config/amp/AGENTS.md, opencode's AGENTS.md owned by the caveman plugin, kimi at ~/.kimi-code/AGENTS.md, grok at ~/.grok/AGENTS.md) and fix the now-stale `sha256sum` check and default-home note to match. No status change; decision-record update only. Signed-off-by: Alexey Zhokhov <alexey@zhokhov.com> Signed-off-by: Alexey Zhokhov <alexey@chainargos.com> Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Co-authored-by: Claude <noreply@anthropic.com>
11 tasks
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.
What
Updates the architect code-intelligence tooling roadmap decision record so the (still-unimplemented) code-intelligence pilot does not clobber the guidance file the token-optimisation stack now ships.
Why
jackin-the-architect PR #139 (caveman + RTK + headroom) writes a single
token-optimization.mdto~/.claude/CLAUDE.md,~/.codex/AGENTS.md,~/.config/amp/AGENTS.md,~/.kimi-code/AGENTS.md, and~/.grok/AGENTS.md. The pilot's documented plan toCOPY code-intelligence.mdto~/.claude/CLAUDE.md+~/.codex/AGENTS.mdwould overwrite it (lastCOPYwins) and break the pilot's ownsha256sumsmoke check. The roadmap's "no global~/.claude/CLAUDE.mdexists today" assumption is no longer true.Change
~/.config/amp/AGENTS.md, opencode'sAGENTS.mdowned by the caveman plugin, kimi →~/.kimi-code/AGENTS.md, grok →~/.grok/AGENTS.md).sha256sumverification line and default-home note.Decision-record content only — no roadmap Status change, no sidebar/overview/file change, so the roadmap freshness gates are not triggered.
🤖 Generated with Claude Code