10 Commits

Include renames

Author	SHA1	Message	Date
Luong NGUYEN	deb7e5c710	docs: sync to Claude Code v2.1.233 (#168) ... * docs: sync to Claude Code v2.1.233 Bring the tutorial from the v2.1.220 baseline up to v2.1.233 (13 releases) per update-plan-2026-08-15.md. Corrections: - Remove /ultraplan (removed in v2.1.222); point at plan mode instead - Drop the 200-subagent-per-session cap and CLAUDE_CODE_MAX_SUBAGENTS_PER_SESSION (cap removed in v2.1.224) - Note TaskCompleted/TaskCreated only fire when todo tools are enabled Updates: - /review documented as an alias of /code-review (v2.1.223) - fork subagents default to interactive (v2.1.232) - ultrareview v2.1.227 floor, --post/--no-post - GitLab MR support for -w/--worktree and Agent View New sections: - Cross-session messaging (ListAgents, SendMessage, crossSessionInbound) - Sandbox credential masking (v2.1.221, v2.1.224) - Trust and permission scoping - archive and command plugin sources, conditional plugin activation - claude self-hosted-runner, 7 new env vars Translations (vi/ja/zh/uk) mirrored where the corresponding pages exist. Every modified file carries the 2.1.233 metadata footer; files already at 2.1.220 with no content change were left alone. * docs: address review findings from the v2.1.233 sync - Mirror the /review alias correction (v2.1.223) into vi/ja/uk/zh 01-slash-commands: add the live alias row, drop the stale row from the deprecated table, and rewrite the history bullet. All four still called /review deprecated in favour of a code-review plugin while carrying a 2.1.233 stamp. - Rewrite the 10-cli CLAUDE_CODE_FORK_SUBAGENT row to agree with 04-subagents: fork mode is on by default in interactive sessions on every build since v2.1.232; the variable enables it where it is off by default. - Remove a stray blank line that split the 10-cli environment-variable table, leaving the seven new v2.1.221-v2.1.233 rows without a delimiter row and rendering them as literal pipe text. - Add the todo-tools caveat to the TaskCompleted row alongside TaskCreated in claude_concepts_guide, uk/ja concepts guides, and the uk/vi/zh/ja CATALOGs. - Fix the ja 07-plugins and 09-advanced-features footers, which paired a 2.1.233 version stamp with an April 24 last-updated date. * docs(subagents): correct the stale fork-subagent claim in ja pages (#171) ja/10-cli and ja/04-subagents both stated that CLAUDE_CODE_FORK_SUBAGENT only enables forked subagents on external builds (Bedrock, Vertex, Foundry) with no effect on the Anthropic API. That was true at v2.1.117 but has been wrong since v2.1.232: fork mode is on by default in interactive sessions on every build, first-party or not, and the variable now turns it on where it is off by default (claude -p, the Agent SDK, or Claude Code older than v2.1.232). Both pages remain stamped 2.1.119 on purpose. Only the individual claim was verified and corrected; bumping the page stamp would assert a whole-page verification that has not been done. Do not bump these stamps without a full resync of the pages.	2026-08-17 12:44:44 +07:00
Luong NGUYEN	4f3fa85d7e	docs: follow-ups from the v2.1.220 accuracy review (#161) ... * fix(ci): move the EPUB build out of pre-commit into CI The build-epub hooks called scripts/build_epub.py, which raises when the mmdc binary is missing, while check_mermaid.py skips with a warning in the same situation. On arm64 — where @mermaid-js/mermaid-cli has no working build — that made 'pre-commit run --all-files' impossible to satisfy for a docs-only change without --no-verify. Remove the build-epub, vietnamese-build-epub and japanese-build-epub hooks and widen the CI build-epub job to a language matrix so PR-time coverage is not reduced: it previously built en only, and now builds en, vi, zh and ja. zh was covered by neither the hooks nor this job, so a broken zh diagram could only surface at release time. Closes #156 * docs: replace the stale Kroki narrative with local mmdc rendering Commit e76bbe4 swapped the Kroki HTTP dependency for local mmdc rendering but left the docs describing the old design. The claim appeared in seven live files, not the two originally reported: CLAUDE.md, scripts/README.md and their ja/uk/vi copies. Also corrects what the same staleness dragged along: - scripts/README.md documented --timeout and --max-concurrent, which no longer exist, and omitted --mmdc-path, --lang and --puppeteer-config - 'Async concurrent fetching' described a render_all() that is now a plain sequential loop with a dedupe cache - the network-error/rate-limiting troubleshooting entries are replaced with the failures that actually occur now (missing mmdc, Chromium sandbox) CHANGELOG entries recording the Kroki-to-mmdc switch are left alone; they describe the past accurately. Closes #157 * fix(scripts): make the ruff config match files that exist Ruff resolves include/per-file-ignores patterns relative to the directory holding pyproject.toml. Since the config lives in scripts/, the pattern "scripts/**/*.py" meant scripts/scripts/**/*.py, which matches nothing — 'ruff check scripts/' printed 'warning: No Python files found under the given path(s)' and then 'All checks passed!'. per-file-ignores had the same mistake. Both are now relative to scripts/, so ruff sees all 14 files. This silently disabled the pre-commit ruff hooks too, not just the documented command, and two test files had drifted out of format as a result. Reformatting them exposed a second problem: the pre-commit hook pinned ruff v0.8.2 while the CI lint job installs unpinned latest and this venv has 0.15.10. The versions disagree on formatting, so each reverted the other's output, and CI would have started failing on a file the local hook kept rewriting. Bump the hook pin and the requirements-dev floor to 0.15.10 so all three agree. Verified: 'pre-commit run --all-files' is stable across consecutive runs, 'ruff format --check scripts/' and 'ruff check scripts/' both pass, 92 tests pass. Closes #160 * docs: point localized module links at their own trees Files at the root of a language directory used ../NN-module/, which from uk/CATALOG.md resolves to the English 05-mcp/ at the repo root rather than uk/05-mcp/. Readers following a count stated about the localized tree landed in the English one. The link checker never caught it because the English target does exist. Files one level deeper (uk/04-subagents/README.md and friends) were already correct — ../06-hooks/ from there resolves to uk/06-hooks/ — so this is scoped to the 7 depth-1 files that actually escape: CATALOG.md in uk, vi, ja and zh, LEARNING-ROADMAP.md in uk and vi, and ja/claude_concepts_guide.md. 119 links in total. The ../NN- occurrences left in STYLE_GUIDE.md and TRANSLATION_NOTES.md are inside fenced examples showing what a module page should contain, where the ../ form is the correct convention. All 119 rewritten targets were verified to exist. Closes #158 * docs(hooks): stop conflating hook types with hook event categories '**Hook Types** (5 types, 31 events)' sat above four bullets, so the count read as wrong. It was not — the two numbers describe different axes that had been merged into one label. 06-hooks/README.md:126 documents five hook *types*: command, http, prompt, mcp_tool and agent. Those describe how a hook runs. The four bullets are event *categories* — Tool, Session, Task, Lifecycle — holding 31 events (6+7+6+12), and describe when it runs. Split the label so each number belongs to the axis it counts, in all nine affected files: README.md and INDEX.md plus the ja, uk, vi and zh copies. QUICK_REFERENCE.md and LEARNING-ROADMAP.md already stated '5 types' with the handler names attached and needed no change. Closes #159 * chore(scripts): drop the unused httpx dependency httpx was the HTTP client for Kroki rendering. Nothing has imported it since e76bbe4 moved diagram rendering to a local mmdc subprocess — check_links.py, the only other network caller, uses stdlib urllib.request. The PEP 723 blocks in build_epub.py and build_website.py had already dropped it; only the manifests and docs still declared it. Removes it from requirements.txt, pyproject.toml dependencies, the dependency tables and uv --with lines in scripts/README.md and its ja/uk copies, and the .cspell.json word list. Also drops the B113 bandit suppression, which existed solely for an httpx timeout false positive — bandit reports no issues without it. Also corrects two Requirements lines missed in the previous pass: the ja and uk script READMEs still listed an internet connection rather than mmdc. Note: tenacity is now dead for the same reason and is left in place. * chore(scripts): drop the unused tenacity dependency Nothing imports tenacity — the retry logic it was added for went away with the Kroki HTTP fetching in e76bbe4. It was still declared in requirements.txt, pyproject.toml, both `uv run --with` lines and all three dependency tables. * docs(i18n): sync the localized pre-commit check lists The ja/uk/vi CLAUDE.md files still listed build-epub as pre-commit check #5, stale since 6da8184 moved the EPUB build to CI. They also omitted markdown-rendering, and the ja/uk stated counts disagreed with their own lists. Now matches the English CLAUDE.md. * fix(scripts): silence PLR0917 now stable in ruff 0.16 CI installs the latest ruff (uv pip install ruff, unpinned), and 0.16.1 promoted too-many-positional-arguments from preview to stable, hard-failing the Code Quality check on build_epub.py's long-signature draw/helper functions. These sit in the same family as PLR0913, which is already ignored. Add PLR0917 so the local 0.15.10 pin and unpinned CI lint agree again.	2026-08-06 07:58:46 +07:00
Luong NGUYEN	b9a973bf32	docs: accuracy pass against Claude Code v2.1.220 (#155) ... Internal accuracy pass against v2.1.220 — no missing upstream features, but broken example code, disagreeing counts, and metadata drift. Functional fixes: pre-commit.sh now exits 2 so it actually blocks; dependency-check.sh reads file_path from stdin JSON instead of $1; database-mcp.json uses ${DATABASE_URL}; broken fences repaired; three command templates had invalid skill names. Factual corrections: /fork and /subtask unswapped and /subtask added; /fewer-permission-prompts; permissions.defaultMode; dontAsk/auto unreversed; 31 hook events verified name-by-name; subagent depth 3; skill precedence enterprise > project > personal; /output-style removed not deprecated; permissionDecision gained defer. Follow-up review fixed defects the pass left behind: zh/vi headers claiming 31 events above 25-name lists, a surviving hardcoded DB credential in the MCP README examples, an unbalanced fence swallowing a metadata footer, and non-canonical tool names. All four translated CATALOG summary tables were recounted so their arithmetic holds. Full detail in CHANGELOG.md under v2.1.220-r2.	2026-08-04 15:41:12 +07:00
Luong NGUYEN	8f045173d1	docs: sync to Claude Code v2.1.212 (#154) ... * docs: sync to Claude Code v2.1.212 Bumps tutorial coverage from the v2.1.206 baseline (2026-07-11 sync) to v2.1.212, plus a repo-internal accuracy audit that surfaced defects independent of the version delta. Fixed: - Dead `#` memory-shortcut removed from 02-memory/README.md (two places documented a discontinued quick-memory-add pattern as working, directly contradicting the file's own commands table) - Auto mode opt-in -> opt-out on Bedrock/Vertex/Foundry (v2.1.207) - `auto` permission mode mislabeled "Research Preview" across 09-advanced-features/README.md, CATALOG.md, README.md, and the vi/ja/zh/uk translations (auto mode is GA, gated only by plan/model/provider) - `/fork` / `/branch` history corrected: they were a single aliased command only from v2.1.77 to v2.1.161, not "renamed" as previously stated - `effort` frontmatter enum in 04-subagents/README.md completed with `xhigh` - Bundled-skills count reconciled in CATALOG.md (9 -> 10) - INDEX.md Skills section count and Feature Coverage Matrix Total column fully recomputed and reconciled (Skills: 22, Plugins: 39) - Stale 2.1.160 footer cluster (5 files) bumped to 2.1.212 - QUICK_REFERENCE.md fully resynced (was 52 versions behind) - 02-memory/README.md's Memory Hierarchy section rewritten: replaced a fabricated 8-tier strict-precedence model with the verified structure (CLAUDE.md files are concatenated into context, not overridden; 4 real location tiers; rules and auto memory are separate mechanisms) - 02-memory/README.md's Memory Architecture diagram no longer conflates claude.ai's 24h synthesis cycle with Claude Code's continuous auto memory - Import recursion depth corrected (was documented as 5, actually 4 hops) Added: - Subagent output scanning (v2.1.210) documented in 04-subagents/README.md - Session-wide spawn caps (v2.1.212): WebSearch and subagent limits - MCP long-running-tool auto-backgrounding (v2.1.212) in 05-mcp/README.md - `claude auto-mode reset` and `/resume` picker (v2.1.212) - Screen reader mode (v2.1.208): --ax-screen-reader / CLAUDE_AX_SCREEN_READER - Task tool `mode` parameter deprecation note (v2.1.212) Known gaps (deferred, not fixed this pass): - 03-skills/blog-draft/ vs 03-skills/.claude/skills/blog-draft/: confirmed the latter is gitignored local testing scratch, not a repo duplicate * fix(INDEX): correct Skills row arithmetic and stale changelog notes INDEX.md's Skills header/matrix shipped as 22 (5+9+8) despite the PR's own CHANGELOG claiming it was fixed to 21 — three independent counts (file-type breakdown, filesystem listing, changelog intent) agree on 21; the Docs column was off by one. Also removes two stale CHANGELOG "Known gaps" entries this same PR already resolved (memory hierarchy rewrite, blog-draft gitignore confirmation) and adds the missing Fixed-section bullet documenting the memory hierarchy rewrite.	2026-07-18 22:21:21 +07:00
Luong NGUYEN	c7261394b0	fix(i18n): re-point translations to code-review-specialist rename (#128) ... * fix(i18n): re-point translations to code-review-specialist rename The English code-review skill was renamed to code-review-specialist in #127 to avoid shadowing the new built-in /code-review command. Mirror that rename across the uk, vi, ja, zh locales: rename each 03-skills/code-review/ directory to code-review-specialist/, update the i18n-source markers in the moved ja files, and fix path references in INDEX.md, QUICK_REFERENCE.md, and the vi TRANSLATION_QUEUE.md. * chore: ignore .asm-improver and .gitissue tooling state * fix(i18n): re-point remaining code-review install paths to code-review-specialist	2026-05-26 10:29:51 +02:00
Luong NGUYEN	2230a6ef10	fix(i18n): correct logo image paths in translated root-level files (#124) ... Follow-up to #123 — that PR fixed module README logo paths but missed root-level translated files (README, INDEX, CATALOG, CONTRIBUTING, STYLE_GUIDE, etc.) which had the same broken-path pattern: they used `resources/logos/...` (root-relative) but live one directory deep, so they resolved to `{lang}/resources/logos/...` and 404'd. Fix: `resources/logos/...` → `../resources/logos/...` in the top `<picture>` block of each translated root-level file. For STYLE_GUIDE files, the in-code-fence `<picture>` example was left as `resources/logos/...` to mirror the English source — it documents the canonical pattern, not the path the file itself uses. Files: zh/ (×9), uk/ (×4), vi/ (×2). ja/STYLE_GUIDE.md was already correct.	2026-05-20 11:15:36 +02:00
3 people	63a1416884	fix(docs): correct Claude Code version to 2.1.97 across all footers ... The latest Claude Code release is 2.1.97, not 2.3.0 (which is this guide's own version). Update all 20 "Claude Code Version" footer lines to accurately reflect the documented Claude Code version. Generated with [Claude Code](https://claude.ai/code) via [Happy](https://happy.engineering) Co-Authored-By: Claude <noreply@anthropic.com> Co-Authored-By: Happy <yesreply@happy.engineering>	2026-04-09 06:42:51 +02:00
3 people	7f2e77337e	docs: update Last Updated date and Claude Code version across all files ... Update all documentation footers from generic "April 2026 / 2.1+" to the specific sync date (April 9, 2026) and documented version (2.3.0). Also add version/date footers to zh/CATALOG.md and zh/01-slash-commands/README.md which were missing them. Generated with [Claude Code](https://claude.ai/code) via [Happy](https://happy.engineering) Co-Authored-By: Claude <noreply@anthropic.com> Co-Authored-By: Happy <yesreply@happy.engineering>	2026-04-09 06:41:16 +02:00
3 people	e015f39c68	fix: apply 2026-04-09 documentation accuracy updates ... P0 Critical: - Remove /vim (removed in v2.1.92) from CATALOG.md, zh/CATALOG.md active tables - Move /vim to deprecated section in zh/01-slash-commands/README.md - Fix fake hook events (PreCommit/PrePush/PostPush) in config-examples.json - Replace with real PreToolUse hook pattern - Update deprecated model IDs: claude-sonnet-4-5 → claude-sonnet-4-6 (x4) - Fix notify-team.sh comment: PostPush → PostToolUse with explanation - Mark # memory shortcut as discontinued in 02-memory/README.md P2 Conflicts resolved: - effort:max confirmed valid in current CLI; no changes needed - Remove WebSocket MCP transport (not supported; only stdio/sse/http valid) from 05-mcp/README.md, CATALOG.md, QUICK_REFERENCE.md P4 Cosmetic: - Update hook count 25 → 26 in QUICK_REFERENCE.md Generated with [Claude Code](https://claude.ai/code) via [Happy](https://happy.engineering) Co-Authored-By: Claude <noreply@anthropic.com> Co-Authored-By: Happy <yesreply@happy.engineering>	2026-04-09 06:32:26 +02:00
Luong NGUYEN	89e89d4aa3	feat(zh): add Chinese translations in zh/ directory ... Add Chinese (Simplified) translations for all documentation, organized under a dedicated zh/ directory that mirrors the English folder structure. Co-authored-by: tanqingkuang <tanqingkuang@users.noreply.github.com> Translations originally contributed by @tanqingkuang in #45. Restructured from *-CN.md suffix pattern into zh/ directory to prevent the EPUB builder (scripts/build_epub.py collect_folder_files) from picking up Chinese files via glob("*.md") inside module folders.	2026-04-06 23:08:54 +02:00