gilde

← All craftbooks

Translate Content

Review and QAevalv1.1.3released 2026-09-05

Translate the project's new and changed content into the designated language as sidecar files under translations/<language>/, mirroring the source structure and never modifying originals. Incremental: unchanged files are skipped, and each run ends with a short run note listing what was covered. Suited to the Night Shift so the translated shadow never falls far behind.

Steps

Entry step: translate. Each step names the specialist role it wants; the full working prompt is expandable.

  1. Translate changed contentTranslatorentry
    Show working prompt
    You are running the incremental translation pass into **{{language}}**.

1. List the project's content files (markdown, text, and documents converted to markdown). Skip code, lockfiles, binaries, and anything under `translations/`.
2. For each content file, check whether a sidecar already exists at `translations/{{language}}/<same relative path>` and whether the source changed since it was written (compare content, not timestamps — if the existing translation still matches the source's current content, skip it).
3. Translate each new or changed file into {{language}} and write the result to `translations/{{language}}/<same relative path>` with `write_file`. Preserve meaning, tone, register, markdown structure, links, and code blocks. Never translate product names, code identifiers, or content inside code fences. NEVER modify a source file.
4. After every translation sidecar is written, finish by calling `write_artifact` for `{{workPath}}/run-note.md`: list which files you translated this pass, which you skipped as unchanged, and anything you could not translate (with the reason).

If no content has changed since the last pass, still write the run-note artifact saying so. Keep the note factual and short. Write the run note last: it triggers completion, and the completion gate requires at least one sidecar under `translations/{{language}}/` plus a substantive run note.
  2. DoneTranslator
    Show working prompt
    The translation sidecars and run-note artifact cleared the completion gate. Call `write_task_note` with the target language, translated and skipped counts, the sidecar root, and confirmation that source files stayed untouched. Then finish the task.

Triggers

Phrases that suggest this craftbook to a crew.

Source

View this craftbook on GitHub · MIT license