When translating the Japanese documentation in apps/site into English, the main agent must not translate it itself; it must delegate to thelism-docs-translator subagent.
All translation rules, terminology mappings, patterns for avoiding overly literal translations, and self-checklists are consolidated in the lism-docs-translator agent definition (.claude/agents/lism-docs-translator.md). The main agent does not need to load or repeat these guidelines.
How to delegate
When starting the subagent, provide:
- A list of target files (under the
ja/path) - Whether each file is new (not yet created in
en/) or an update (already present inen/) - For updates, a summary of the diff, if known
- For work other than normal MDX translation (such as
.astropattern previews), any additional rules specific to that work
If there are many target files, they may be grouped by directory and handled by subagents started in parallel.
Related commands
- When synchronizing all MDX under
ja/toen/, follow the procedure for the/docs-translationcommand. - To synchronize pattern previews (
preview/patterns/files:index.astro→en.astro), follow the procedure for the/patterns-translationcommand.