Skip to content

fix(commands): translate 15 /pf:* command bodies to English + help What's new (#113)#117

Closed
ComBba wants to merge 1 commit intomainfrom
fix/113-commands-english
Closed

fix(commands): translate 15 /pf:* command bodies to English + help What's new (#113)#117
ComBba wants to merge 1 commit intomainfrom
fix/113-commands-english

Conversation

@ComBba
Copy link
Copy Markdown
Contributor

@ComBba ComBba commented Apr 26, 2026

Summary

Every /pf:* slash-command source under plugins/preview-forge/commands/ contained Korean prose. Claude Code loads these files as command bodies, so the Korean text was being rendered to the user (most visibly through /pf:help). That violates Layer-0 Rule 10 (English-only output), ratified in #102 and merged into CONTRIBUTING.md via #106. This PR translates all 15 command bodies to plain professional English and refreshes the stale "What's new" section in help.md so it covers releases through v1.14.1.

Translation only — no behavior, flag, schema, frontmatter, code block, or command example was changed.

Resolves

Closes #113

Changes

File Hangul before Hangul after
plugins/preview-forge/commands/bootstrap.md 515 0
plugins/preview-forge/commands/budget.md 88 0
plugins/preview-forge/commands/design.md 239 0
plugins/preview-forge/commands/export.md 63 0
plugins/preview-forge/commands/freeze.md 63 0
plugins/preview-forge/commands/gallery.md 61 0
plugins/preview-forge/commands/help.md 205 0
plugins/preview-forge/commands/lessons.md 55 0
plugins/preview-forge/commands/new.md 1773 0
plugins/preview-forge/commands/panel.md 61 0
plugins/preview-forge/commands/preview.md 213 0
plugins/preview-forge/commands/replay.md 62 0
plugins/preview-forge/commands/retry.md 64 0
plugins/preview-forge/commands/seed.md 52 0
plugins/preview-forge/commands/status.md 130 0
Total 3644 0

Help "What's new" updates

The ## What's new section in help.md was frozen at "shipped through semver v1.10.0" — four minor versions behind. The updated section now covers:

  • v1.11 — defense-in-depth + regex hardening (cluster of 5×3 review fixes).
  • v1.12 — cinematic preview + auto-rec + reference example.
  • v1.13 — H1 → SpecDD auto-advance via hooks/post-h1-signal.py, H2 → preview-server auto-launch, and the new /pf:preview slash command.
  • v1.14 — Rule 10 (Layer-0 English-only output) and the default profile fix (truly standard, not pro).

Previously existing v1.6 and v1.7 entries are preserved with translated copy.

The "14 commands" / "14 명령어 요약" wording was updated to "15 commands" since /pf:preview was added in v1.13.

Maintenance process

A new one-liner at the bottom of the "What's new" section formalizes the recurring maintenance task:

This section is regenerated each release; see CHANGELOG.md for the canonical per-tag mapping.

CHANGELOG.md stays the source of truth for per-tag detail; help.md carries only the human-readable highlights.

Test plan

  • bash scripts/verify-plugin.sh passes (59/0).
  • 0 Hangul chars in any commands/*.md (verified with the U+AC00..U+D7A3 sweep from the issue).

Notes

  • Frontmatter (description: field) was left intact except where the Korean original itself was a translation candidate (it was not — every frontmatter line was already English).
  • Code identifiers, slash commands, file paths, env-var names, and JSON keys were preserved verbatim.
  • The bootstrap.md Python merge block, new.md weak-replay JSON literals, and all bash code fences were not touched — only the surrounding prose was translated.
  • Korean burnt-in subtitles in the demo VIDEO are out of scope for this PR; only repo artifacts were changed.

🤖 Generated with Claude Code

…lp What's new to v1.14.1 (#113)

Every /pf:* slash-command source under plugins/preview-forge/commands/ contained
Korean prose that Claude Code rendered to the user (most visibly through
/pf:help). This violates Layer-0 Rule 10 (English-only output, ratified in #102
and merged into CONTRIBUTING.md via #106).

Translate all 15 command bodies (bootstrap, budget, design, export, freeze,
gallery, help, lessons, new, panel, preview, replay, retry, seed, status) to
plain professional English. Preserve frontmatter, code blocks, command
examples, file paths, and behavior verbatim — translation only, no semantic
change.

In addition, refresh help.md:
- Replace the stale "What's new (... shipped through semver v1.10.0)" section
  with entries through v1.14.1: v1.11 defense-in-depth + regex hardening,
  v1.12 cinematic preview + auto-rec + reference example, v1.13 H1 -> SpecDD
  auto-advance + H2 -> preview-server auto-launch + new /pf:preview slash
  command, v1.14 Rule 10 (Layer-0 English-only output) + default profile fix.
- Update the command count from 14 to 15 (preview was added in v1.13).
- Add a maintenance pointer line: "This section is regenerated each release;
  see CHANGELOG.md for the canonical per-tag mapping."

Verification: 0 Hangul characters remain in any commands/*.md (Unicode range
U+AC00..U+D7A3); scripts/verify-plugin.sh passes (59/0).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@chatgpt-codex-connector
Copy link
Copy Markdown

You have reached your Codex usage limits for code reviews. You can see your limits in the Codex usage dashboard.

@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Apr 26, 2026

Warning

Rate limit exceeded

@ComBba has exceeded the limit for the number of commits that can be reviewed per hour. Please wait 14 minutes and 0 seconds before requesting another review.

Your organization is not enrolled in usage-based pricing. Contact your admin to enable usage-based pricing to continue reviews beyond the rate limit, or try again in 14 minutes and 0 seconds.

⌛ How to resolve this issue?

After the wait time has elapsed, a review can be triggered using the @coderabbitai review command as a PR comment. Alternatively, push new commits to this PR.

We recommend that you space out your commits to avoid hitting the rate limit.

🚦 How do rate limits work?

CodeRabbit enforces hourly rate limits for each developer per organization.

Our paid plans have higher rate limits than the trial, open-source and free plans. In all cases, we re-allow further reviews after a brief timeout.

Please see our FAQ for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: CHILL

Plan: Pro

Run ID: 7753a2f7-a690-4aad-96c8-9251bfaa2501

📥 Commits

Reviewing files that changed from the base of the PR and between f91571e and c5c72f1.

📒 Files selected for processing (15)
  • plugins/preview-forge/commands/bootstrap.md
  • plugins/preview-forge/commands/budget.md
  • plugins/preview-forge/commands/design.md
  • plugins/preview-forge/commands/export.md
  • plugins/preview-forge/commands/freeze.md
  • plugins/preview-forge/commands/gallery.md
  • plugins/preview-forge/commands/help.md
  • plugins/preview-forge/commands/lessons.md
  • plugins/preview-forge/commands/new.md
  • plugins/preview-forge/commands/panel.md
  • plugins/preview-forge/commands/preview.md
  • plugins/preview-forge/commands/replay.md
  • plugins/preview-forge/commands/retry.md
  • plugins/preview-forge/commands/seed.md
  • plugins/preview-forge/commands/status.md
✨ Finishing Touches
🧪 Generate unit tests (beta)
  • Create PR with unit tests
  • Commit unit tests in branch fix/113-commands-english

Thanks for using CodeRabbit! It's free for OSS, and your support helps us grow. If you like it, consider giving us a shout-out.

❤️ Share

Comment @coderabbitai help to get the list of available commands and usage tips.

@ComBba
Copy link
Copy Markdown
Contributor Author

ComBba commented Apr 26, 2026

Closing — scope narrowed per user feedback. Translating all 15 command bodies carries behavior-change risk (each body is a system prompt for Claude when its slash command runs). Layer-0 Rule 10 (Output language English, methodology/global.md) already enforces English output regardless of internal command-body language, so the marginal benefit of translating the 13 non-user-facing files is small relative to the risk. Replacing this PR with a narrow follow-up that translates only help.md (the one file whose Korean leaks directly into /pf:help rendering — the actual user complaint in #113). The other 13 files stay Korean for now and can be revisited post-hackathon with proper end-to-end behavioral testing.

@ComBba ComBba closed this Apr 26, 2026
@ComBba ComBba deleted the fix/113-commands-english branch April 26, 2026 20:01
Copy link
Copy Markdown

@gemini-code-assist gemini-code-assist Bot left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Code Review

This pull request translates the documentation for the preview-forge plugin commands from Korean to English and updates the version history to reflect changes through v1.14.1. The updates include detailed descriptions of the /pf:new flow, Socratic interview mechanics, and caching strategies. One review comment was provided regarding the /pf:help documentation, which correctly identified that the promised command summary and FAQ were missing from the file and provided a suggestion to include the list of available commands.

## Behavior

14 명령어 요약 + 자주 묻는 질문 (FAQ).
Summary of the 15 commands plus a frequently asked questions (FAQ) section.
Copy link
Copy Markdown

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

medium

The Behavior section states that the command provides a summary of 15 commands and an FAQ section, but these are not actually present in the file. Since this file serves as the command body for /pf:help, users running the command will not see the promised summary or FAQ. Documentation designated as an authoritative source must be free of errors to maintain its credibility and trustworthiness.

Suggested change
Summary of the 15 commands plus a frequently asked questions (FAQ) section.
Summary of the 15 commands plus a frequently asked questions (FAQ) section.
### Available Commands
- /pf:bootstrap — Initialize plugin memory and permissions.
- /pf:budget — View the cost dashboard.
- /pf:design — Open the design selection gate (H1).
- /pf:export — Package a frozen run.
- /pf:freeze — Force evaluation and attempt to freeze the run.
- /pf:gallery — Browse past runs and previews.
- /pf:help — List all commands and view what's new.
- /pf:lessons — View or edit the failure catalog.
- /pf:new — Start a new Preview Forge run.
- /pf:panel — Manually trigger a decision vote.
- /pf:preview — Launch the local preview server.
- /pf:replay — Replay a past run from trace.
- /pf:retry — Rerun a failed agent or phase.
- /pf:seed — Browse the demo idea bank.
- /pf:status — Show current run state and progress.
References
  1. Documentation designated as an 'authoritative source' must be free of errors, including typos, to maintain its credibility and trustworthiness.

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.

fix(commands): all 15 /pf:* slash command bodies in Korean + /pf:help "What's new" stuck at v1.10.0 (must reach v1.14.1 + maintenance process)

1 participant