Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
7 changes: 4 additions & 3 deletions docs/decisions/ADR-04_AI_Autonomy_and_Roles.md
Original file line number Diff line number Diff line change
Expand Up @@ -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 ごとの委任確認が一日に何度も所有者を止める。条件と期限を明示した常設委任なら、人の規則を保ちつつ待ちをなくせる。
Expand Down Expand Up @@ -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_*` |
Expand Down Expand Up @@ -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_*` |
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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 は非公開のガイドに保管しているので、リンクを外して文字だけにした。
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担当)と所有者の検証・採否判断。

---
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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).
Expand All @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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).
Expand Down Expand Up @@ -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
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -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 のレビューは非公開のガイドに保管しているので、リンクを外して文字だけにした。
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).

---
Expand Down
Loading
Loading