polish-vn

Vietnamese Tone Polish — Orchestrator

Communication — Horizontal. Terminal polish for Vietnamese-market copy. Three-agent pipeline (diagnose → polish → critic) for register calibration, idiom + cultural reference repair, and removal of ai-translation tells.

Core Question: "Would a native VN writer of this register write this exact text — and would a native reader stumble anywhere?"

Why / philosophy / when NOT to use: references/playbook.md [PLAYBOOK].

---

Critical Gates — Read First

1. Input must be Vietnamese. Does not translate. If English/other, STOP — translate first (humanmaxxing for source tone, or any MT).
2. Target register specified. One of bao-chi / semi-casual / bro / pop-marketing. If ambiguous, ask first.
3. Do NOT change facts. Form, not content. Numbers, names, dates, quotes, named examples survive intact.
4. Register is pair-locked. Polisher picks one pronoun pair (self ↔ reader) at start, holds to end. Drift is the #1 translation giveaway.

Quality Gate

Critic 7-check rubric (zero Hard Tells from 28-pattern catalog · pronoun pair held · particle density in range (0% báo chí; 15–25% casual/pop/bro) · facts preserved · typography normalized · read-aloud clean · score ≥28/36). Full rubric: agents/critic-agent.md. Pattern catalog: references/translation-artifacts.md.

Absolute Prohibitions (any one = auto-FAIL): em dashes · quý khách/quý vị outside formal · title-case headlines · particles in báo chí · pronoun drift · dropped facts · cliché stacks · literal idiom calques. Enforcement: references/procedures/absolute-prohibitions.md [PROCEDURE].

---

Before Starting

Per references/_shared/before-starting-check.md — load brand voice + register-mapping experience.

Artifact	Source	Required?
research/product-context.md	research-icp	Recommended — brand voice → register inference
docs/forsvn/artifacts/marketing/content/[slug].md	upstream	Optional — register from frontmatter
docs/forsvn/experience/brand.md	(any)	Optional — Brand — VN target register key

Pre-Dispatch + Mode

Protocol: references/_shared/pre-dispatch-protocol.md. Needed dimensions: register · dialect (north/south/neutral) · subvariant (if bro: otofun/voz). Read-order + Register Resolution priority + Warm/Cold Start + write-back + hard-blocks: references/procedures/pre-dispatch.md [PROCEDURE].

Per references/_shared/mode-resolver.md — --fast runs single-pass polisher only (skips diagnostic + critic). --fast does NOT skip Register Resolution, Critical Gates 1-4, or Absolute Prohibitions. Session execution profile (single-vs-multi): inherit per references/_shared/execution-policy.md.

---

Agents + Routing

3 sub-agents in agents/: diagnostic (L1: scan, register gap, violation log) → polisher (L2: register-correct rewrite) → critic (L2 final: 3-pass, 36-point rubric).

Route A (slash-command): Pre-Dispatch → diagnostic → user checkpoint → polisher → critic. FAIL → re-dispatch polisher (max 2 cycles) → deliver. Route B (upstream caller — brief-shortform / write-social / write-copy / write-ad when market = VN): trust caller's register; if prior polish → skip diagnostic; no standalone artifact.

Spawn mechanics, fallback, checkpoint, pipeline, rewrite loop: references/procedures/dispatch-mechanics.md [PROCEDURE].

---

Artifact Contract

• Path (A): docs/forsvn/artifacts/marketing/content/[slug].vn-tone.md · (B): none, embedded in caller
• Lifecycle: pipeline — re-run renames to [slug].vn-tone.v[N].md
• Frontmatter: skill, version, date, status, target_register, subvariant, dialect, critic_score
• Body (in order): Polish Summary · Change Log · Polished Text · Status
• Consumers: caller (B) or human (A); callers SHOULD preserve polish_chain_applied: vn-tone + critic_score: N/36
• Cross-stack contract: schema changes require atomic update of format-conventions.md

Template + per-section format rules: references/format-conventions.md [PROCEDURE].

---

Anti-Patterns

references/anti-patterns.md [ANTI-PATTERN] — 11 pipeline + 4 cross-cutting rows. Most common: pronoun drift · em dash · cliché stack · particle over-injection.

---

Durable Rules (protected)

Completion Status

• DONE — register hit, Hard Tells fixed, critic 36-point PASS
• DONE_WITH_CONCERNS — Soft Tells remain or critic 30–34
• BLOCKED — untranslatable claims or structural problems beyond polish scope
• NEEDS_CONTEXT — register unspecified, not derivable from brand voice

Next Step

Hand polished text to caller (B) or user (A). On DONE_WITH_CONCERNS, surface concerns before publish.

Worked Example + References

Route A walkthrough + cycle-2 FAIL + --fast variant: references/examples/vn-tone-walkthrough.md [EXAMPLE].

• references/{playbook, format-conventions, anti-patterns, vn-tone-corpus, translation-artifacts}.md
• references/procedures/{pre-dispatch, dispatch-mechanics, absolute-prohibitions}.md
• references/_shared/{before-starting-check, mode-resolver, pre-dispatch-protocol, manifest-spec}.md
• agents/{diagnostic, polisher, critic}-agent.md (critic holds 36-point rubric)