docs(troubleshooting): add Grok Claude-compat Hook workaround - #63
Merged
Conversation
Document how to disable Claude hook scanning and use ~/.grok/hooks until AgentKit folds global settings commands. Do not recommend editing AgentKit-managed settings.json.
The new troubleshooting route is published on beta and stable, EN+VI. Bump reviewed source/built/search counts by one per channel so check:quality:shape matches the authored tree.
thieung
marked this pull request as ready for review
August 13, 2026 10:54
thieung
added a commit
that referenced
this pull request
Aug 13, 2026
* docs: beta v2.13.0-beta.2 release update (#62) * docs: beta v2.13.0-beta.2 release update Syncs beta channel to v2.13.0-beta.2 via sync-release.mjs (171 reference files, ak-gui asset metadata refreshed for 4 platforms). Adds the new ak orchestrate command group (start / resume / status / stop) as EN+VI prose, mirrored into content/docs/stable/** for whole-copy parity. Updates ak config prefs set/unset and index prose to cover the new worktree.root leaf. Adds ak orchestrate to the root CLI outcome table. Bumps release-quality-shape baseline to 398 source / 397 built routes. * docs: bump search-index baseline for orchestrate group * docs: keep orchestrate group off stable channel until promote The prior commit mirrored the new ak orchestrate CLI group + config prefs worktree.root prose into content/docs/stable/reference/cli/** to satisfy cli-reference-routes.test.mjs's strict beta==stable route parity. That would publish /en/stable/reference/cli/orchestrate/** on merge even though channels.stable.tag is still v2.12.0, where the ak orchestrate command does not exist upstream — misleading anyone reading the stable docs. Fix by relaxing the invariant to beta ⊇ stable (whole-copy promote stays safe as long as every stable route also exists in beta; beta may include routes authored ahead of the next promote) and removing the mirrored orchestrate group + prose deltas from content/docs/stable/. The next stable promote picks these up as part of its normal whole-copy step. - cli-reference-routes.test.mjs: expected counts are per-channel; assert EN/VI parity within each channel and stable ⊆ beta across channels. - release-quality-shape.mjs: per-channel source/route baselines; new addMissingSubset() replaces the strict equality cross-channel check. - release-quality-metrics.mjs: per-channel searchPagesPerLocaleChannel. - release-quality.test.mjs: fixtures updated to the object shape. * fix: allow beta-only search routes * fix: avoid unavailable channel links * docs: align release channel contract (#64) * docs(troubleshooting): add Grok Claude-compat Hook workaround (#63) * docs(troubleshooting): add Grok Claude-compat Hook workaround Document how to disable Claude hook scanning and use ~/.grok/hooks until AgentKit folds global settings commands. Do not recommend editing AgentKit-managed settings.json. * docs: bump release-quality baselines for grok-hooks page The new troubleshooting route is published on beta and stable, EN+VI. Bump reviewed source/built/search counts by one per channel so check:quality:shape matches the authored tree.
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.
Summary
settings.jsonexec-form (command+args): Grok ignoresargsand treats a whitespace-freecommandas a path relative to that JSON file.~/.grok/hooks/, not to edit AgentKit-managedsettings.json.ak kit updateand re-enable Claude scan.Test plan
/en/docs/troubleshooting/grok-hooksand the VI locale resolve on staging after merge.~/.claude/settings.jsonor creating~/.claude/node.