From 95dd90ba2ecf7882ca0a908429bfaf508c8e2201 Mon Sep 17 00:00:00 2001 From: Yusuke-KOMIYAMA Date: Wed, 18 Nov 2026 00:40:29 +0900 Subject: [PATCH 1/2] =?UTF-8?q?docs(review):=20=E9=9D=9E=E5=85=AC=E9=96=8B?= =?UTF-8?q?=E3=81=AE=E3=83=AA=E3=83=9D=E3=82=B8=E3=83=88=E3=83=AA=E3=81=AE?= =?UTF-8?q?=E3=83=AC=E3=83=93=E3=83=A5=E3=83=BC=E8=A8=98=E9=8C=B2=E3=81=B8?= =?UTF-8?q?=E3=81=AE=E5=8F=82=E7=85=A7=E3=82=92=E3=80=81=E5=85=AC=E9=96=8B?= =?UTF-8?q?=E3=81=AE=E7=B4=A2=E5=BC=95=E3=81=A8=E8=A8=98=E9=8C=B2=E3=81=8B?= =?UTF-8?q?=E3=82=89=E5=A4=96=E3=81=99?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 所有者の判断(2026-11-17)により、非公開の RDM--dev2027 リポジトリの レビュー記録は、このガイドの非公開の複製に保管する。公開側に残っていた参照を整理する。 - docs/reviews/README.md: 第 5 節の、非公開のリポジトリの欠落した記録の一覧(英・日)を、 非公開の記録は非公開のガイドに置くという説明に置き換えた。版 0.3。 - PR #20 r3 と PR #31 r1 の記録: 非公開のガイドへ移した記録へのリンク(各 1 本)を、 文字だけの注記にした。判定・指摘・本文は変えていない。各版 0.2。 検証: tools/docs_check.py は PASSED(191 件、エラー 0。変更前はリンク切れ 2 件)。 Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01BW1YQju1R8hU1GgE9LhLD4 --- ...loper-guide_PR20_Manifest_Shibboleth_r3.md | 5 ++- ...eloper-guide_PR31_Manifest_Wiki_Run5_r1.md | 5 ++- docs/reviews/README.md | 41 +++---------------- 3 files changed, 12 insertions(+), 39 deletions(-) diff --git a/docs/reviews/2026-11-05_RDM-developer-guide_PR20_Manifest_Shibboleth_r3.md b/docs/reviews/2026-11-05_RDM-developer-guide_PR20_Manifest_Shibboleth_r3.md index 688d140a..3352cc27 100644 --- a/docs/reviews/2026-11-05_RDM-developer-guide_PR20_Manifest_Shibboleth_r3.md +++ b/docs/reviews/2026-11-05_RDM-developer-guide_PR20_Manifest_Shibboleth_r3.md @@ -5,9 +5,10 @@ **Jump:** [English](#english) · [日本語](#japanese) -- Version / 版: 0.1 — 2026-11-05. **Learned:** fixing tracking bullets does not resolve a conflicting universal bootstrap procedure. / 追跡の箇条書きを直しても、全対象に適用する初回構築手順の矛盾は解消しないと分かった。 +- Version / 版: 0.2 — 2026-11-18. **Learned:** a public record links only to public records: the link to r2, a record about private repositories that is kept in the private guide, became plain text. / 公開の記録からは公開の記録にだけリンクする。非公開のリポジトリについての r2 は非公開のガイドに保管しているので、リンクを外して文字だけにした。 + Version / 版: 0.1 — 2026-11-05. **Learned:** fixing tracking bullets does not resolve a conflicting universal bootstrap procedure. / 追跡の箇条書きを直しても、全対象に適用する初回構築手順の矛盾は解消しないと分かった。 - Applies to: [PR #20](https://github.com/RCOSDP/RDM-developer-guide/pull/20), reviewed by REV(担当レビュワ, Codex Astra). A PR is a proposed change / PR は変更の提案です。 -- Related: [Review index](README.md) · [r2](2026-11-05_dev2027_Strict_Reconstruction_PRs_r2.md) · [SPEC-06](../spec/06_documentation_conventions.md) · [SPEC-01](../spec/01_manifest.md) · [ADR-01](../decisions/ADR-01_Integration_Repository_Placement.md) · [Shared glossary](../reference/REF-01_Glossary.md). +- Related: [Review index](README.md) · r2 (kept in the private guide / 非公開のガイドに保管) · [SPEC-06](../spec/06_documentation_conventions.md) · [SPEC-01](../spec/01_manifest.md) · [ADR-01](../decisions/ADR-01_Integration_Repository_Placement.md) · [Shared glossary](../reference/REF-01_Glossary.md). - Used by: [Integration status](../status/README.md), QAE and the owner for verification and acceptance / QAE(QA担当)と所有者の検証・採否判断。 --- diff --git a/docs/reviews/2026-11-06_RDM-developer-guide_PR31_Manifest_Wiki_Run5_r1.md b/docs/reviews/2026-11-06_RDM-developer-guide_PR31_Manifest_Wiki_Run5_r1.md index 70467113..0b83a92a 100644 --- a/docs/reviews/2026-11-06_RDM-developer-guide_PR31_Manifest_Wiki_Run5_r1.md +++ b/docs/reviews/2026-11-06_RDM-developer-guide_PR31_Manifest_Wiki_Run5_r1.md @@ -5,9 +5,10 @@ **Jump:** [English](#english) · [日本語](#japanese) -- Version / 版: 0.1 — 2026-11-06. **Learned:** passing automated checks does not establish the accuracy of step counts, warning categories or translated completion claims; those need comparison with the logs. / 自動検査の合格だけでは段数・警告の分類・翻訳の完了表現の正しさは分からず、ログとの照合が必要である。 +- Version / 版: 0.2 — 2026-11-18. **Learned:** a public record links only to public records: the link to the Wiki PR #2 review, a record about a private repository that is kept in the private guide, became plain text. / 公開の記録からは公開の記録にだけリンクする。非公開のリポジトリについての Wiki PR #2 のレビューは非公開のガイドに保管しているので、リンクを外して文字だけにした。 + Version / 版: 0.1 — 2026-11-06. **Learned:** passing automated checks does not establish the accuracy of step counts, warning categories or translated completion claims; those need comparison with the logs. / 自動検査の合格だけでは段数・警告の分類・翻訳の完了表現の正しさは分からず、ログとの照合が必要である。 - Applies to: RCOSDP/RDM-developer-guide PR #31; REV(担当レビュワ, Codex Astra). -- Related: [Review index](README.md) · [SPEC-01](../spec/01_manifest.md) · [SPEC-06](../spec/06_documentation_conventions.md) · [Wiki PR #2 review](2026-11-06_RDM-wiki-frontend-dev2027_PR2_JS_Deps_Sync_r1.md). +- Related: [Review index](README.md) · [SPEC-01](../spec/01_manifest.md) · [SPEC-06](../spec/06_documentation_conventions.md) · Wiki PR #2 review (kept in the private guide / 非公開のガイドに保管). - Used by: [DEMO-20](../demo/20_core_install_mac_studio.md) · [Status board](../status/README.md). --- diff --git a/docs/reviews/README.md b/docs/reviews/README.md index 9ea480cc..58b9fb11 100644 --- a/docs/reviews/README.md +++ b/docs/reviews/README.md @@ -5,7 +5,8 @@ **Jump:** [English](#english) · [日本語](#japanese) -- Version / 版: 0.2 — 2026-11-12. **Learned:** a review record that was never saved cannot be recreated truthfully, so the gap is stated and the posted pull-request comment is the reference. / 保存されなかったレビュー記録は、後から正確に作り直せない。欠落を明記し、投稿済みの PR コメントを参照先とする。 +- Version / 版: 0.3 — 2026-11-18. **Learned:** a public index lists only records that are public: the records of private repositories, and the list of their missing records, moved to the private guide (owner decision 2026-11-17). / 公開の索引には公開の記録だけを載せる。非公開のリポジトリの記録と、その欠落の一覧は、非公開のガイドに移した(所有者の判断 2026-11-17)。 + Version / 版: 0.2 — 2026-11-12. **Learned:** a review record that was never saved cannot be recreated truthfully, so the gap is stated and the posted pull-request comment is the reference. / 保存されなかったレビュー記録は、後から正確に作り直せない。欠落を明記し、投稿済みの PR コメントを参照先とする。 0.1 — 2026-11-05. **Learned:** every PR gets an independent review, and the review must be kept as its own record so that what was checked, and why, can be read later. / すべての PR は独立したレビューを受け、何をなぜ確かめたかを後から読めるよう、レビューは独自の記録として残す必要があると分かった。 - Normative for: [SPEC-04 Acceptance Tests](../spec/04_acceptance_tests.md) review section, [ADR-04 AI Autonomy and Roles](../decisions/ADR-04_AI_Autonomy_and_Roles.md) review section. - Related: [../README.md](../README.md) · [handoff/](../handoff/README.md) · [status/](../status/README.md) @@ -49,24 +50,9 @@ A review record includes: 3. Describe scope, findings, and approval decision. 4. Link from the PR as "reviewed by REV (Codex Astra)". -### 5. Missing records and the pull-request comments that stand in for them +### 5. Review records of private repositories -Nine review records written on 2026-11-10 were never saved in this folder: they lived only in a scratch directory of a session that ended. They are **not recreated**, because a record rebuilt from memory would not say what REV actually checked. Each one was posted as a comment on its pull request by REV (Codex Astra), and that comment is the reference. The repositories are private; they are named here by name and number only. The comment ID is the number at the end of the comment's address on the pull request page. - -```toon -missing_records[9]{repository,pr,round,comment_id,posted_utc,verdict,head}: - RDM-osf.io-dev2027,#8,r1,6757009993,"2026-11-10 02:12","changes requested",e7f23e13141f - RDM-osf.io-dev2027,#8,r2,6758141691,"2026-11-10 03:28","changes requested",8bb07f17c2 - RDM-osf.io-dev2027,#8,r3,6759472716,"2026-11-10 05:03","pass (R2 delta)",49e5521451 - RDM-osf.io-dev2027,#10,r1,6759171742,"2026-11-10 04:41","changes requested",5355858363b6 - RDM-osf.io-dev2027,#11,r1,6759274738,"2026-11-10 04:48","changes requested",75ceaf5cb492 - RDM-osf.io-dev2027,#11,r2,6760403905,"2026-11-10 06:08","changes requested",58ba83af4b7c - RDM-osf.io-dev2027,#11,r3,6763524193,"2026-11-10 09:13","pass (delta 58ba83a..3eb4042)",3eb4042 - RDM-osf.io-dev2027,#12,r1,6763575801,"2026-11-10 09:16","changes requested",aa30a37d - RDM-osf.io-dev2027,#13,r1,6763600948,"2026-11-10 09:17","changes requested",ef9e64261b -``` - -The owner decided on 2026-11-12 to note the gap and refer to these comments. From now on a review record is placed in this folder as soon as REV finishes it. +Review records of pull requests in the private RDM--dev2027 repositories are not kept in this public repository. The owner decided on 2026-11-17 that they are kept in the private copy of this guide. Review records of pull requests in this repository are kept here. --- @@ -107,24 +93,9 @@ The owner decided on 2026-11-12 to note the gap and refer to these comments. Fro 3. 範囲、調査結果、承認決定を記述する。 4. PR から「REV(Codex Astra)レビュー済み」としてリンクする。 -### 5. 欠落した記録と、代わりの PR コメント - -2026-11-10 に書かれたレビュー記録 9 件は、この場所に保存されませんでした。終了したセッションの作業用ディレクトリにだけあったためです。記憶から作り直した記録は REV が実際に何を調べたかを語れないので、**作り直しません**。各記録は、REV(Codex Astra)が PR へのコメントとして投稿しており、そのコメントを参照先とします。リポジトリは非公開なので、ここでは名前と番号だけを書きます。コメント ID は、PR のページにあるコメントのアドレスの末尾の数字です。 - -```toon -missing_records[9]{repository,pr,round,comment_id,posted_utc,verdict,head}: - RDM-osf.io-dev2027,#8,r1,6757009993,"2026-11-10 02:12","changes requested(要修正)",e7f23e13141f - RDM-osf.io-dev2027,#8,r2,6758141691,"2026-11-10 03:28","changes requested(要修正)",8bb07f17c2 - RDM-osf.io-dev2027,#8,r3,6759472716,"2026-11-10 05:03","pass(R2 の差分)",49e5521451 - RDM-osf.io-dev2027,#10,r1,6759171742,"2026-11-10 04:41","changes requested(要修正)",5355858363b6 - RDM-osf.io-dev2027,#11,r1,6759274738,"2026-11-10 04:48","changes requested(要修正)",75ceaf5cb492 - RDM-osf.io-dev2027,#11,r2,6760403905,"2026-11-10 06:08","changes requested(要修正)",58ba83af4b7c - RDM-osf.io-dev2027,#11,r3,6763524193,"2026-11-10 09:13","pass(差分 58ba83a..3eb4042)",3eb4042 - RDM-osf.io-dev2027,#12,r1,6763575801,"2026-11-10 09:16","changes requested(要修正)",aa30a37d - RDM-osf.io-dev2027,#13,r1,6763600948,"2026-11-10 09:17","changes requested(要修正)",ef9e64261b -``` +### 5. 非公開のリポジトリのレビュー記録 -所有者は 2026-11-12 に、欠落を明記してこれらのコメントを参照することに決めました。以後、REV のレビュー記録は完了したらすぐにこの場所へ収めます。 +非公開の RDM--dev2027 リポジトリの PR のレビュー記録は、この公開リポジトリには置きません。所有者は 2026-11-17 に、それらをこのガイドの非公開の複製に保管すると決めました。このリポジトリの PR のレビュー記録は、ここに置きます。 --- From 0b324885806182cbdd54f831804cb6b3f82bf4ca Mon Sep 17 00:00:00 2001 From: Yusuke-KOMIYAMA Date: Wed, 18 Nov 2026 00:42:27 +0900 Subject: [PATCH 2/2] =?UTF-8?q?docs(review):=20REV=20r1=20=E3=81=AE?= =?UTF-8?q?=E6=8C=87=E6=91=98=E3=81=AB=E5=AF=BE=E5=BF=9C=E3=81=99=E3=82=8B?= =?UTF-8?q?=EF=BC=88=E6=97=A7=E7=89=88=E3=81=AE=E8=A1=8C=E3=81=AE=E6=9B=B8?= =?UTF-8?q?=E5=BC=8F=E3=80=81=E7=B4=A2=E5=BC=95=E3=81=AE=E7=89=88=E3=81=AE?= =?UTF-8?q?=E8=AA=AC=E6=98=8E=E3=81=AE=E7=AF=84=E5=9B=B2=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit R1-01: 字下げした旧版の 3 行から「Version / 版:」を外し、慣例に合わせた。 R1-02: 索引の版 0.3 の説明を、実際に行った範囲(索引から一覧を外したこと)に絞った。 Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01BW1YQju1R8hU1GgE9LhLD4 --- ...6-11-05_RDM-developer-guide_PR20_Manifest_Shibboleth_r3.md | 2 +- ...26-11-06_RDM-developer-guide_PR31_Manifest_Wiki_Run5_r1.md | 2 +- docs/reviews/README.md | 4 ++-- 3 files changed, 4 insertions(+), 4 deletions(-) diff --git a/docs/reviews/2026-11-05_RDM-developer-guide_PR20_Manifest_Shibboleth_r3.md b/docs/reviews/2026-11-05_RDM-developer-guide_PR20_Manifest_Shibboleth_r3.md index 3352cc27..9e63ecf5 100644 --- a/docs/reviews/2026-11-05_RDM-developer-guide_PR20_Manifest_Shibboleth_r3.md +++ b/docs/reviews/2026-11-05_RDM-developer-guide_PR20_Manifest_Shibboleth_r3.md @@ -6,7 +6,7 @@ **Jump:** [English](#english) · [日本語](#japanese) - Version / 版: 0.2 — 2026-11-18. **Learned:** a public record links only to public records: the link to r2, a record about private repositories that is kept in the private guide, became plain text. / 公開の記録からは公開の記録にだけリンクする。非公開のリポジトリについての r2 は非公開のガイドに保管しているので、リンクを外して文字だけにした。 - Version / 版: 0.1 — 2026-11-05. **Learned:** fixing tracking bullets does not resolve a conflicting universal bootstrap procedure. / 追跡の箇条書きを直しても、全対象に適用する初回構築手順の矛盾は解消しないと分かった。 + 0.1 — 2026-11-05. **Learned:** fixing tracking bullets does not resolve a conflicting universal bootstrap procedure. / 追跡の箇条書きを直しても、全対象に適用する初回構築手順の矛盾は解消しないと分かった。 - Applies to: [PR #20](https://github.com/RCOSDP/RDM-developer-guide/pull/20), reviewed by REV(担当レビュワ, Codex Astra). A PR is a proposed change / PR は変更の提案です。 - Related: [Review index](README.md) · r2 (kept in the private guide / 非公開のガイドに保管) · [SPEC-06](../spec/06_documentation_conventions.md) · [SPEC-01](../spec/01_manifest.md) · [ADR-01](../decisions/ADR-01_Integration_Repository_Placement.md) · [Shared glossary](../reference/REF-01_Glossary.md). - Used by: [Integration status](../status/README.md), QAE and the owner for verification and acceptance / QAE(QA担当)と所有者の検証・採否判断。 diff --git a/docs/reviews/2026-11-06_RDM-developer-guide_PR31_Manifest_Wiki_Run5_r1.md b/docs/reviews/2026-11-06_RDM-developer-guide_PR31_Manifest_Wiki_Run5_r1.md index 0b83a92a..70ff6d0b 100644 --- a/docs/reviews/2026-11-06_RDM-developer-guide_PR31_Manifest_Wiki_Run5_r1.md +++ b/docs/reviews/2026-11-06_RDM-developer-guide_PR31_Manifest_Wiki_Run5_r1.md @@ -6,7 +6,7 @@ **Jump:** [English](#english) · [日本語](#japanese) - Version / 版: 0.2 — 2026-11-18. **Learned:** a public record links only to public records: the link to the Wiki PR #2 review, a record about a private repository that is kept in the private guide, became plain text. / 公開の記録からは公開の記録にだけリンクする。非公開のリポジトリについての Wiki PR #2 のレビューは非公開のガイドに保管しているので、リンクを外して文字だけにした。 - Version / 版: 0.1 — 2026-11-06. **Learned:** passing automated checks does not establish the accuracy of step counts, warning categories or translated completion claims; those need comparison with the logs. / 自動検査の合格だけでは段数・警告の分類・翻訳の完了表現の正しさは分からず、ログとの照合が必要である。 + 0.1 — 2026-11-06. **Learned:** passing automated checks does not establish the accuracy of step counts, warning categories or translated completion claims; those need comparison with the logs. / 自動検査の合格だけでは段数・警告の分類・翻訳の完了表現の正しさは分からず、ログとの照合が必要である。 - Applies to: RCOSDP/RDM-developer-guide PR #31; REV(担当レビュワ, Codex Astra). - Related: [Review index](README.md) · [SPEC-01](../spec/01_manifest.md) · [SPEC-06](../spec/06_documentation_conventions.md) · Wiki PR #2 review (kept in the private guide / 非公開のガイドに保管). - Used by: [DEMO-20](../demo/20_core_install_mac_studio.md) · [Status board](../status/README.md). diff --git a/docs/reviews/README.md b/docs/reviews/README.md index 58b9fb11..a57c01bd 100644 --- a/docs/reviews/README.md +++ b/docs/reviews/README.md @@ -5,8 +5,8 @@ **Jump:** [English](#english) · [日本語](#japanese) -- Version / 版: 0.3 — 2026-11-18. **Learned:** a public index lists only records that are public: the records of private repositories, and the list of their missing records, moved to the private guide (owner decision 2026-11-17). / 公開の索引には公開の記録だけを載せる。非公開のリポジトリの記録と、その欠落の一覧は、非公開のガイドに移した(所有者の判断 2026-11-17)。 - Version / 版: 0.2 — 2026-11-12. **Learned:** a review record that was never saved cannot be recreated truthfully, so the gap is stated and the posted pull-request comment is the reference. / 保存されなかったレビュー記録は、後から正確に作り直せない。欠落を明記し、投稿済みの PR コメントを参照先とする。 +- Version / 版: 0.3 — 2026-11-18. **Learned:** a public index lists only records that are public: the list of the missing records of a private repository was taken out of this index, and section 5 now says that records of private repositories are kept in the private guide (owner decision 2026-11-17). / 公開の索引には公開の記録だけを載せる。非公開のリポジトリの欠落した記録の一覧をこの索引から外し、第 5 節には、非公開のリポジトリの記録は非公開のガイドに置くと書いた(所有者の判断 2026-11-17)。 + 0.2 — 2026-11-12. **Learned:** a review record that was never saved cannot be recreated truthfully, so the gap is stated and the posted pull-request comment is the reference. / 保存されなかったレビュー記録は、後から正確に作り直せない。欠落を明記し、投稿済みの PR コメントを参照先とする。 0.1 — 2026-11-05. **Learned:** every PR gets an independent review, and the review must be kept as its own record so that what was checked, and why, can be read later. / すべての PR は独立したレビューを受け、何をなぜ確かめたかを後から読めるよう、レビューは独自の記録として残す必要があると分かった。 - Normative for: [SPEC-04 Acceptance Tests](../spec/04_acceptance_tests.md) review section, [ADR-04 AI Autonomy and Roles](../decisions/ADR-04_AI_Autonomy_and_Roles.md) review section. - Related: [../README.md](../README.md) · [handoff/](../handoff/README.md) · [status/](../status/README.md)