29 Commits

Author SHA1 Message Date
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 1b4115769f fix(memory): correct settings.json precedence order in vi/ja/uk translations (#133)
Mirror the English fix from #131 into the translated docs. The precedence
table in 02-memory and the v2.1.119 /config notes still encoded the old,
incorrect order (user above project/local).

- vi/02-memory: table rows -> local(3) -> project(4) -> user(5, lowest)
- ja/02-memory: table rows reordered + /config note policy/local/project
- ja/10-cli: /config note chain -> policy -> local -> project -> user
- uk/02-memory: table rows reordered

Correct order per https://code.claude.com/docs/en/settings:
Managed -> CLI args -> Local -> Project -> User (lowest).

zh is missing the whole settings section (structural port), tracked
separately in #132.

Refs #132
2026-06-02 06:57:08 +02: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
qszhu 7e369eefcb fix(i18n): correct logo image paths in translated module READMEs (#123) 2026-05-19 10:45:49 +02:00
Stephen Guo 6e46b25276 fix(docs): escape inline-code backticks in !command`` references
Escape backticks across en/ja/uk/vi/zh slash-commands and skills modules so the literal `!`command`` syntax renders correctly instead of breaking the inline-code span.
2026-05-11 22:58:29 +02:00
lzw-git-all d2ead3ba16 fix(extended-thinking): correct fictional /think command to valid ultrathink keyword (#83)
- Replace fictional `/think` example with official `ultrathink` keyword
- Fix Q4 options: `/think` → `/effort max`, `--thinking` → `ultrathink`
- Fix Q5: correct the answer that "ultrathink" DOES trigger deep reasoning
- Sync changes across English, Ukrainian, and Vietnamese translations

Background: `/think` is not a valid slash command in Claude Code (verified
against official commands reference at code.claude.com/docs/en/commands).
The correct way to trigger deep reasoning for a single response is to
include "ultrathink" in the prompt.

Sources:
- https://code.claude.com/docs/en/commands (no /think command exists)
- https://code.claude.com/docs/en/model-config (ultrathink is valid keyword)

Co-authored-by: Claude Opus 4.7 <noreply@anthropic.com>
2026-05-01 08:22:15 +02:00
xiaolai 05f0202536 fix: replace invalid diff tool with bash in security-reviewer agents (#89)
`diff` is not a valid Claude Code tool name — the agent would silently
lose its diff capability at runtime. Use `bash` to invoke diff instead.

Applies to all four locales: en (07-plugins), vi, zh, uk.

Co-authored-by: Claude Code <noreply@anthropic.com>
2026-04-25 00:24:35 +02:00
Luong NGUYEN cf92e8e2c1 chore(release): v2.1.112
Sync all English tutorials with Claude Code v2.1.112 and the new Opus 4.7
model (claude-opus-4-7). Introduces the xhigh effort level (new default on
Opus 4.7), two new built-in slash commands (/ultrareview,
/less-permission-prompts), auto mode without --enable-auto-mode for Max
subscribers on Opus 4.7, PowerShell tool on Windows, Auto-match-terminal
theme, and plan files named after prompts. All 18 EN doc footers bumped to
Claude Code v2.1.112.

Version callouts in README.md, zh/README.md, and uk/README.md updated to
v2.1.112. Changelog entry prepended.

Repo version now tracks Claude Code version (2.3.0 → 2.1.112 is intentional
per new convention).
2026-04-16 23:13:34 +02:00
Evgenij I b8a7b1f491 fix: change bad mermaid example to text block to pass CI 2026-04-10 13:43:14 +03:00
Evgenij I d970cc6b2d fix(uk): fix CP1251 encoding in claude_concepts_guide.md ToC 2026-04-10 08:57:34 +03:00
Evgenij I f6d73e2659 fix(uk): replace stub README with full translation, fix broken anchors
- Replace 3KB stub README with full 31KB translation matching original structure
- Fix apostrophe anchor mismatch in 04-subagents (U+02BC vs U+0027)
- Fix duplicate heading in 06-hooks (Prompt-хуки → Хуки на основі промптів)

Ref: luongnv89/claude-howto#63
2026-04-10 08:54:06 +03:00
Evgenij I 1dcd8d370c i18n(uk): complete translation of claude_concepts_guide.md
Full Ukrainian translation of the comprehensive concepts guide (87KB, 3135 lines).
All code blocks, Mermaid diagrams, and JSON configs preserved as-is.

Ref: luongnv89/claude-howto#63
2026-04-10 02:18:15 +03:00
Evgenij I 09c2fa24b1 i18n(uk): add resources/, scripts/, docs/, prompts/ translations
- Translate resources/ (README, QUICK-START, DESIGN-SYSTEM)
- Translate scripts/README.md (EPUB builder docs)
- Copy docs/ and prompts/ as-is (internal planning + functional prompts)
- Copy claude_concepts_guide.md (base for in-place translation)

Ref: luongnv89/claude-howto#63
2026-04-10 00:55:04 +03:00
Evgenij I 3f11521fcc i18n(uk): add missing root files (CLAUDE.md, clean-code-rules, resources, etc.)
- Translate CLAUDE.md, clean-code-rules.md, resources.md
- Translate pr-review plugin (README, commands, agents)
- Translate documentation templates (ADR, api-endpoint, function-docs)
- Copy RELEASE_NOTES.md, LICENSE, claude-howto-logo.png as-is
- Update TRANSLATION_QUEUE.md to 100%

Ref: luongnv89/claude-howto#63
2026-04-10 00:34:08 +03:00
Evgenij I 8438a0378a i18n(uk): complete P3 examples + P4 root docs translation
- Translate 07-plugins: devops-automation, documentation, pr-review
  (READMEs, commands, agents, templates)
- Update TRANSLATION_QUEUE.md — all priorities complete (100%)

Ref: luongnv89/claude-howto#63
2026-04-10 00:16:09 +03:00
Evgenij I f5659be047 i18n(uk): translate 07-plugins devops-automation & documentation
- Translate READMEs, commands, agents for both plugins
- Code/config/hooks files unchanged (no translation needed)

Ref: luongnv89/claude-howto#63
2026-04-10 00:13:13 +03:00
Evgenij I 1a567be793 i18n(uk): add missing files, translate P4 root docs
- Copy code/image/config files across all modules
- Translate brand-voice and code-review templates
- Translate CONTRIBUTING, CODE_OF_CONDUCT, SECURITY, STYLE_GUIDE
- Copy CHANGELOG as-is (technical log)

Ref: luongnv89/claude-howto#63
2026-04-09 23:59:59 +03:00
Evgenij I c0d400b21b feat(uk): translate refactor references (code-smells + catalog)
03-skills/refactor/references/code-smells.md (669 lines)
03-skills/refactor/references/refactoring-catalog.md (1023 lines)

P3 complete. Remaining: P4 root docs (5 files).

Ref: luongnv89/claude-howto#63
2026-04-09 23:08:46 +03:00
Evgenij I b56f1e111a feat(uk): translate P3 examples for skills/refactor, subagents, checkpoints, advanced
03-skills/refactor: SKILL.md + templates/refactoring-plan.md
04-subagents: 8 agent definitions
08-checkpoints: checkpoint-examples.md
09-advanced: planning-mode-examples.md

Remaining: refactor references (1692 lines), P4 root docs

Ref: luongnv89/claude-howto#63
2026-04-09 22:57:13 +03:00
Evgenij I cea0a7d4ef feat(uk): translate P3 examples for module 03-skills
6 SKILL.md files + 3 templates translated.
Remaining: references/code-smells.md and references/refactoring-catalog.md

Ref: luongnv89/claude-howto#63
2026-04-09 22:46:03 +03:00
Evgenij I 6172aacfd5 feat(uk): translate P3 examples for modules 01, 02
01-slash-commands: 7 slash command examples
02-memory: 3 CLAUDE.md examples

Progress: 25/67 files

Ref: luongnv89/claude-howto#63
2026-04-09 22:31:43 +03:00
Evgenij I 2a27614770 fix(uk): complete translations for modules 06, 07, 09, 10
Modules 06-hooks, 07-plugins, 09-advanced-features, 10-cli had
truncated translations (18-58% content loss). Retranslated from
scratch using original English sources.

All files now match expected ~40% size increase for Cyrillic.

Ref: luongnv89/claude-howto#63
2026-04-09 19:55:57 +03:00
Evgenij I 8684be223d feat(uk): translate Module 01 and Module 08 READMEs
Module 01: Slash Commands (565 lines)
Module 08: Checkpoints and Rewind (320 lines)
Update TRANSLATION_QUEUE.md with P1 completion.

Progress: 7/67 files (P1: 5/5 DONE, P2: 2/10)

Ref: luongnv89/claude-howto#63
2026-04-09 13:45:06 +03:00
Evgenij I 9efa5dd9b8 feat(uk): translate LEARNING-ROADMAP.md to Ukrainian
Complete Ukrainian translation of LEARNING-ROADMAP.md - the guided
learning path for Claude Code features.

- Self-assessment quiz for level determination
- Three learning levels: Beginner, Intermediate, Advanced
- All milestones (1A, 1B, 2A, 2B, 3A, 3B) with exercises
- Mermaid diagram preserved unchanged
- Progress tracking checklists
- Quick start paths (15 min, 1 hour, weekend)
- Learning tips and common challenges

Progress: 5/67 files (P1: 5/5 core documents COMPLETE)

Ref: luongnv89/claude-howto#63
2026-04-09 13:34:22 +03:00
Evgenij I 118fd40183 feat(uk): translate QUICK_REFERENCE.md to Ukrainian
Complete Ukrainian translation of QUICK_REFERENCE.md - the quick
reference card for all Claude Code features.

- Installation quick commands for all features
- Feature cheat sheet with paths and usage
- Common use cases (code review, docs, DevOps, CI/CD)
- File locations reference diagram
- Learning path (Day 1 through Week 3+)
- New features (March 2026) section
- Tips, FAQ, and getting started checklist

Progress: 4/67 files (P1: 4/5 core documents)

Ref: luongnv89/claude-howto#63
2026-04-09 13:28:06 +03:00
Evgenij I c343be62f5 feat(uk): translate CATALOG.md to Ukrainian
Complete Ukrainian translation of CATALOG.md - the quick reference
guide to all Claude Code features.

- 55+ built-in commands reference with Ukrainian descriptions
- Permission modes, subagents, skills, plugins sections
- MCP servers, hooks (25 events), memory types
- New features (March 2026) - 20+ features
- Quick reference matrix and installation priority
- i18n-source-sha frontmatter for version tracking

Progress: 3/67 files (P1: 3/5 core documents)

Ref: luongnv89/claude-howto#63
2026-04-09 13:21:40 +03:00
Evgenij I a80b980bb6 feat(uk): translate INDEX.md to Ukrainian
Complete Ukrainian translation of INDEX.md - the comprehensive
index of all example files in the repository.

Translation follows uk/TRANSLATION_NOTES.md guidelines:
- Technical terms per glossary
- File paths and code blocks preserved in English
- Table structure and formatting maintained
- All 883 lines translated
- i18n-source-sha frontmatter added for version tracking

Progress: 2/67 files (P1: 2/5 core documents)

Ref: luongnv89/claude-howto#63
2026-04-09 13:16:35 +03:00
Evgenij I 06caeaa8d9 feat(i18n): add Ukrainian localization infrastructure
- uk/README.md: Ukrainian landing page with module index
- uk/TRANSLATION_NOTES.md: glossary and style guide
- uk/TRANSLATION_QUEUE.md: progress tracker (0/67 files)
- Directory structure for all 10 modules

Ref: luongnv89/claude-howto#63
2026-04-09 13:12:52 +03:00