harnessworks · baskduf · Jun 18, 2026 · Jun 18, 2026
diff --git a/CHANGELOG.md b/CHANGELOG.md
@@ -4,6 +4,11 @@ Notable project changes should be recorded here before release tags are cut.
 
 ## Unreleased
 
+### Changed
+
+- Align localized README command sections with the stage-based command UX used
+  by the English README.
+
 ## v0.1.15 - 2026-06-18
 
 Patch release for clearer Codex and Claude command UX.

diff --git a/README.ja.md b/README.ja.md
@@ -135,22 +135,34 @@ repository evidence をスキャンできますが、agent が mistakes を減
 test または CI check、decision/failure record、drift check の少なくとも一つの
 durable artifact に変換します。
 
-## コマンド
+## コマンドフロー
 
 以下の `/harness ...` 名は、デフォルトでは組み込み editor command ではなく
 prompt convention です。coding agent chat に直接入力または貼り付けてください。
 Cursor などの editor では、対応する custom slash command を別途追加しない限り
 command palette には表示されません。
 
-| Command | Use when |
-| --- | --- |
-| `/harness doctor` | ファイルを変更せずに baseline harness evidence を採点するとき。 |
-| `/harness update` | 導入後にローカル `./harness-starter-kit` reference を更新するとき。 |
-| `/harness refresh` | stale、duplicated、obsolete、unused target harness guidance をレビューするとき。 |
-| `/harness review` | 完了前に現在の change set を批判的に確認するとき。 |
-| `/harness review sub-agent` | runtime が許可する場合に read-only reviewer subagent を明示的に依頼するとき。 |
+コマンドは利用段階ごとに考えてください:
+
+| 段階 | Command | Use when |
+| --- | --- | --- |
+| 初回 | `/harness doctor` | ファイルを変更せずに現在の harness readiness を確認するとき。 |
+| 初回 | `/harness adopt` | この repository に最小限で有用な harness 要素を適用するとき。 |
+| 日常作業 | `/harness review` | commit または PR の前に現在の diff を批判的に確認するとき。 |
+| 日常作業 | `/harness review sub-agent` | runtime が許可する場合に read-only reviewer subagent を明示的に依頼するとき。 |
+| メンテナンス | `/harness update` | 新しい `harness-starter-kit` reference を取り込み、この repo に選択的に反映するとき。 |
+| メンテナンス | `/harness refresh` | この repo 内の stale、duplicated、obsolete、unused harness guidance を整理するとき。 |
+
+簡単なルール:
+
+- `doctor` は確認するときに使います。
+- `adopt` は始めるときに使います。
+- `review` は作業完了前に使います。
+- `update` は kit version が変わったときに使います。
+- `refresh` はこの repo の既存 harness guidance が古くなったときに使います。
 
 完全な workflow は [`commands/`](commands/) を参照してください:
+[`adopt`](commands/harness-adopt.md),
 [`doctor`](commands/harness-doctor.md),
 [`update`](commands/harness-update.md),
 [`refresh`](commands/harness-refresh.md),
@@ -170,11 +182,27 @@ codex plugin marketplace add harnessworks/harness-agent-skills-marketplace --ref
 Codex を再起動し、Plugins 画面を開いて `Harnessworks` marketplace から
 `harness-agent-skills` を install してください。
 
-使用例:
+すべての runtime で同じ command model を使います:
+
+```text
+Start:      $harness doctor → $harness adopt
+Daily:      $harness review
+Maintain:   $harness update or $harness refresh
+```
+
+よく使うコマンド:
 
 ```text
 $harness doctor
-$harness-review
+$harness adopt
+$harness review
+```
+
+メンテナンスコマンド:
+
+```text
+$harness update
+$harness refresh
 ```
 
 ### Claude Code
@@ -184,13 +212,29 @@ claude plugin marketplace add harnessworks/harness-agent-skills-marketplace@v0.1
 claude plugin install harness-agent-skills@harnessworks
 ```
 
-使用例:
+Router command を使います:
+
+```text
+Start:      /harness-agent-skills:harness doctor → /harness-agent-skills:harness adopt
+Daily:      /harness-agent-skills:harness review
+Maintain:   /harness-agent-skills:harness update or /harness-agent-skills:harness refresh
+```
+
+よく使うコマンド:
 
 ```text
 /harness-agent-skills:harness doctor
+/harness-agent-skills:harness adopt
 /harness-agent-skills:harness review
 ```
 
+メンテナンスコマンド:
+
+```text
+/harness-agent-skills:harness update
+/harness-agent-skills:harness refresh
+```
+
 ソース package は [`agent-skills/`](agent-skills/) にあります。repo-local
 direct install、packaging details、update behavior については
 [`docs/agent-skills-package.md`](docs/agent-skills-package.md) を参照してください。

diff --git a/README.ko.md b/README.ko.md
@@ -133,22 +133,34 @@ Harness health는 agent effectiveness와 다릅니다. Harness Doctor는 지속
 CI check, decision/failure record, drift check 중 하나 이상의 durable artifact로
 전환해야 합니다.
 
-## 명령
+## 명령 흐름
 
 아래 `/harness ...` 이름은 기본적으로 내장 editor command가 아니라 prompt
 convention입니다. 코딩 에이전트 chat에 직접 입력하거나 붙여넣으세요. Cursor 같은
 editor에서는 matching custom slash command를 별도로 추가하지 않는 한 command
 palette에 표시되지 않습니다.
 
-| Command | Use when |
-| --- | --- |
-| `/harness doctor` | 파일을 수정하지 않고 baseline harness evidence를 채점할 때. |
-| `/harness update` | 도입 후 로컬 `./harness-starter-kit` reference를 갱신할 때. |
-| `/harness refresh` | stale, duplicated, obsolete, unused target harness guidance를 검토할 때. |
-| `/harness review` | 마무리 전에 현재 change set을 비판적으로 점검할 때. |
-| `/harness review sub-agent` | runtime이 허용할 때 read-only reviewer subagent를 명시적으로 요청할 때. |
+명령은 사용 단계별로 생각하면 됩니다:
+
+| 단계 | Command | Use when |
+| --- | --- | --- |
+| 처음 사용 | `/harness doctor` | 파일을 수정하지 않고 현재 harness readiness를 점검할 때. |
+| 처음 사용 | `/harness adopt` | 이 저장소에 가장 작은 유용한 harness 조각을 적용할 때. |
+| 일상 작업 | `/harness review` | commit 또는 PR 전에 현재 diff를 비판적으로 점검할 때. |
+| 일상 작업 | `/harness review sub-agent` | runtime이 허용할 때 read-only reviewer subagent를 명시적으로 요청할 때. |
+| 유지보수 | `/harness update` | 더 새 `harness-starter-kit` reference를 가져와 이 repo에 선택적으로 반영할 때. |
+| 유지보수 | `/harness refresh` | 이 repo 안의 stale, duplicated, obsolete, unused harness guidance를 정리할 때. |
+
+빠른 규칙:
+
+- `doctor`는 점검할 때 사용합니다.
+- `adopt`는 시작할 때 사용합니다.
+- `review`는 작업을 끝내기 전에 사용합니다.
+- `update`는 kit version이 바뀌었을 때 사용합니다.
+- `refresh`는 이 repo의 기존 harness guidance가 낡았을 때 사용합니다.
 
 전체 workflow는 [`commands/`](commands/)를 보세요:
+[`adopt`](commands/harness-adopt.md),
 [`doctor`](commands/harness-doctor.md),
 [`update`](commands/harness-update.md),
 [`refresh`](commands/harness-refresh.md),
@@ -168,11 +180,27 @@ codex plugin marketplace add harnessworks/harness-agent-skills-marketplace --ref
 Codex를 재시작한 뒤 Plugins 화면을 열고 `Harnessworks` marketplace에서
 `harness-agent-skills`를 설치하세요.
 
-사용 예:
+모든 runtime에서 같은 command model을 사용합니다:
+
+```text
+Start:      $harness doctor → $harness adopt
+Daily:      $harness review
+Maintain:   $harness update or $harness refresh
+```
+
+자주 쓰는 명령:
 
 ```text
 $harness doctor
-$harness-review
+$harness adopt
+$harness review
+```
+
+유지보수 명령:
+
+```text
+$harness update
+$harness refresh
 ```
 
 ### Claude Code
@@ -182,13 +210,29 @@ claude plugin marketplace add harnessworks/harness-agent-skills-marketplace@v0.1
 claude plugin install harness-agent-skills@harnessworks
 ```
 
-사용 예:
+Router command를 사용합니다:
+
+```text
+Start:      /harness-agent-skills:harness doctor → /harness-agent-skills:harness adopt
+Daily:      /harness-agent-skills:harness review
+Maintain:   /harness-agent-skills:harness update or /harness-agent-skills:harness refresh
+```
+
+자주 쓰는 명령:
 
 ```text
 /harness-agent-skills:harness doctor
+/harness-agent-skills:harness adopt
 /harness-agent-skills:harness review
 ```
 
+유지보수 명령:
+
+```text
+/harness-agent-skills:harness update
+/harness-agent-skills:harness refresh
+```
+
 소스 패키지는 [`agent-skills/`](agent-skills/)에 있습니다. repo-local 직접 설치,
 packaging 세부사항, update 동작은
 [`docs/agent-skills-package.md`](docs/agent-skills-package.md)를 보세요.

diff --git a/README.zh-CN.md b/README.zh-CN.md
@@ -133,21 +133,33 @@ effectiveness reports 单独测量。模型见
 instruction、automated constraint、test 或 CI check、decision/failure record，
 或 drift check。
 
-## 命令
+## 命令流程
 
 下面的 `/harness ...` 名称默认是 prompt convention，不是内置 editor command。
 请把它们输入或粘贴到 coding agent chat 中。在 Cursor 等 editor 里，除非另外添加
 对应的 custom slash command，否则它们不会出现在 command palette 中。
 
-| Command | Use when |
-| --- | --- |
-| `/harness doctor` | 在不修改文件的情况下评分 baseline harness evidence。 |
-| `/harness update` | adoption 后刷新本地 `./harness-starter-kit` reference。 |
-| `/harness refresh` | 检查 stale、duplicated、obsolete 或 unused target harness guidance。 |
-| `/harness review` | 完成前批判性检查当前 change set。 |
-| `/harness review sub-agent` | runtime 允许时明确请求 read-only reviewer subagent。 |
+按用户阶段理解这些命令:
+
+| 阶段 | Command | Use when |
+| --- | --- | --- |
+| 首次使用 | `/harness doctor` | 在不修改文件的情况下检查当前 harness readiness。 |
+| 首次使用 | `/harness adopt` | 为这个 repository 应用最小但有用的 harness 部分。 |
+| 日常工作 | `/harness review` | 在 commit 或 PR 前批判性检查当前 diff。 |
+| 日常工作 | `/harness review sub-agent` | runtime 允许时明确请求 read-only reviewer subagent。 |
+| 维护 | `/harness update` | 引入更新的 `harness-starter-kit` reference，并选择性更新这个 repo。 |
+| 维护 | `/harness refresh` | 清理这个 repo 中 stale、duplicated、obsolete 或 unused harness guidance。 |
+
+快速规则:
+
+- 用 `doctor` 做检查。
+- 用 `adopt` 开始采用。
+- 用 `review` 在完成工作前复核。
+- kit version 改变时用 `update`。
+- 这个 repo 的既有 harness guidance 变旧时用 `refresh`。
 
 完整 workflow 见 [`commands/`](commands/):
+[`adopt`](commands/harness-adopt.md),
 [`doctor`](commands/harness-doctor.md),
 [`update`](commands/harness-update.md),
 [`refresh`](commands/harness-refresh.md),
@@ -167,11 +179,27 @@ codex plugin marketplace add harnessworks/harness-agent-skills-marketplace --ref
 重启 Codex，打开 Plugins 页面，在 `Harnessworks` marketplace 中安装
 `harness-agent-skills`。
 
-使用示例：
+所有 runtime 使用同一套 command model:
+
+```text
+Start:      $harness doctor → $harness adopt
+Daily:      $harness review
+Maintain:   $harness update or $harness refresh
+```
+
+常用命令:
 
 ```text
 $harness doctor
-$harness-review
+$harness adopt
+$harness review
+```
+
+维护命令:
+
+```text
+$harness update
+$harness refresh
 ```
 
 ### Claude Code
@@ -181,13 +209,29 @@ claude plugin marketplace add harnessworks/harness-agent-skills-marketplace@v0.1
 claude plugin install harness-agent-skills@harnessworks
 ```
 
-使用示例：
+使用 router command:
+
+```text
+Start:      /harness-agent-skills:harness doctor → /harness-agent-skills:harness adopt
+Daily:      /harness-agent-skills:harness review
+Maintain:   /harness-agent-skills:harness update or /harness-agent-skills:harness refresh
+```
+
+常用命令:
 
 ```text
 /harness-agent-skills:harness doctor
+/harness-agent-skills:harness adopt
 /harness-agent-skills:harness review
 ```
 
+维护命令:
+
+```text
+/harness-agent-skills:harness update
+/harness-agent-skills:harness refresh
+```
+
 源包位于 [`agent-skills/`](agent-skills/)。repo-local 直接安装、packaging 细节和
 update 行为见
 [`docs/agent-skills-package.md`](docs/agent-skills-package.md)。