From 95dd90ba2ecf7882ca0a908429bfaf508c8e2201 Mon Sep 17 00:00:00 2001 From: Yusuke-KOMIYAMA Date: Wed, 18 Nov 2026 00:40:29 +0900 Subject: [PATCH 1/3] =?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/3] =?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) From dfd609278e11b0c145f3aac2efd93809cb31d6c0 Mon Sep 17 00:00:00 2001 From: Yusuke-KOMIYAMA Date: Wed, 18 Nov 2026 00:55:58 +0900 Subject: [PATCH 3/3] =?UTF-8?q?docs:=20=E5=85=AC=E9=96=8B=E3=81=AE?= =?UTF-8?q?=E8=A8=98=E9=8C=B2=E3=81=8B=E3=82=89=E3=83=AD=E3=83=BC=E3=82=AB?= =?UTF-8?q?=E3=83=AB=E3=81=AE=E3=83=91=E3=82=B9=E3=81=A8=E9=9D=9E=E5=85=AC?= =?UTF-8?q?=E9=96=8B=E3=81=AE=E3=83=AA=E3=83=9D=E3=82=B8=E3=83=88=E3=83=AA?= =?UTF-8?q?=E3=81=AE=E8=A8=98=E9=8C=B2=E3=81=AE=E8=A1=A8=E3=82=92=E5=A4=96?= =?UTF-8?q?=E3=81=97=E3=80=81ADR-04=20=E3=81=AE=E5=8F=82=E7=85=A7=E3=82=92?= =?UTF-8?q?=E3=83=95=E3=82=A1=E3=82=A4=E3=83=AB=E5=90=8D=E3=81=AA=E3=81=97?= =?UTF-8?q?=E3=81=AB=E3=81=99=E3=82=8B?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - PR48 の記録 r1・r2: 出典の作業用のパスを一般的な説明にした。r1 の非公開のリポジトリの 9 件の記録の表(英・日)を、非公開のガイドに保管しているという注記に置き換えた。各版 0.3。 - PR25 の記録 r3・r4、PR45 の記録 r1・r2: 手元の作業用のパスを一般的な説明にした。 - ADR-04: 委任の記録の行(英・日)が挙げていた、非公開のガイドへ移したレビュー記録の ファイル名を、ファイル名なしの説明にした。版 0.8。 判定・指摘・本文は変えていない。 検証(このコミットの tree に対して): 所有者のユーザー名を含むパスとホスト名は git grep で 0 件。 #106 のブランチとの差分は 7 文書だけ。docs_check は PASSED、git diff --check は問題なし。 Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01BW1YQju1R8hU1GgE9LhLD4 --- .../decisions/ADR-04_AI_Autonomy_and_Roles.md | 7 +++-- ...veloper-guide_PR25_Environment_Guide_r3.md | 5 +-- ...veloper-guide_PR25_Environment_Guide_r4.md | 5 +-- ...1_RDM-developer-guide_PR45_Pin_Py313_r1.md | 5 +-- ...1_RDM-developer-guide_PR45_Pin_Py313_r2.md | 5 +-- ...developer-guide_PR48_Missing_Records_r1.md | 31 +++---------------- ...developer-guide_PR48_Missing_Records_r2.md | 5 +-- 7 files changed, 24 insertions(+), 39 deletions(-) diff --git a/docs/decisions/ADR-04_AI_Autonomy_and_Roles.md b/docs/decisions/ADR-04_AI_Autonomy_and_Roles.md index b4062858..64bfd661 100644 --- a/docs/decisions/ADR-04_AI_Autonomy_and_Roles.md +++ b/docs/decisions/ADR-04_AI_Autonomy_and_Roles.md @@ -5,7 +5,8 @@ **Jump:** [English](#english) · [日本語](#japanese) -- Version / 版: 0.7 — 2026-11-10. **Learned:** a merge condition stated as "every check green" is vacuously true when no check exists, so the condition must say what happens without CI. / 「すべての検査が緑」という条件は、検査が一つもないと形の上で成り立ってしまう。CI がないときの扱いを条件に書く必要がある。 +- Version / 版: 0.8 — 2026-11-18. **Learned:** a public decision record names only public files: the delegation log now refers to the strict-reconstruction review records, kept in the private guide, without their file names. / 公開の決定記録には公開のファイルの名前だけを書く。委任の記録は、非公開のガイドに保管した厳密再構築のレビュー記録を、ファイル名なしで指すようにした。 + 0.7 — 2026-11-10. **Learned:** a merge condition stated as "every check green" is vacuously true when no check exists, so the condition must say what happens without CI. / 「すべての検査が緑」という条件は、検査が一つもないと形の上で成り立ってしまう。CI がないときの扱いを条件に書く必要がある。 0.6 — 2026-11-10. **Learned:** a delegation that names a model stops applying when another model continues the work, so the owner has to extend it explicitly. / モデルを名指しした委任は、別のモデルが作業を引き継ぐと適用できない。所有者が明示して広げる必要がある。 - Version / 版: 0.5 — 2026-11-06. **Learned:** a glossary term is only explained for the reader when its note and REF-01 link sit at the first prose use, counting lower-case and plural forms, so first-use notes with links were added in both halves (SPEC-06 §3). / 用語注と REF-01 へのリンクは、小文字や複数形も含めた本文の初出に置かなければ読者に届かないと分かったため、英和両方の初出にリンク付きの用語注を補った(SPEC-06 §3)。 - Version / 版: 0.4 — 2026-11-06. **Learned:** per-PR delegation questions interrupt the owner several times a day during a review-heavy milestone; a standing delegation with explicit conditions and an expiry keeps the human rule while removing the waits. / レビューの多い節目では PR ごとの委任確認が一日に何度も所有者を止める。条件と期限を明示した常設委任なら、人の規則を保ちつつ待ちをなくせる。 @@ -114,7 +115,7 @@ A PR without all four is not ready for the owner; QAE returns it to AID. | Date | Exception | Scope | Granted by | Evidence | |---|---|---|---|---| | 2026-11-05 | QAE (Claude Code Fable) merges PR #19 of RDM-developer-guide itself, using the repository administrator path of the branch protection because the author cannot approve its own pull request | This one pull request only. Merge, not approve; no other repository | Owner, in the session dialogue | REV r3 record `docs/reviews/2026-11-05_RDM-developer-guide_M1_Skeleton_PR_r3.md` (approve recommended), CI 6/6 green on the merged head | -| 2026-11-06 | QAE (Claude Code Fable) merges, under the owner's explicit delegation given in the session dialogue: RDM-developer-guide PR #20 (manifest: Shibboleth-SP public upstream; ADR-01 §3/§5; Codex r4 pass) and PR #21 (installer M2 stage 1; Codex r5 pass, CI 6/6), and the seven strict-reconstruction pull requests in the private `-dev2027` repositories (Codex r1 pass for five, r2 confirmation for osf.io #2 and Shibboleth-SP #1). Repository-administrator path because the author cannot approve its own pull requests | These nine pull requests only; merge, not approve; no force-push | Owner, in the session dialogue (2026-11-06) | Review records `docs/reviews/2026-11-05_RDM-developer-guide_PR20_*_r4.md`, `2026-11-06_RDM-developer-guide_PR21_Installer_r5.md`, `2026-11-05_dev2027_Strict_Reconstruction_PRs_r1.md`/`_r2.md` | +| 2026-11-06 | QAE (Claude Code Fable) merges, under the owner's explicit delegation given in the session dialogue: RDM-developer-guide PR #20 (manifest: Shibboleth-SP public upstream; ADR-01 §3/§5; Codex r4 pass) and PR #21 (installer M2 stage 1; Codex r5 pass, CI 6/6), and the seven strict-reconstruction pull requests in the private `-dev2027` repositories (Codex r1 pass for five, r2 confirmation for osf.io #2 and Shibboleth-SP #1). Repository-administrator path because the author cannot approve its own pull requests | These nine pull requests only; merge, not approve; no force-push | Owner, in the session dialogue (2026-11-06) | Review records `docs/reviews/2026-11-05_RDM-developer-guide_PR20_*_r4.md`, `2026-11-06_RDM-developer-guide_PR21_Installer_r5.md`, the strict-reconstruction review records r1 and r2 (kept in the private guide) | | 2026-11-06 | **Standing delegation for milestone M2:** QAE (Claude Code Fable) merges any pull request in RDM-developer-guide or a `-dev2027` repository once REV (Codex Astra) has recorded a pass verdict in `docs/reviews/` and every CI check is green on the merged head. Each merge is still listed in this table or in the status board with its review record. Publishing (tags, releases, registry pushes) stays with the owner | Pull requests only, while M2 is in progress; revoked automatically when M2 is marked done on the status board unless renewed | Owner, in the session dialogue (2026-11-06) | This row; per-merge references in `docs/status/README.md` | | 2026-11-10 | **Extension of the M2 standing delegation:** the Claude Code session continuing this work (Opus 5.5), acting as QAE, merges under the same conditions and scope as the row above, using the repository-administrator path because the author cannot approve its own pull requests | Same as the row above; expires with it | Owner, in the session dialogue (2026-11-10) | This row; per-merge references in `docs/status/README.md` | | 2026-11-10 | **Repositories without CI:** `RDM-wiki-frontend-dev2027`, `RDM-y-websocket-dev2027` and `RDM-cas-overlay-dev2027` have no workflow, so "every CI check green" cannot be met. Their pull requests are merged on a REV pass plus the local test results recorded in the pull request body. y-websocket PR #2 was merged before this ruling, by a check that treated an empty check list as green; that is recorded here and the merge check now requires at least one check where CI exists | Same as the M2 standing delegation | Owner, in the session dialogue (2026-11-10) | Review records `docs/reviews/2026-11-10_RDM-y-websocket-dev2027_*`, `*_RDM-wiki-frontend-dev2027_*`, `*_RDM-cas-overlay-dev2027_*` | @@ -220,7 +221,7 @@ flowchart LR | 日付 | 例外 | 範囲 | 許可者 | 証跡 | |---|---|---|---|---| | 2026-11-05 | QAE(Claude Code Fable)が RDM-developer-guide 自身の PR #19 をマージする。作者は自分の PR を承認できないため、ブランチ保護の管理者経路を使う | この PR 1 件のみ。承認ではなくマージ。他リポジトリには及ばない | 所有者(セッション内の対話) | REV r3 記録 `docs/reviews/2026-11-05_RDM-developer-guide_M1_Skeleton_PR_r3.md`(approve 推奨)、マージ対象 head で CI 6/6 合格 | -| 2026-11-06 | QAE(Claude Code Fable)が、セッション内で所有者が明示した委任により次をマージする: RDM-developer-guide PR #20(manifest: Shibboleth-SP の公開上流、ADR-01 §3/§5。Codex r4 合格)と PR #21(インストーラー M2 第 1 段。Codex r5 合格、CI 6/6)、および非公開 `-dev2027` リポジトリの厳密再構築 PR 7 本(Codex r1 で 5 本合格、osf.io #2 と Shibboleth-SP #1 は r2 で対応確認)。作者は自分の PR を承認できないためリポジトリ管理者の経路を使う | この 9 件の PR のみ。承認ではなくマージ。force push なし | 所有者(セッション内の対話、2026-11-06) | レビュー記録 `docs/reviews/2026-11-05_RDM-developer-guide_PR20_*_r4.md`、`2026-11-06_RDM-developer-guide_PR21_Installer_r5.md`、`2026-11-05_dev2027_Strict_Reconstruction_PRs_r1.md`/`_r2.md` | +| 2026-11-06 | QAE(Claude Code Fable)が、セッション内で所有者が明示した委任により次をマージする: RDM-developer-guide PR #20(manifest: Shibboleth-SP の公開上流、ADR-01 §3/§5。Codex r4 合格)と PR #21(インストーラー M2 第 1 段。Codex r5 合格、CI 6/6)、および非公開 `-dev2027` リポジトリの厳密再構築 PR 7 本(Codex r1 で 5 本合格、osf.io #2 と Shibboleth-SP #1 は r2 で対応確認)。作者は自分の PR を承認できないためリポジトリ管理者の経路を使う | この 9 件の PR のみ。承認ではなくマージ。force push なし | 所有者(セッション内の対話、2026-11-06) | レビュー記録 `docs/reviews/2026-11-05_RDM-developer-guide_PR20_*_r4.md`、`2026-11-06_RDM-developer-guide_PR21_Installer_r5.md`、厳密再構築のレビュー記録 r1・r2(非公開のガイドに保管) | | 2026-11-06 | **節目 M2 の間の常設委任:** REV(Codex Astra)が `docs/reviews/` に合格の判定を記録し、マージ対象の head で CI がすべて緑の PR は、RDM-developer-guide と `-dev2027` のいずれでも QAE(Claude Code Fable)がマージする。各マージはこの表か進捗ボードにレビュー記録とともに残す。公開(タグ・リリース・レジストリへの push)は引き続き所有者が行う | PR のみ。M2 進行中に限る。進捗ボードで M2 が完了になった時点で、更新がなければ自動的に失効 | 所有者(セッション内の対話、2026-11-06) | この行と、`docs/status/README.md` のマージごとの参照 | | 2026-11-10 | **節目 M2 の常設委任の拡張:** この作業を継続する Claude Code セッション(Opus 5.5)が QAE として、上の行と同じ条件と範囲でマージする。作者は自分の PR を承認できないためリポジトリ管理者の経路を使う | 上の行と同じ。同時に失効する | 所有者(セッション内の対話、2026-11-10) | この行と、`docs/status/README.md` のマージごとの参照 | | 2026-11-10 | **CI のないリポジトリ:** `RDM-wiki-frontend-dev2027`、`RDM-y-websocket-dev2027`、`RDM-cas-overlay-dev2027` にはワークフローがなく「CI がすべて緑」を満たせない。これらの PR は REV の合格と、PR 本文に記録したローカル試験の結果を条件にマージする。y-websocket PR #2 はこの判断の前に、空の結果を緑とみなす確認でマージした。その事実をここに記録し、CI のあるリポジトリでは結果が 1 件以上あることをマージの条件に加えた | M2 の常設委任と同じ | 所有者(セッション内の対話、2026-11-10) | レビュー記録 `docs/reviews/2026-11-10_RDM-y-websocket-dev2027_*`、`*_RDM-wiki-frontend-dev2027_*`、`*_RDM-cas-overlay-dev2027_*` | diff --git a/docs/reviews/2026-11-06_RDM-developer-guide_PR25_Environment_Guide_r3.md b/docs/reviews/2026-11-06_RDM-developer-guide_PR25_Environment_Guide_r3.md index e809b55c..7bd2d409 100644 --- a/docs/reviews/2026-11-06_RDM-developer-guide_PR25_Environment_Guide_r3.md +++ b/docs/reviews/2026-11-06_RDM-developer-guide_PR25_Environment_Guide_r3.md @@ -5,7 +5,8 @@ **Jump:** [English](#english) · [日本語](#japanese) -- Version / 版: 0.1 — 2026-11-06. **Learned:** correct severity thresholds alone do not describe all mandatory gate conditions, and a passing text checker does not prove first-use placement or translation parity. / 重大度のしきい値だけ正しくても必須条件を網羅できず、文書検査の成功だけでは初出位置と翻訳の対応を証明できないと分かった。 +- Version / 版: 0.2 — 2026-11-18. **Learned:** a public record names no local path: the local working path was replaced by a general description. / 公開の記録にはローカルのパスを書かない。手元の作業用のパスを一般的な説明に置き換えた。 + 0.1 — 2026-11-06. **Learned:** correct severity thresholds alone do not describe all mandatory gate conditions, and a passing text checker does not prove first-use placement or translation parity. / 重大度のしきい値だけ正しくても必須条件を網羅できず、文書検査の成功だけでは初出位置と翻訳の対応を証明できないと分かった。 - Applies to: [PR #25](https://github.com/RCOSDP/RDM-developer-guide/pull/25) (a proposed change / 変更提案), revision `8b73ff0615dbdd5c5705c534bfb89de1870cd557`; reviewer REV(担当レビュワ, Codex Astra). - Related: [Review index](README.md) · [r2 record](2026-11-06_RDM-developer-guide_PR23_PR25_r2.md) · [SPEC-03](../spec/03_security_gate.md) · [ADR-03](../decisions/ADR-03_Staged_Security_Gate.md) · [SPEC-06](../spec/06_documentation_conventions.md) · [Shared glossary](../reference/REF-01_Glossary.md). - Used by: [Environment guide](../guides/environment/README.md). @@ -27,7 +28,7 @@ ### Validation and limits -The local guide was byte-compared with the remote file at the reviewed revision using `gh api` and matched. Remote access used `gh` only. Run from `/Users/komiyama/orca/workspaces/RDM-developer-guide/docs-env-guide`: +The local guide was byte-compared with the remote file at the reviewed revision using `gh api` and matched. Remote access used `gh` only. Run from the reviewer's local working copy of the PR branch: ```sh python3 tools/docs_check.py --all-warnings diff --git a/docs/reviews/2026-11-06_RDM-developer-guide_PR25_Environment_Guide_r4.md b/docs/reviews/2026-11-06_RDM-developer-guide_PR25_Environment_Guide_r4.md index c5a7f4e5..319fb20c 100644 --- a/docs/reviews/2026-11-06_RDM-developer-guide_PR25_Environment_Guide_r4.md +++ b/docs/reviews/2026-11-06_RDM-developer-guide_PR25_Environment_Guide_r4.md @@ -5,7 +5,8 @@ **Jump:** [English](#english) · [日本語](#japanese) -- Version / 版: 0.1 — 2026-11-06. **Learned:** separating automated checks from recorded acceptance evidence makes the staged security requirements understandable without claiming that a readiness check performs attack testing. / 自動検査と記録による受入証跡を分けることで、準備確認が攻撃検証を実施するかのように説明せず、段階別の安全要件を伝えられると分かった。 +- Version / 版: 0.2 — 2026-11-18. **Learned:** a public record names no local path: the local working path was replaced by a general description. / 公開の記録にはローカルのパスを書かない。手元の作業用のパスを一般的な説明に置き換えた。 + 0.1 — 2026-11-06. **Learned:** separating automated checks from recorded acceptance evidence makes the staged security requirements understandable without claiming that a readiness check performs attack testing. / 自動検査と記録による受入証跡を分けることで、準備確認が攻撃検証を実施するかのように説明せず、段階別の安全要件を伝えられると分かった。 - Applies to: [PR #25](https://github.com/RCOSDP/RDM-developer-guide/pull/25) (a proposed change / 変更提案), revision `5bf1e59b7c55ab46268475679e5e140c35a3db9f`; reviewer REV(担当レビュワ, Codex Astra). - Related: [Review index](README.md) · [r3 record](2026-11-06_RDM-developer-guide_PR25_Environment_Guide_r3.md) · [SPEC-03](../spec/03_security_gate.md) · [ADR-03](../decisions/ADR-03_Staged_Security_Gate.md) · [SPEC-06](../spec/06_documentation_conventions.md) · [Shared glossary](../reference/REF-01_Glossary.md). - Used by: [Environment guide](../guides/environment/README.md). @@ -46,7 +47,7 @@ The added Japanese notes match English for amd64 (a CPU type) at 39 / 394, Docke ### Validation and limits -The local guide, SPEC-03, ADR-03 and `scan.py` were byte-compared against the remote files at the reviewed revision, retrieved using `gh api`; all four matched. Remote operations used `gh` only. From `/Users/komiyama/orca/workspaces/RDM-developer-guide/docs-env-guide`: +The local guide, SPEC-03, ADR-03 and `scan.py` were byte-compared against the remote files at the reviewed revision, retrieved using `gh api`; all four matched. Remote operations used `gh` only. From the reviewer's local working copy of the PR branch: ```sh python3 tools/docs_check.py --all-warnings diff --git a/docs/reviews/2026-11-11_RDM-developer-guide_PR45_Pin_Py313_r1.md b/docs/reviews/2026-11-11_RDM-developer-guide_PR45_Pin_Py313_r1.md index f6b77078..3392cad4 100644 --- a/docs/reviews/2026-11-11_RDM-developer-guide_PR45_Pin_Py313_r1.md +++ b/docs/reviews/2026-11-11_RDM-developer-guide_PR45_Pin_Py313_r1.md @@ -5,8 +5,9 @@ **Jump:** [English](#english) · [日本語](#japanese) -- Version / 版: 0.2 — 2026-11-11. **Learned:** REV changed only link destinations for publication (scratch-path evidence links replaced by repository-relative links or by plain-text references). / REV が公開用にリンク参照先のみを変更した(scratch パスの証跡リンクをリポジトリ相対リンクまたは平文参照に変更)。 -- Publication provenance / 公開版の来歴: REV(担当レビュワ)issued this publication version from the unchanged original `/private/tmp/claude-501/-Users-komiyama-ai-development-GitHub-RDM-developer-guide/8baac84b-080f-4104-a2b5-7416702c57e1/scratchpad/reviews/2026-11-11_RDM-developer-guide_PR45_Pin_Py313_r1.md` (SHA-256: `7fc95a749e802996d83147b4c6b66c1403eff0ea4571d41287a7ad571e5e2a13`); the original file and scratch evidence remain unchanged, and all text other than this version/provenance metadata and the explicitly stated publication references is verbatim. For r2, its existing repository-relative links already resolve and require no changes. / REV が上記原本から公開版を発行した。原本と scratch 証跡は未変更で、版・来歴の追記と明示した公開用参照以外の本文は原文どおり。r2 の既存のリポジトリ相対リンクは有効で変更不要。 +- Version / 版: 0.3 — 2026-11-18. **Learned:** a public record names no local path: the local working path was replaced by a general description. / 公開の記録にはローカルのパスを書かない。手元の作業用のパスを一般的な説明に置き換えた。 + 0.2 — 2026-11-11. **Learned:** REV changed only link destinations for publication (scratch-path evidence links replaced by repository-relative links or by plain-text references). / REV が公開用にリンク参照先のみを変更した(scratch パスの証跡リンクをリポジトリ相対リンクまたは平文参照に変更)。 +- Publication provenance / 公開版の来歴: REV(担当レビュワ)issued this publication version from the unchanged original (a scratch file of the REV session, not kept in this repository) (SHA-256: `7fc95a749e802996d83147b4c6b66c1403eff0ea4571d41287a7ad571e5e2a13`); the original file and scratch evidence remain unchanged, and all text other than this version/provenance metadata and the explicitly stated publication references is verbatim. For r2, its existing repository-relative links already resolve and require no changes. / REV が上記原本から公開版を発行した。原本と scratch 証跡は未変更で、版・来歴の追記と明示した公開用参照以外の本文は原文どおり。r2 の既存のリポジトリ相対リンクは有効で変更不要。 - Version / 版: 0.1 — 2026-11-11. **Learned:** a no-fix snapshot does not make an exception safe for future scans unless package identity and fix availability remain part of matching. / 現時点で修正版が無いことだけでは将来の検査も安全にならず、パッケージの同一性と修正版の有無を照合に残す必要がある。 - Applies to: RCOSDP/RDM-developer-guide PR #45, head `3c5dd0c31944b9b3450ff34eb0808ad1e26f8728`, base `eb8c4e96977b06bd3bb0fd42b03f0872806be08a`. - Reviewer: REV(担当レビュワ, Codex Astra). diff --git a/docs/reviews/2026-11-11_RDM-developer-guide_PR45_Pin_Py313_r2.md b/docs/reviews/2026-11-11_RDM-developer-guide_PR45_Pin_Py313_r2.md index 409eaa2c..3cc61c29 100644 --- a/docs/reviews/2026-11-11_RDM-developer-guide_PR45_Pin_Py313_r2.md +++ b/docs/reviews/2026-11-11_RDM-developer-guide_PR45_Pin_Py313_r2.md @@ -5,8 +5,9 @@ **Jump:** [English](#english) · [日本語](#japanese) -- Version / 版: 0.2 — 2026-11-11. **Learned:** REV changed only link destinations for publication (scratch-path evidence links replaced by repository-relative links or by plain-text references). / REV が公開用にリンク参照先のみを変更した(scratch パスの証跡リンクをリポジトリ相対リンクまたは平文参照に変更)。 -- Publication provenance / 公開版の来歴: REV(担当レビュワ)issued this publication version from the unchanged original `/private/tmp/claude-501/-Users-komiyama-ai-development-GitHub-RDM-developer-guide/8baac84b-080f-4104-a2b5-7416702c57e1/scratchpad/reviews/2026-11-11_RDM-developer-guide_PR45_Pin_Py313_r2.md` (SHA-256: `a8bb94067af6b27028cbb7d111c5bd30fae9385dc9c1ca2d4681951fec11030f`); the original file and scratch evidence remain unchanged, and all text other than this version/provenance metadata and the explicitly stated publication references is verbatim. For r2, its existing repository-relative links already resolve and require no changes. / REV が上記原本から公開版を発行した。原本と scratch 証跡は未変更で、版・来歴の追記と明示した公開用参照以外の本文は原文どおり。r2 の既存のリポジトリ相対リンクは有効で変更不要。 +- Version / 版: 0.3 — 2026-11-18. **Learned:** a public record names no local path: the local working path was replaced by a general description. / 公開の記録にはローカルのパスを書かない。手元の作業用のパスを一般的な説明に置き換えた。 + 0.2 — 2026-11-11. **Learned:** REV changed only link destinations for publication (scratch-path evidence links replaced by repository-relative links or by plain-text references). / REV が公開用にリンク参照先のみを変更した(scratch パスの証跡リンクをリポジトリ相対リンクまたは平文参照に変更)。 +- Publication provenance / 公開版の来歴: REV(担当レビュワ)issued this publication version from the unchanged original (a scratch file of the REV session, not kept in this repository) (SHA-256: `a8bb94067af6b27028cbb7d111c5bd30fae9385dc9c1ca2d4681951fec11030f`); the original file and scratch evidence remain unchanged, and all text other than this version/provenance metadata and the explicitly stated publication references is verbatim. For r2, its existing repository-relative links already resolve and require no changes. / REV が上記原本から公開版を発行した。原本と scratch 証跡は未変更で、版・来歴の追記と明示した公開用参照以外の本文は原文どおり。r2 の既存のリポジトリ相対リンクは有効で変更不要。 - Version / 版: 0.1 — 2026-11-11. **Learned:** passing a link checker does not establish that a review record is verbatim; publication corrections require the reviewer's explicit provenance, even when the verdict is unchanged. / リンク検査の合格はレビュー記録が原文どおりであることを証明しない。判定が同じでも、公開用の訂正にはレビュワによる明示的な来歴が必要である。 - Applies to: RCOSDP/RDM-developer-guide [PR #45](https://github.com/RCOSDP/RDM-developer-guide/pull/45), head `339f4fa1e7415b82aaee61d090e3620c49047000`; delta after `3c5dd0c31944b9b3450ff34eb0808ad1e26f8728`. - Reviewer: REV(担当レビュワ, Codex Astra). diff --git a/docs/reviews/2026-11-12_RDM-developer-guide_PR48_Missing_Records_r1.md b/docs/reviews/2026-11-12_RDM-developer-guide_PR48_Missing_Records_r1.md index da30ceee..6e673ea4 100644 --- a/docs/reviews/2026-11-12_RDM-developer-guide_PR48_Missing_Records_r1.md +++ b/docs/reviews/2026-11-12_RDM-developer-guide_PR48_Missing_Records_r1.md @@ -5,8 +5,9 @@ **Jump:** [English](#english) · [日本語](#japanese) -- Version / 版: 0.2 — 2026-11-12. **Learned:** REV changed only link destinations for publication, replacing scratch-path links with repository-relative links; the original review text and verdict are preserved verbatim. / REV(担当レビュワ)は公開用にリンク先だけを scratch パスからリポジトリ相対パスへ変更し、元のレビュー本文と判定は逐語的に保持した。 -- Provenance / 出典: Original review file / 元のレビュー記録: `/private/tmp/claude-501/-Users-komiyama-ai-development-GitHub-RDM-developer-guide/8baac84b-080f-4104-a2b5-7416702c57e1/scratchpad/reviews/2026-11-12_RDM-developer-guide_PR48_Missing_Records_r1.md`. +- Version / 版: 0.3 — 2026-11-18. **Learned:** a public record names no local path: the scratch path of the source was replaced by a general description, and the table of the nine records of a private repository was replaced by a note, because it is kept in the private guide. / 公開の記録にはローカルのパスを書かない。出典の作業用のパスを一般的な説明にした。非公開のリポジトリの 9 件の記録の表は、非公開のガイドに保管しているので注記に置き換えた。 + 0.2 — 2026-11-12. **Learned:** REV changed only link destinations for publication, replacing scratch-path links with repository-relative links; the original review text and verdict are preserved verbatim. / REV(担当レビュワ)は公開用にリンク先だけを scratch パスからリポジトリ相対パスへ変更し、元のレビュー本文と判定は逐語的に保持した。 +- Provenance / 出典: Original review file / 元のレビュー記録: a scratch file of the REV session, not kept in this repository / REV のセッションの作業用のファイル(このリポジトリには置かない). - Version / 版: 0.1 — 2026-11-12. **Learned:** passing automated documentation checks does not prove compliance with the data-format rule, which requires manual review. / 文書の自動検査に合格しても、データ形式の規則への適合は証明されず、人による確認が必要と分かった。 - Applies to: [RDM-developer-guide PR #48](https://github.com/RCOSDP/RDM-developer-guide/pull/48), head `01709926bcba997fb8eb1ccb502bfdcaf670f872`, base `f4199fb3c6cc49fd93816c4896d8a56380cf57d8`. - Related: [Review index](README.md) · [SPEC-06](../spec/06_documentation_conventions.md) · [ADR-04](../decisions/ADR-04_AI_Autonomy_and_Roles.md). @@ -31,18 +32,7 @@ A fresh clone under `scratchpad/pr48-rev-r1` was clean before and after review. Read-only `gh api` requests retrieved the comments from each PR and by comment ID. Every ID belongs to the stated PR in RDM-osf.io-dev2027, every body starts with `REV(担当レビュワ`, and every round, verdict, reviewed head and UTC minute matches. PR #11 r3 uses capitalized “Pass” and names the head as the endpoint of its reviewed range. PR #8 r3 and #11 r3 are limited passes, not whole-PR approvals; the table preserves those limitations. Exact UTC posting times are recorded here: -```toon -records[9]{pr,round,comment_id,created_at_utc,verdict,reviewed_head}: - 8,r1,6757009993,2026-11-10T02:12:35Z,changes requested,e7f23e13141f - 8,r2,6758141691,2026-11-10T03:28:56Z,changes requested,8bb07f17c2 - 8,r3,6759472716,2026-11-10T05:03:01Z,pass (R2 changes only),49e5521451 - 10,r1,6759171742,2026-11-10T04:41:17Z,changes requested,5355858363b6 - 11,r1,6759274738,2026-11-10T04:48:29Z,changes requested,75ceaf5cb492 - 11,r2,6760403905,2026-11-10T06:08:17Z,changes requested,58ba83af4b7c - 11,r3,6763524193,2026-11-10T09:13:37Z,pass (58ba83a..3eb4042 only),3eb4042 - 12,r1,6763575801,2026-11-10T09:16:17Z,changes requested,aa30a37d - 13,r1,6763600948,2026-11-10T09:17:37Z,changes requested,ef9e64261b -``` +(The table of the nine records — comment IDs, posting times, verdicts and reviewed heads in the private repository — is kept in the private guide. The text above and below, which refers to this table, is unchanged.) The English and Japanese inventories contain identical values, and the surrounding prose has the same meaning. The English verdict cells still use Japanese explanatory labels; translate them during R1-01. No private repository URL appears in the README. Anchors, Jump links, relative links and version structure pass inspection. The explanation that records were lost and the owner's 2026-11-12 decision are task-supplied history; the surviving comments cannot independently prove that history. @@ -79,18 +69,7 @@ No source files were edited. This record is uncommitted. No merge, approval, clo 読み取り専用の `gh api` で PR ごとのコメント一覧とコメント ID ごとの内容を取得した。全 ID は RDM-osf.io-dev2027 の指定 PR に属し、本文はすべて `REV(担当レビュワ` で始まる。回、判定、対象の先頭、UTC の分まで一致した。PR #11 r3 は大文字始まりの “Pass” で、対象の先頭はレビュー範囲の終点として記載されている。PR #8 r3 と #11 r3 は差分限定の合格で、PR 全体の承認ではない。表もこの限定を保持している。正確な UTC 投稿日時は次のとおり。 -```toon -records[9]{pr,round,comment_id,created_at_utc,verdict,reviewed_head}: - 8,r1,6757009993,2026-11-10T02:12:35Z,changes requested,e7f23e13141f - 8,r2,6758141691,2026-11-10T03:28:56Z,changes requested,8bb07f17c2 - 8,r3,6759472716,2026-11-10T05:03:01Z,pass (R2 changes only),49e5521451 - 10,r1,6759171742,2026-11-10T04:41:17Z,changes requested,5355858363b6 - 11,r1,6759274738,2026-11-10T04:48:29Z,changes requested,75ceaf5cb492 - 11,r2,6760403905,2026-11-10T06:08:17Z,changes requested,58ba83af4b7c - 11,r3,6763524193,2026-11-10T09:13:37Z,pass (58ba83a..3eb4042 only),3eb4042 - 12,r1,6763575801,2026-11-10T09:16:17Z,changes requested,aa30a37d - 13,r1,6763600948,2026-11-10T09:17:37Z,changes requested,ef9e64261b -``` +(9 件の記録の表 — 非公開のリポジトリのコメント ID、投稿日時、判定、対象の先頭 — は、非公開のガイドに保管している。この表を指す前後の本文は変えていない。) 英日一覧の値は同一で、周囲の説明も同じ意味だった。英語側の判定欄には日本語の説明が残るため、R1-01 の修正時に英訳する。README に非公開リポジトリの URL はない。アンカー、Jump、相対リンク、版構成を確認した。記録喪失の経緯と所有者の 2026-11-12 の決定は依頼で与えられた履歴であり、現存するコメントだけでは独立に証明できない。 diff --git a/docs/reviews/2026-11-12_RDM-developer-guide_PR48_Missing_Records_r2.md b/docs/reviews/2026-11-12_RDM-developer-guide_PR48_Missing_Records_r2.md index f1302c4c..d4429295 100644 --- a/docs/reviews/2026-11-12_RDM-developer-guide_PR48_Missing_Records_r2.md +++ b/docs/reviews/2026-11-12_RDM-developer-guide_PR48_Missing_Records_r2.md @@ -5,8 +5,9 @@ **Jump:** [English](#english) · [日本語](#japanese) -- Version / 版: 0.2 — 2026-11-12. **Learned:** REV changed only link destinations for publication, replacing scratch-path links with repository-relative links; the original review text and verdict are preserved verbatim. / REV(担当レビュワ)は公開用にリンク先だけを scratch パスからリポジトリ相対パスへ変更し、元のレビュー本文と判定は逐語的に保持した。 -- Provenance / 出典: Original review file / 元のレビュー記録: `/private/tmp/claude-501/-Users-komiyama-ai-development-GitHub-RDM-developer-guide/8baac84b-080f-4104-a2b5-7416702c57e1/scratchpad/reviews/2026-11-12_RDM-developer-guide_PR48_Missing_Records_r2.md`. +- Version / 版: 0.3 — 2026-11-18. **Learned:** a public record names no local path: the scratch path of the source was replaced by a general description. / 公開の記録にはローカルのパスを書かない。出典の作業用のパスを一般的な説明にした。 + 0.2 — 2026-11-12. **Learned:** REV changed only link destinations for publication, replacing scratch-path links with repository-relative links; the original review text and verdict are preserved verbatim. / REV(担当レビュワ)は公開用にリンク先だけを scratch パスからリポジトリ相対パスへ変更し、元のレビュー本文と判定は逐語的に保持した。 +- Provenance / 出典: Original review file / 元のレビュー記録: a scratch file of the REV session, not kept in this repository / REV のセッションの作業用のファイル(このリポジトリには置かない). - Version / 版: 0.1 — 2026-11-12. **Learned:** changing the data format must preserve the scope of limited passes as well as identifiers and dates; parsing and source-comment checks confirm both. / データ形式の変更では ID や日時だけでなく、限定付き合格の対象範囲も保つ必要があり、構文の解析と元コメントの照合で両方を確認できると分かった。 - Applies to: [RDM-developer-guide PR #48](https://github.com/RCOSDP/RDM-developer-guide/pull/48), head `730e4858d831eba823b96b663e1b85845159f868`, base `f4199fb3c6cc49fd93816c4896d8a56380cf57d8`. - Related: [Review index](README.md) · [SPEC-06](../spec/06_documentation_conventions.md) · [r1](2026-11-12_RDM-developer-guide_PR48_Missing_Records_r1.md).