# 研修申込みの基本設計書：検証記録

この記録は、新しいサブエージェントがコピー済みの更新スキルを読み、入力の架空の研修申込みを実際に執筆・生成・検査した結果である。古い公開成果物や別実行の出力は読まず、同梱の構造例だけを参照した。スキル本体とコピー内のスキルは編集していない。

## 実行環境と到達点

- 作業場所：`<実行プロジェクト>`
- スキル：`.agents/skills/write-basic-design-document/` 全体
- 入力：`input.md`。対象プロジェクト内のAGENTS.mdは検索結果0件。
- PythonとNode.jsの既存環境を使用。doctorでmermaid-cli 11.16.0を検出。新規導入と外部描画サービスの利用なし。
- 原本の設計6件、要望5件、根拠の引用6件、未決事項7件を新規執筆。
- JSON・Markdown・HTML・manifestを各1件、Mermaid原本とPNGを各6件生成した。原本作成用の補助スクリプトを保存していない。
- 初回buildは制限環境で既存ブラウザーの起動に失敗した。失敗ログを残し、環境の承認手順で同じローカルbuildを再実行して成功した。描画後に長いラベルを短くし、処理図の対象を初回申込みと明記して再build・checkした。
- 主要コマンドの実際のargv・stdout・stderr・終了コードは[実コマンドの検証記録](validation.json) に保存した。成功だけでなく初回の描画失敗も含む。

## 入力・本文・図の意味の照合

[入力の2行目](input.md)には次の記述がある。

> 同じ社員の二重申込みと、定員を超える申込みは確定させません。

この条件に対し、判定と保存を研修単位の一つの処理にする案を採り、その理由を画面の空き表示だけでは同時申込みを防げないためと記した。これは設計案であり、採用承認や動作保証を意味しない。

[同じ入力の2行目](input.md)には次の記述もある。

> 使う技術、取消期限、取消後の空き枠を待つ仕組みの要否は未定です。

これらは未決の質問と影響範囲に結び付けた。外部連携は入力の指定に従って不採用とし、その観点の設計と外部連携のシーケンス図を置いていない。社員本人と担当者を確認する方式も、外部連携なしの条件と整合するかを未決としている。

| 図 | 意味の照合 | 最終PNG寸法 | 目視結果 |
| --- | --- | --- | --- |
| 利用者と対象システムの境界 | 社員から申込み・本人の取消、社員への自分の結果、研修担当者から研修登録の方向を本文と照合。外部システムは描いていない。 | 1214×414 | 全文字を読める。欠け・つぶれ・矢印先の取り違え・線の交差による読み違いを認めない。 |
| 登録と受付と照会の責務 | 申込み受付・本人結果照会・研修管理が保存先を使う静的な分担を本文と照合。実装製品や配備先は描いていない。 | 1952×556 | 全文字を読める。欠け・つぶれ・矢印先の取り違え・線の交差による読み違いを認めない。 |
| 申込みの確定と拒否の順序 | 初回申込みについて二重判定→定員判定→保存→確定結果の順を照合。二重・満員・保存失敗で確定しない。研修単位の一つの処理とする理由、再申込み条件が未決である適用範囲を本文に明記。 | 1728×2036 | 全文字を読める。欠け・つぶれ・矢印先の取り違え・線の交差による読み違いを認めない。 |
| 申込みと登録の画面遷移 | 社員の一覧→詳細→申込み結果→自分の一覧、一覧→取消結果→一覧を照合。研修担当者の入力→登録結果と分離。取消期限は未決のラベルで示す。 | 770×2018 | 全文字を読める。欠け・つぶれ・矢印先の取り違え・線の交差による読み違いを認めない。 |
| 社員と研修と申込みの論理関係 | 社員一人・研修一つにそれぞれゼロ件以上の申込みが属する関係を照合。確定・取消済みの状態と確定分だけを定員に数える案を本文と一致させた。 | 1204×884 | 全文字を読める。欠け・つぶれ・矢印先の取り違え・線の交差による読み違いを認めない。 |
| 確定した申込みと取消の状態 | 判定と保存完了で確定、本人の取消を受け付けたとき取消済みへ移る方向を照合。期限条件、空き枠待ち、再申込みを未決として表示。 | 648×844 | 全文字を読める。欠け・つぶれ・矢印先の取り違え・線の交差による読み違いを認めない。 |

全PNGを `view_image` の原寸表示で開き、文字の欠け・つぶれと矢印の方向・到達先を確認した。ラベルと配置の修正後には6図を再度開いた。最後に変更した処理図も最終build後に再度開いた。他の5図の画像はそのbuildで変更していない。

## 文書の読み方と引継ぎの確認

- 9章の順序、目次、番号付き章・節、用語表・利用者表を確認した。図は導入→PNG→拡大・定義リンク→要点→関連設計・根拠の順になっている。
- 設計と図の参照を双方向に持たせ、要望から設計と採用理由へたどれる。入力の6抜粋はすべてinput.mdの原文の部分文字列であることも確認した。
- 取消後の再申込みを未決のまま受付可能と読めないよう、受付設計と処理図を初回申込みの案として限定し、再申込み条件の質問へつないだ。
- 物理列・型・制約・検索のための索引、同時更新の制御、詳細な画面項目、運用の具体化は詳細設計への引継ぎに分けた。同じ作業の重複を確認してまとめた。
- 独自の英字略語や入力にない版・更新日時・承認は追加していない。提案を承認済みとして扱っていない。

## 残った未決事項

1. 利用技術と実行場所：製品・配置・判定と保存の実装方式。
2. 取消期限：取消画面の可否と受付の期限条件。
3. 空き枠待ちの要否：空き枠の配分、追加画面・状態・データ。
4. 利用者と権限の確認方式：本人限定操作と社員情報の保持方法。
5. 利用量と運用条件：品質目標、容量、監視・保管・復旧と操作支援の基準。
6. 取消後の再申込み：再申込みの可否、受付条件、取消履歴との関係。
7. 同時申込みの優先順：残り一枠などの競合時の選択順。

## 実施していない検証と操作

- HTMLをブラウザーで開いた表示・操作検査は未実施。Mermaidの描画用ブラウザー起動と、納品HTMLの表示検査は区別している。
- 対象となる研修申込みアプリは実装していないため、二重申込み・定員超過・本人権限などの動作試験は未実施。
- 採用承認、外部投稿、インストール、コミット、pushは実施していない。

## スキル終了処理

終了処理も実行して結果を確認した。

- `run.py finish`：終了コード 0。指摘0件で完了。

## 公開保存時の確認

- 同じ正本全52ファイルについて、実行前後の正本・実行用コピーの一覧とSHA-256の一致を確認した。
- GFMのパーサでMarkdownを読み、本文154項目、6画像、238リンク、9章、3表を確認した。本文の欠落・リンク切れは0件。
- 公開用コピーで原本とMarkdown・HTML・PNG・manifestの同期検査を再実行し、終了コード0だった。
- ZIPのCRCと出力16ファイルのパス・内容の一致を検査した。Markdownはdiagrams/を含む一式で共有する。
- 公開記録では一時作業の経路と環境情報を省略し、出典のリンクを同梱input.mdへ合わせた。生成したout内のファイルは書き換えていない。
