Parr0t game localization
Review control is a deterministic router: follow only validated status and
manifest actions. Do not inspect review text, invent a plan or file format,
repair/rebind the SDK, change model/batch/budget choices, or resume a halted
review autonomously. Checkpoint unknown or incomplete state. Never invent a
budget or replace a manifest; only user-set limits execute.
Use game-l10n as the execution boundary. Read the repository AGENTS.md, docs/agent-usage.md, and the workspace AGENTS.md; afterward resolve only the status response's required_contracts against its contract_base.
Run
- Resolve three separate locations: Parr0t repository, read-only game root, and writable external workspace. Images require a user request, recorded policy, and
docs/image-localization.md; never scan all images.
- If the workspace does not exist, run
game-l10n init-workspace. Ask once whether Git is allowed for this game task and record the answer with game-l10n policy.
- Run
game-l10n status. Before data-plane work, follow docs/sdk-selection.md; derive the actual engine/version identity, inspect plausible sdk-* contracts, select reuse, extend, derive-new, or private-new, and activate the exact executing implementation without broadening compatibility claims.
- Use the selected SDK to create two independent complete ordered inventories and run
game-l10n verify-inventory. Keep all user-visible unresolved scope visible. Static alignment never proves runtime coverage.
- Run
game-l10n translate: context → primary → failure fallback → complete triage → selective strong review → flagged rewrite → review fallback → validation. The parent routes metadata only. Native review uses --pass-kind review: up to 2,048 candidates, then failed-only binary split; translation sizing stays separate.
- Pack to a new workspace output and verify only the changed layers. Do not install, launch, or mutate the game root.
- Report counts, categorical coverage states, failure queues, artifact paths, and the next necessary decision only.
Routing invariants
- Apply
request-scope-guard after every user message that limits scope or before any optional, destructive, or external action. Workers receive only authorized targets and effects.
- Provider refusal is
fallback_required, not an exclusion or semantic decision. Finish the primary pass before fallback. Preserve source only after all configured routes are proven exhausted.
- Each target retains relevant narrative/voice, functional/UI, or knowledge/prerequisite context even though provider calls isolate failures per target.
- Native workers start fresh with no parent history and return only a
parr0t.control-envelope.v2 path. The parent must not receive source, candidates, results, refusal prose, or semantic review details. Follow docs/control-plane-contract.md.
- Native v7 is executable; v6 is completion-only. Use one batch per task. Review splitting is core-only (depth 3, 2.0x attempts). Use
native-pass-step and terminal --relay-ended; core queues missing tasks. Never run per-record loops, infer limits, enumerate workers, or poll. Follow docs/detail-contract.md.
- Manual/fallback handoff uses only
parr0t.translation-exchange/v1; the parent neither opens the text-bearing bundle nor invents another format.
- Operational failures remain in the resumable metadata queue. Retry after a later explicit user request; if
metadata.blocking_on_failure=true, hold the complete patch.
- A configured preset fixes provider roles. API-key presence cannot select or alter it. For
codex-app-deepseek, follow docs/codex-app-deepseek.md.
- The source root is read-only. Real install, update, remove/restore, and launch are separate actions requiring explicit one-shot approval.
- Publication stays unmentioned and dormant until the user requests it. SDK promotion also requires confirmed patch success and exact target identity. Its separate non-merge engine commit must pass
game-l10n verify-sdk-promotion; common changes belong in an independently authorized main commit.
Fast routes
- Correction:
docs/minimal-corrections.md; resolve a missing ID once in its local UI, freeze that export, preserve all else, and never repeat global search. Exact values use no model; generated wording uses one batch.
- Earlier release or updated game build:
docs/release-checkpoint.md; reuse only still-compatible unchanged reviewed targets.
- Composed UI text:
docs/segment-metadata.md.
- Launcher-neutral package:
docs/filesystem-packaging.md; -GameRoot supports absolute and startup-current-directory-relative paths and defaults to the validated startup current directory when omitted.
- Steam package/integration:
docs/steam-packaging.md, then docs/steam-faq.md and docs/wrapper-executable.md only if integration is requested.
- User-requested public instance:
docs/instance-release.md.
- Successful reusable SDK promotion:
docs/sdk-branch-contract.md and docs/engine-faq-contract.md.
Never copy private game data, text, translations, prompts, caches, logs, keys, or job provenance into the SDK repository.
1---2name: game-localization3description: Run Parr0t's context-first, fallback-routed game translation and patch workflow. Use for game unpacking, text translation, review, repacking, continuation, or reusable SDK promotion; do not use for ordinary software localization.4metadata:5 source: https://skillmd.com/skills/project-parr0t/game-localization6---78# Parr0t game localization910Review control is a deterministic router: follow only validated status and11manifest actions. Do not inspect review text, invent a plan or file format,12repair/rebind the SDK, change model/batch/budget choices, or resume a halted13review autonomously. Checkpoint unknown or incomplete state. Never invent a14budget or replace a manifest; only user-set limits execute.1516Use `game-l10n` as the execution boundary. Read the repository `AGENTS.md`, `docs/agent-usage.md`, and the workspace `AGENTS.md`; afterward resolve only the status response's `required_contracts` against its `contract_base`.1718## Run19201. Resolve three separate locations: Parr0t repository, read-only game root, and writable external workspace. Images require a user request, recorded policy, and `docs/image-localization.md`; never scan all images.212. If the workspace does not exist, run `game-l10n init-workspace`. Ask once whether Git is allowed for this game task and record the answer with `game-l10n policy`.223. Run `game-l10n status`. Before data-plane work, follow `docs/sdk-selection.md`; derive the actual engine/version identity, inspect plausible `sdk-*` contracts, select `reuse`, `extend`, `derive-new`, or `private-new`, and activate the exact executing implementation without broadening compatibility claims.234. Use the selected SDK to create two independent complete ordered inventories and run `game-l10n verify-inventory`. Keep all user-visible unresolved scope visible. Static alignment never proves runtime coverage.245. Run `game-l10n translate`: context → primary → failure fallback → complete triage → selective strong review → flagged rewrite → review fallback → validation. The parent routes metadata only. Native review uses `--pass-kind review`: up to 2,048 candidates, then failed-only binary split; translation sizing stays separate.256. Pack to a new workspace output and verify only the changed layers. Do not install, launch, or mutate the game root.267. Report counts, categorical coverage states, failure queues, artifact paths, and the next necessary decision only.2728## Routing invariants2930- Apply `request-scope-guard` after every user message that limits scope or before any optional, destructive, or external action. Workers receive only authorized targets and effects.31- Provider refusal is `fallback_required`, not an exclusion or semantic decision. Finish the primary pass before fallback. Preserve source only after all configured routes are proven exhausted.32- Each target retains relevant narrative/voice, functional/UI, or knowledge/prerequisite context even though provider calls isolate failures per target.33- Native workers start fresh with no parent history and return only a `parr0t.control-envelope.v2` path. The parent must not receive source, candidates, results, refusal prose, or semantic review details. Follow `docs/control-plane-contract.md`.34- Native v7 is executable; v6 is completion-only. Use one batch per task. Review splitting is core-only (depth 3, 2.0x attempts). Use `native-pass-step` and terminal `--relay-ended`; core queues missing tasks. Never run per-record loops, infer limits, enumerate workers, or poll. Follow `docs/detail-contract.md`.35- Manual/fallback handoff uses only `parr0t.translation-exchange/v1`; the parent neither opens the text-bearing bundle nor invents another format.36- Operational failures remain in the resumable metadata queue. Retry after a later explicit user request; if `metadata.blocking_on_failure=true`, hold the complete patch.37- A configured preset fixes provider roles. API-key presence cannot select or alter it. For `codex-app-deepseek`, follow `docs/codex-app-deepseek.md`.38- The source root is read-only. Real install, update, remove/restore, and launch are separate actions requiring explicit one-shot approval.39- Publication stays unmentioned and dormant until the user requests it. SDK promotion also requires confirmed patch success and exact target identity. Its separate non-merge engine commit must pass `game-l10n verify-sdk-promotion`; common changes belong in an independently authorized `main` commit.4041## Fast routes4243- Correction: `docs/minimal-corrections.md`; resolve a missing ID once in its local UI, freeze that export, preserve all else, and never repeat global search. Exact values use no model; generated wording uses one batch.44- Earlier release or updated game build: `docs/release-checkpoint.md`; reuse only still-compatible unchanged reviewed targets.45- Composed UI text: `docs/segment-metadata.md`.46- Launcher-neutral package: `docs/filesystem-packaging.md`; `-GameRoot` supports absolute and startup-current-directory-relative paths and defaults to the validated startup current directory when omitted.47- Steam package/integration: `docs/steam-packaging.md`, then `docs/steam-faq.md` and `docs/wrapper-executable.md` only if integration is requested.48- User-requested public instance: `docs/instance-release.md`.49- Successful reusable SDK promotion: `docs/sdk-branch-contract.md` and `docs/engine-faq-contract.md`.5051Never copy private game data, text, translations, prompts, caches, logs, keys, or job provenance into the SDK repository.