Skip to content

chore: rewrite repo in idiomatic English (agents, skills, docs, codex)#21

Merged
Pantani merged 3 commits into
mainfrom
chore/english-only-repo
Jun 2, 2026
Merged

chore: rewrite repo in idiomatic English (agents, skills, docs, codex)#21
Pantani merged 3 commits into
mainfrom
chore/english-only-repo

Conversation

@Pantani
Copy link
Copy Markdown
Owner

@Pantani Pantani commented Jun 2, 2026

Summary

Repo-wide sweep converting residual Portuguese prose into idiomatic English. Not a literal translation — text was rewritten so trigger vocabulary in skill/agent descriptions stays discoverable in English while all technical anchors are preserved verbatim.

Changes

  • .claude/agents/* (25 subagent definitions): publishers, docs, test-harness, implementation team.
  • .claude/skills/* + .agents/skills/* (6 SKILL.md): orchestrator, docs-orchestrator, test-harness, publisher. description: fields rewritten — the auto-invocation contract is now English ("real tests", "next phase", "run it again", etc.) but technical anchors are kept (Anchor, Codama, Pinocchio, Surfpool, cargo-dist, stdio JSON-RPC, gRPC, Phase 6/7/8, scaffold, recipes, …).
  • .codex/agents/*.toml (6 files): TOML structure preserved, prose rewritten.
  • AGENTS.md, CLAUDE.md: trigger phrases and one variation-log row.

Preserved verbatim

Code blocks, identifiers, file paths, exit codes, NDJSON event names, JSON/YAML payloads, marker tags, YAML name:/tools:/model:, ADR cross-refs, dates, PR numbers, commit hashes.

Already fluent English (no edits)

README, CHANGELOG, ROADMAP, IMPLEMENTATION-KICKOFF, all docs/adr/ADR-*, all docs/reference/*, all docs/site/src/** (Learn, Guides, Concepts, Reference, Contributing), assets/learn/*, assets/examples/*/README.md, GitHub templates.

Untouched

Rust source, tests, templates, golden snapshots. No code changes — cargo check --no-default-features clean.

Reviewer notes

  • The most sensitive change is the four skill description: fields, which drive auto-invocation. Triggers were remapped (not literally translated) to English equivalents — please skim and flag if any PT phrase you commonly use should also be retained as an alias.
  • docs-tutorial-writer.md and docs-reviewer.md had a "⏱" emoji replaced with "Time:" per the no-emoji guidance — easy to revert if you'd rather keep the icon.
  • ADR-0001 historical Go/solis references intentionally kept.

Checklist

  • No Rust changed (cargo check --no-default-features green)
  • cargo fmt --all — n/a
  • cargo clippy --all-targets -- -D warnings — n/a
  • cargo test --all — n/a (no code touched)
  • Docs updated (this PR)

🤖 Generated with Claude Code

Sweep of Portuguese prose across .claude/agents (25), .claude/skills + .agents/skills (6), .codex/agents (6 TOML), AGENTS.md, CLAUDE.md. Rewritten for clarity, not literal translation. Trigger vocabulary in skill descriptions is now English; technical anchors (Anchor, Codama, Pinocchio, Surfpool, cargo-dist, stdio JSON-RPC, gRPC) preserved.

Preserved verbatim: code blocks, identifiers, file paths, exit codes, NDJSON event names, JSON payloads, marker tags, dates, PR numbers.

Untouched (already fluent English): README, CHANGELOG, ROADMAP, IMPLEMENTATION-KICKOFF, all docs/adr, all docs/reference, all docs/site/src. No Rust source, tests, templates, or golden snapshots modified.

Co-Authored-By: Claude Opus 4.7 <noreply@anthropic.com>
@coderabbitai
Copy link
Copy Markdown

coderabbitai Bot commented Jun 2, 2026

Warning

Review limit reached

@Pantani, we couldn't start this review because you've reached your PR review rate limit.

More reviews will be available in 41 minutes and 55 seconds. Learn how PR review limits work.

Your organization has run out of usage credits. Purchase more in the billing tab.

⌛ How to resolve this issue?

After more reviews become available, 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 include higher PR review limits than trial, open-source, and free plans. In all cases, reviews become available again over time. During sustained high-volume PR review activity, CodeRabbit may temporarily slow when the next review becomes available.

Please see our Fair Usage Limits Policy for further information.

ℹ️ Review info
⚙️ Run configuration

Configuration used: Organization UI

Review profile: ASSERTIVE

Plan: Pro

Run ID: 6afbd2e4-0bcd-40e6-ae59-a3447489b52f

📥 Commits

Reviewing files that changed from the base of the PR and between bf1b43f and c6bc8dc.

📒 Files selected for processing (39)
  • .agents/skills/sunscreen-orchestrator/SKILL.md
  • .agents/skills/sunscreen-test-harness/SKILL.md
  • .claude/agents/apt-publisher.md
  • .claude/agents/cli-architect.md
  • .claude/agents/config-engineer.md
  • .claude/agents/docs-architect.md
  • .claude/agents/docs-designer.md
  • .claude/agents/docs-reference-writer.md
  • .claude/agents/docs-reviewer.md
  • .claude/agents/docs-tutorial-writer.md
  • .claude/agents/docs-writer.md
  • .claude/agents/flake-perf-auditor.md
  • .claude/agents/frontend-codegen-owner.md
  • .claude/agents/homebrew-publisher.md
  • .claude/agents/offline-ci-owner.md
  • .claude/agents/pinocchio-sbf-owner.md
  • .claude/agents/plugin-runtime-qa.md
  • .claude/agents/qa-integrator.md
  • .claude/agents/real-anchor-codama-owner.md
  • .claude/agents/release-distribution-qa.md
  • .claude/agents/release-orchestrator.md
  • .claude/agents/serve-runtime-owner.md
  • .claude/agents/snap-publisher.md
  • .claude/agents/template-engineer.md
  • .claude/agents/test-harness-orchestrator.md
  • .claude/agents/test-strategist.md
  • .claude/agents/toolchain-detector.md
  • .claude/skills/sunscreen-docs-orchestrator/SKILL.md
  • .claude/skills/sunscreen-orchestrator/SKILL.md
  • .claude/skills/sunscreen-publisher/SKILL.md
  • .claude/skills/sunscreen-test-harness/SKILL.md
  • .codex/agents/cli-architect.toml
  • .codex/agents/config-engineer.toml
  • .codex/agents/docs-writer.toml
  • .codex/agents/qa-integrator.toml
  • .codex/agents/template-engineer.toml
  • .codex/agents/toolchain-detector.toml
  • AGENTS.md
  • CLAUDE.md

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.

@Pantani Pantani merged commit 2144b42 into main Jun 2, 2026
12 checks passed
@Pantani Pantani deleted the chore/english-only-repo branch June 2, 2026 22:57
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