Skip to content

docs(superpowers-bridge): translate artifact-template guidance from zh-TW to English - #12

Open
AdrianTheopold wants to merge 1 commit into
JiangWay:mainfrom
AdrianTheopold:fix/template-i18n-english
Open

docs(superpowers-bridge): translate artifact-template guidance from zh-TW to English#12
AdrianTheopold wants to merge 1 commit into
JiangWay:mainfrom
AdrianTheopold:fix/template-i18n-english

Conversation

@AdrianTheopold

@AdrianTheopold AdrianTheopold commented Jun 22, 2026

Copy link
Copy Markdown

Problem

The superpowers-bridge README and the adopter CLAUDE.md fragment follow an English-primary + .zh-TW.md variant convention (README.md / README.zh-TW.md, CLAUDE.md.fragment.md / CLAUDE.md.fragment.zh-TW.md). The artifact templates under superpowers-bridge/templates/ don't follow it — six carry Traditional-Chinese author guidance inline, with no English variant: brainstorm/proposal/design/spec.md (in <!-- --> comments) and verify/retrospective.md (in rendered content — table headers, checkbox labels, blockquotes). plan.md and tasks.md are pure structure and were already clean.

Because OpenSpec injects each template: file as the scaffold at artifact-generation time, English-locale adopters get Chinese guidance in every authored brainstorm/proposal/design/spec file, and in the rendered verify.md / retrospective.md reports handed to reviewers.

Fix

Translate the embedded zh-TW guidance to English in all six templates. Prose-only: no structural markup changed; validation guidance preserved in English (the Why 50-1000-char zod limit, ####-scenario silent-fail rule, MODIFIED full-text-replacement rule, deferred-dogfood and skipped-skill protocols); grep-critical tokens byte-preserved (the verify.md Overall Decision markers and checkbox forms); schema.yaml untouched (artifact graph unchanged); the intentional .zh-TW.md locale variants left as-is. openspec schema validate superpowers-bridge passes.

…h-TW to English

The superpowers-bridge README and adopter CLAUDE.md fragment follow an
English-primary + .zh-TW.md variant convention, but six artifact templates
carried Traditional-Chinese author guidance inline with no English variant.
OpenSpec injects each template as a scaffold at artifact-generation time, so
the Chinese leaked into authored brainstorm/proposal/design/spec files (in
comments) and into rendered verify.md / retrospective.md reports (table
headers, checkbox labels).

Translate the embedded zh-TW guidance to English in all six affected
templates, preserving structure, OpenSpec validation rules, and grep-critical
tokens (PASS / PASS WITH WARNINGS / FAIL markers, checkbox forms). plan.md and
tasks.md were already clean; the intentional README.zh-TW.md and
CLAUDE.md.fragment.zh-TW.md locale variants are untouched. schema.yaml is not
modified, so the artifact graph is unchanged.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant