@infodb/p3 0.11.0 → 0.12.0
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +4 -1
- package/dist/web/assets/ImprovementDialog-kQaVBGWH.js +1 -0
- package/dist/web/assets/Outputs-_nU_p3nu.js +1 -0
- package/dist/web/assets/{RequestStatus-Bg1OLbRc.js → RequestStatus-RG-OVQYY.js} +1 -1
- package/dist/web/assets/{Tabs-DTmggzgg.js → Tabs-ew9i5SKX.js} +1 -1
- package/dist/web/assets/TagInput-BtlJTF7i.js +1 -0
- package/dist/web/assets/TaskDrawer-DW8GyJqI.js +6 -0
- package/dist/web/assets/_requestId-6Nb727dD.js +1 -0
- package/dist/web/assets/_requestId-BykTgPax.js +1 -0
- package/dist/web/assets/appCtx-CxDdXABS.js +1 -0
- package/dist/web/assets/archive-Ckh295Xe.js +1 -0
- package/dist/web/assets/board-BVAIjK-Y.js +1 -0
- package/dist/web/assets/done-BGfA-3MA.js +1 -0
- package/dist/web/assets/index-CgRU744I.css +2 -0
- package/dist/web/assets/index-DacQ0yl4.js +12 -0
- package/dist/web/assets/{new-9TKiNT4O.js → new-DVygWvVc.js} +1 -1
- package/dist/web/assets/outputs-B6xDsLZf.js +1 -0
- package/dist/web/assets/preload-helper-DyCqp21K.js +1 -0
- package/dist/web/assets/quality-Pu6EISAM.js +1 -0
- package/dist/web/assets/release-notes-CCpzyiNf.js +5 -0
- package/dist/web/assets/requestData-D5vBnuMh.js +1 -0
- package/dist/web/assets/routes-Q91zvNc0.js +4 -0
- package/dist/web/assets/settings-BzRgcmUm.js +1 -0
- package/dist/web/assets/taskReview-_WCgnQit.js +1 -0
- package/dist/web/assets/workTarget-C9c57JAO.js +30 -0
- package/dist/web/index.html +4 -4
- package/docs/architecture.md +315 -2
- package/docs/development.md +1 -1
- package/docs/how-to-use.md +184 -0
- package/docs/installation.md +5 -5
- package/lib/cli/args.js +45 -0
- package/lib/cli/help.js +36 -1
- package/lib/cli/main.js +27 -3
- package/lib/cli/output.js +9 -1
- package/lib/cli/preflightCommands.js +7 -1
- package/lib/cli/project.js +3 -0
- package/lib/cli/qualityCommands.js +163 -0
- package/lib/cli/readOnly.js +2 -0
- package/lib/cli/requestCommands.js +12 -0
- package/lib/cli/showView.js +69 -3
- package/lib/cli/taskCommands.js +312 -17
- package/lib/cli/taskReviewCommands.js +178 -0
- package/lib/core/context.js +4 -1
- package/lib/core/milestoneReview/material.js +11 -1
- package/lib/core/milestoneReview/mockReviewer.js +1 -0
- package/lib/core/milestoneReview/review.js +70 -6
- package/lib/core/milestoneReview/service.js +29 -93
- package/lib/core/milestoneReview/store.js +12 -62
- package/lib/core/ops.js +9 -2
- package/lib/core/preflight/carryover.js +1 -1
- package/lib/core/preflight/engine.js +6 -0
- package/lib/core/preflight/instructions.js +18 -1
- package/lib/core/preflight/mockEngine.js +4 -0
- package/lib/core/preflight/service.js +45 -4
- package/lib/core/projectRegistry.js +3 -3
- package/lib/core/quality.js +21 -0
- package/lib/core/qualityImprovement.js +221 -0
- package/lib/core/requestOps.js +97 -6
- package/lib/core/reviewRuns.js +205 -0
- package/lib/core/store/archivedTasks.js +74 -0
- package/lib/core/store/collection.js +12 -2
- package/lib/core/store/normalize.js +16 -1
- package/lib/core/store/preflightStore.js +9 -1
- package/lib/core/store/projectFile.js +10 -0
- package/lib/core/store/workspace.js +33 -3
- package/lib/core/taskReview/material.js +452 -0
- package/lib/core/taskReview/mockReviewer.js +30 -0
- package/lib/core/taskReview/paths.js +15 -0
- package/lib/core/taskReview/review.js +305 -0
- package/lib/core/taskReview/service.js +187 -0
- package/lib/core/taskReview/store.js +214 -0
- package/lib/server/api/manifest.js +55 -4
- package/lib/server/api/milestoneReviewRoutes.js +4 -3
- package/lib/server/api/routes.js +145 -17
- package/lib/server/api/taskReviewRoutes.js +66 -0
- package/lib/server/server.js +2 -2
- package/lib/shared/acceptance.js +378 -0
- package/lib/shared/milestoneReview.js +2 -1
- package/lib/shared/quality.js +391 -0
- package/lib/shared/qualityImprovement.js +1 -0
- package/lib/shared/qualityTemplates.js +31 -0
- package/lib/shared/taskBlock.js +142 -0
- package/lib/shared/taskReview.js +56 -0
- package/package.json +1 -1
- package/skills/p3/SKILL.md +31 -2
- package/dist/web/assets/Outputs-ddwte0jj.js +0 -1
- package/dist/web/assets/TagInput-BHAgjLP7.js +0 -1
- package/dist/web/assets/TaskDrawer-Dz_5c2NH.js +0 -3
- package/dist/web/assets/_requestId-D9-gtIcG.js +0 -1
- package/dist/web/assets/_requestId-DzCNYvqf.js +0 -30
- package/dist/web/assets/appCtx-Cm24VpAf.js +0 -1
- package/dist/web/assets/board-MCHcZ-PU.js +0 -1
- package/dist/web/assets/done-zq10Bt08.js +0 -1
- package/dist/web/assets/index-Ce0ndpne.js +0 -12
- package/dist/web/assets/index-D68mkSnw.css +0 -2
- package/dist/web/assets/preload-helper-FBLw7u7x.js +0 -1
- package/dist/web/assets/release-notes-hK5XezLW.js +0 -5
- package/dist/web/assets/requestData-BnN7mctX.js +0 -1
- package/dist/web/assets/routes-usHwrrA0.js +0 -3
- package/dist/web/assets/settings-BVZDnL6O.js +0 -1
- package/dist/web/assets/workTarget-Cijqq4yH.js +0 -1
package/docs/architecture.md
CHANGED
|
@@ -701,6 +701,49 @@ run でない応答は捨てる。要望が消えた・読めないときは要
|
|
|
701
701
|
REST API はブラウザのためのローカル API として残すが、AI には CLI を使わせる。
|
|
702
702
|
CLI がファイルを直接触る形なら、API ごとに認証を持たせる問題はそもそも起きない。
|
|
703
703
|
|
|
704
|
+
## 開発の工程と P3 の受け持ち
|
|
705
|
+
|
|
706
|
+
AI エージェントと進める開発を、要望を受ける → 何を作るか決める・計画する → 作る → 確かめる → 出す → 振り返って次に活かす、
|
|
707
|
+
という工程に分けたときに、P3 がどこを受け持ち、どこを受け持たないか。工程は行き来する(確かめて作り直す・振り返って要望を足す)
|
|
708
|
+
もので、要望・タスクの状態とは一対一に対応しない。操作の手順は [使い方ガイド](how-to-use.md) の各節に書き、ここでは繰り返さない。
|
|
709
|
+
|
|
710
|
+
担当の言葉:
|
|
711
|
+
|
|
712
|
+
- **人**: 利用者(チームのメンバー)
|
|
713
|
+
- **手元の AI エージェント**: 利用者が選んで自分のマシンで動かすエージェント(Claude Code・Codex CLI など)。人と同じ P3 の CLI を使う
|
|
714
|
+
- **P3 から呼ぶ Codex**: 操作する人のマシンで、その人の ChatGPT の接続を使って P3 が起動する Codex([Codex の使い方](#codex-の使い方))
|
|
715
|
+
|
|
716
|
+
残るファイルはデータのフォルダからのパスで書く(`<要望>` は `requests/<要望ID>/`)。コード・コミット・PR・公開物は P3 のデータの外にある。
|
|
717
|
+
|
|
718
|
+
| 工程 | P3 の機能・支援 | 担当 | 残るファイル |
|
|
719
|
+
| --- | --- | --- | --- |
|
|
720
|
+
| 要望を受ける | 要望の登録(本文・タグ・期限・マイルストーン)、添付(PNG / JPEG / xlsx)、大きい要望の親子([大きい要望の分割](#大きい要望の分割親と子の要望)) | 人・手元の AI エージェントが CLI か画面で登録する | `<要望>/request.md`、`<要望>/attachments/A-.../` |
|
|
721
|
+
| 何を作るか決める・計画する | Preflight(評価対象を固定し、判定・確認事項・タスク案か子の案・画面資料を出す)、メモで答えて再評価、案の採用(タスク化)でタスクと依存を作る | 評価と案は P3 から呼ぶ Codex。担当が `agent` なら、頼まれた手元の AI エージェントが手元で評価する([使い方ガイド](how-to-use.md#手元の対話エージェントで-preflight-する))。案を採用するのは人だけ | `<要望>/preflight/<run>/`(固定した評価対象・評価・案・画面資料・ログ)、`<要望>/notes/`、採用したタスクは `<要望>/tasks/Txxx.md`。マイルストーンの目的・予定機能と品質基準は `project.yaml` |
|
|
722
|
+
| 作る | タスクの本文・受け入れ基準・作業先とブランチを示し、着手・完了・成果物・変更の記録・止まっている理由を受け取る | 手元の AI エージェントか人。P3 は作業を実行しない | `<要望>/tasks/Txxx.md`(状態・成果物・変更の記録・停止の履歴)。コード・テスト・コミット・PR は作業先のリポジトリとそのリモート |
|
|
723
|
+
| 確かめる | 受け入れ基準ごとの証拠(作業した側の申告)、タスクの AI レビュー(固定した差分と資料を読んで、基準・品質基準を満たしているかを出す参考の記録。テストは動かさず、承認もしない)、人の「済み」 | テスト・動作確認と証拠は作業した側(手元の AI エージェントか人)。レビューは P3 から呼ぶ Codex(作業したのとは別のスレッド)。済みは人だけ | 証拠は `<要望>/tasks/Txxx.md`、レビューは `<要望>/task-reviews/<タスクID>/<run>/`。テストの出力そのものは残らない(証拠に書いた内容だけ) |
|
|
724
|
+
| 出す | リリースノート(変更の記録から要約の案を作り、人が直して保存・出力する)、マイルストーンのリリース済みの印、要望の一括完了済 | 要約の案は P3 から呼ぶ Codex(手で書いてもよい)。保存・リリース済み・一括完了は人。マージ・公開・デプロイは利用者の手元と外部の仕組み | `release-notes/<マイルストーンID>.md`(生成した案はメモリの上だけで、保存するまでファイルにならない)、リリース済みは `project.yaml`。公開物は P3 のデータの外 |
|
|
725
|
+
| 振り返って次に活かす | マイルストーンレビュー(目的・予定機能・品質基準に対してコードと履歴を読む参考の記録)、品質の不足からの改善要望の原稿、変更の記録と過去の run を次の Preflight が調べる | レビューは P3 から呼ぶ Codex。改善要望・次の要望は人か手元の AI エージェントが明示して登録する(自動では作らない) | `milestone-reviews/<マイルストーンID>/<run>/`、`quality-improvements.json`、変更の記録は `<要望>/tasks/Txxx.md` |
|
|
726
|
+
|
|
727
|
+
### P3 が意図して持たないもの
|
|
728
|
+
|
|
729
|
+
- **タスクの作業を AI に実行させる役**(作業の実行・並べての実行・エージェントの割り当て)。作業は利用者が選んだ手元のエージェントで
|
|
730
|
+
行い、P3 は指示(タスクの本文・受け入れ基準・作業先とブランチ)と記録(状態・成果物・変更の記録・証拠)の側に立つ。AI を動かす
|
|
731
|
+
課金と、実行したことの責任を利用者の側に置くため。どのエージェントにどこまで任せるかも利用者が決める。P3 から Codex を呼ぶのは、
|
|
732
|
+
評価・レビュー・要約のように資料を読んで記録を書く仕事だけで、それも操作する人のマシンでその人のアカウントで動く
|
|
733
|
+
([サーバに置かない理由](#サーバに置かない理由))
|
|
734
|
+
- **判断**: タスク化・済み・要望の完了済と見送り・リリースするかは人が決める。Preflight の判定・レビューの結果・証拠は材料で、それだけで
|
|
735
|
+
状態は進まない
|
|
736
|
+
- **コマンドの実行**: テスト・品質基準の検査・アプリの起動は作業する側が行う。P3 は実行せず、実行して確かめたとも記録しない
|
|
737
|
+
- **公開**: マージ・リリース・デプロイ・パッケージの公開は外部の仕組み(リモートのリポジトリ・CI・各自の手順)で行う。P3 は結果を
|
|
738
|
+
成果物の URL・リリース済みの印・リリースノートとして残すだけ
|
|
739
|
+
|
|
740
|
+
### 今は持っていないもの
|
|
741
|
+
|
|
742
|
+
上の線引きとは別に、今は無いもの。現時点では対象外で、今後の検討事項であり実装の約束ではない。
|
|
743
|
+
|
|
744
|
+
- レビューの結果から要望・タスクを自動で作ること(品質の改善要望も、人が原稿を確かめて明示したときだけ登録する)
|
|
745
|
+
- テスト・CI の結果を取り込むこと(残るのは作業した側が証拠に書いた内容だけ)
|
|
746
|
+
|
|
704
747
|
## 規則の置き場所
|
|
705
748
|
|
|
706
749
|
同じ規則を入口(CLI・API・画面)ごとに書かない。足すときは次の1か所を直す。
|
|
@@ -726,6 +769,12 @@ src は5つの層に分け、依存の向きを `test/layers.test.ts` で確か
|
|
|
726
769
|
| 画面の API の失敗の扱い(rev の競合・評価対象の変更・無い) | `web/lib/api.ts` の `failureOf` |
|
|
727
770
|
| リリースノートの本文の下書き(外の変更・削除・読めないときに入力を残す・編集を始めた版で保存) | `web/lib/releaseNoteDraft.ts` |
|
|
728
771
|
| 読み取り(一覧・参照の解き方・進捗) | `core/ops.ts` |
|
|
772
|
+
| アーカイブしたタスクの読み取り(通常の一覧・集計に混ぜない) | `core/store/archivedTasks.ts` |
|
|
773
|
+
| レビューの実行の記録の共通部分(保存・終わり・回復・取消・遅れた結果の拒否) | `core/reviewRuns.ts` |
|
|
774
|
+
| タスクの AI レビュー(材料・履歴) | `core/taskReview/`(`material.ts`・`store.ts`) |
|
|
775
|
+
| プロジェクトの品質基準(状態・ID の振り方・操作・テンプレートと改版の差分・版) | `shared/quality.ts`・`shared/qualityTemplates.ts`(保存は `core/quality.ts` と `Workspace.writeQuality`) |
|
|
776
|
+
| 作業中のタスクの止まっている理由(停止。付ける・直す・解除・履歴・止まったままの移動の拒否・壊れた値の読み方) | `shared/taskBlock.ts`(保存と状態との突き合わせは `core/requestOps.ts` の `updateTask`、集計は `core/ops.ts`) |
|
|
777
|
+
| タスクの受け入れ基準と証拠(ID の振り方・操作・失効・不足・壊れた値の読み方)と済みの解除 | `shared/acceptance.ts`(済みの解除と保存は `core/requestOps.ts` の `updateTask`) |
|
|
729
778
|
| リリースノート(材料の規則・保存・出力・要約の生成・要望の一括完了) | `core/releaseNotes/`(`material.ts`・`store.ts`・`service.ts`・`generate.ts`・`completeRequests.ts`) |
|
|
730
779
|
| タスクの関係(`depends_on`・`supersedes` だけ。同じ要望の中。Preflight のタスク化だけが張る) | `shared/types.ts` の `RELATION_TYPES`・`core/preflight/service.ts` の `materialize` |
|
|
731
780
|
| プロジェクトを跨ぐ serve(登録の一覧・登録世代・文脈の開閉) | `core/projectRegistry.ts`(API は `server/api/projectsRoutes.ts`) |
|
|
@@ -755,8 +804,9 @@ CLI は `cli/main.ts`(振り分け・プロジェクトと変更者の決定
|
|
|
755
804
|
認証情報は各自の ChatGPT の接続か `auth.json`(個人の場所に置き、プロジェクトには置かない)。
|
|
756
805
|
- 結果は戻り値ではなく **ファイル**(要望のフォルダの `preflight/<RUN>/assessment.json`, `drafts/*.md`)。
|
|
757
806
|
同期すればチームの全員が同じ評価とタスク案を見られる。誰が実行したかは `run.json` とタスクの `updatedBy` に残る。
|
|
758
|
-
- 画面資料(`preflight/<RUN>/ui/`)もファイル契約にする(`src/core/preflight/uiMaterials.ts
|
|
759
|
-
`ui/index.json` を書き、P3
|
|
807
|
+
- 画面資料(`preflight/<RUN>/ui/`)もファイル契約にする(`src/core/preflight/uiMaterials.ts`)。AI(Codex・手元の
|
|
808
|
+
エージェント)は画面の原稿(`ui/src/U1.html` …)と `ui/index.json` を書き、P3 が原稿を描画のコンテナで PNG にして `ui/index.json` に
|
|
809
|
+
書き足す([画面イメージの描画のイメージ](#画面イメージの描画のイメージ)。AI は画像を作らない)。P3 は取り込む前に確かめて `run.json` の `ui` に記録する。画像の形式と大きさは拡張子ではなく
|
|
760
810
|
中身から読み、配信のときも同じ確かめ方をもう一度する(取り込んだ後に差し替えられた画像は返さない)。画像は
|
|
761
811
|
要望 / run / 資料 ID で決め、パスを受け取らない。応答には `X-Content-Type-Options: nosniff` と
|
|
762
812
|
`Content-Security-Policy: default-src 'none'` を付け、HTML / SVG は配信しない。資料が不正でも評価は残し、
|
|
@@ -898,8 +948,268 @@ API の PATCH。`rev` で楽観ロック)。書き換えても状態・既存
|
|
|
898
948
|
- **着手の警告**: 置き換えられたタスクが作業中に変わったとき(CLI の `move` / `set`、API の PATCH、画面のボードと詳細)、
|
|
899
949
|
操作は行ったうえで `warnings`(code・対象・置き換えた側・文言)を返す。作業中のままの再指定では出さない。
|
|
900
950
|
- API: `GET .../preflight/:run/materialize` で確認(何も変えない)、`POST` に `{archive: [{id, rev}]}`。
|
|
951
|
+
|
|
952
|
+
### アーカイブしたタスク
|
|
953
|
+
|
|
954
|
+
タスクは消さずにアーカイブする(`tasks/<ID>.md` を `tasks/.archive/<ID>.md` へ移す。`p3 archive`・API の DELETE・タスク化の
|
|
955
|
+
`--archive-superseded`)。タスクの題・本文は今も `set`・画面で直せるが、要らなくなった・やり方を大きく変えるときは、アーカイブして
|
|
956
|
+
新しいタスクを作る(経緯がファイルに残る)。新しいステータスは足さない(状態は 未着手 / 作業中 / 完了 のまま)。
|
|
957
|
+
|
|
958
|
+
アーカイブは専用の読み取り(`core/store/archivedTasks.ts`)だけで見せ、通常のタスクのコレクション・索引・変更通知には入れない。
|
|
959
|
+
読むたびにディスクを読み、ファイル・rev・採番の予約を変えない。各タスクに `archived: true` を付け、通常のタスクの配列とは混ぜない。
|
|
960
|
+
|
|
961
|
+
| 見える | 見えない(数えない・材料にしない) |
|
|
962
|
+
| --- | --- |
|
|
963
|
+
| `p3 ls --archived` / `p3 show <T> --archived` | 通常の `ls`・`show`・`find`・`--all` |
|
|
964
|
+
| API の `GET /api/requests/:rid/archived-tasks[/:tid]` | API の `/tasks`・`/tasks/:tid`(GET・PATCH・DELETE)はアーカイブを探さない |
|
|
965
|
+
| 画面の要望の中のアーカイブの表示(閲覧専用) | タスクボード・対応済み・要望の見出しの完了数・進捗 |
|
|
966
|
+
| | 対応済の判定(タスク0件の判定も。全部アーカイブして子が無ければ「タスクがありません」) |
|
|
967
|
+
| | 依存の完了扱い(アーカイブした依存先は完了とみなさない) |
|
|
968
|
+
| | 新しく作るマイルストーンレビュー・リリースノートの材料と生成の入力 |
|
|
969
|
+
|
|
970
|
+
- 一覧は ID の数値順。フォルダが無ければ空。壊れたファイルは一覧の `errors` に出し、詳細は「無い」(404・終了コード 2)と
|
|
971
|
+
「読めない」(500 `archive_unreadable`・終了コード 1)を分ける。読める範囲は明示した要望の中だけ(要望 ID・タスク ID の形を確かめる)
|
|
972
|
+
- 状態・最終更新はアーカイブする前の最後の値。アーカイブした日時・理由は記録していないので作らない
|
|
973
|
+
- 復元・編集・アーカイブした要望の中のタスクの閲覧はしない。過去に保存したレビュー・リリースノート・git の履歴は消さない
|
|
901
974
|
要望の詳細と タスクの GET は印 `superseded` を返す。
|
|
902
975
|
|
|
976
|
+
### 受け入れ基準と証拠
|
|
977
|
+
|
|
978
|
+
タスクは任意で **受け入れ基準**(`acceptanceCriteria: [{id, text}]`。何を満たせば完了か)を持ち、作業した側は基準ごとに
|
|
979
|
+
**証拠**(`acceptanceEvidence: [{criterionId, criterionText, result, evidence, recordedAt, recordedBy}]`)を残す。規則は
|
|
980
|
+
`shared/acceptance.ts` の1か所で、CLI(`new --criterion`・`criteria`・`evidence`・`set` / `move` の `--evidence`)と API
|
|
981
|
+
(POST の `criteria`、PATCH の `acceptance` の操作)は同じ操作を `core/requestOps.ts` に渡すだけ。
|
|
982
|
+
|
|
983
|
+
- **ID**: 足すときに `A1, A2, ...` を振る。並べ替え・文言の変更で振り直さず、消した ID も使い直さない(振った最後の番号を
|
|
984
|
+
`acceptanceSeq` に残す)。基準・証拠は操作でだけ変え、PATCH の `acceptanceCriteria` などをそのまま書く道は持たない
|
|
985
|
+
- **証拠は申告**: 結果は `met` / `unmet` / `unverified`。`met` は本文が要る(空は入力の誤り)。未記録(証拠なし)と未検証は分ける。
|
|
986
|
+
これは作業した側の申告で、レビューの判定ではない(AI のレビューを足すときも、その判定は証拠とは別の型で持ち、証拠を書き換えない)
|
|
987
|
+
- **失効と消した基準**: 証拠は記録したときの基準の文言を写して持つ。文言を変えた基準の証拠は「再確認が必要」として達成に数えない。
|
|
988
|
+
基準を消しても証拠は「対応する基準のない証拠」として残す。再記録はその ID の証拠を置き換える(同じ値なら記録の日時も変えない)。
|
|
989
|
+
履歴は持たない
|
|
990
|
+
- **完了を拒まない**: 基準なし・証拠なし・未達・未検証でも、完了・済み・対応済は今までどおり(状態も要望の判定も増やさない)。
|
|
991
|
+
不足は `acceptance.shortfalls`(show・API の GET)と `move ... done` の stderr で読めるようにするだけ。AI の完了に変更の記録が要る
|
|
992
|
+
CLI の決まりは変えず、API には広げない
|
|
993
|
+
- **済みの解除**: 済みのタスクの基準・証拠の中身(並び・文言・結果・証拠)が変わったら済みを外し、`checkCleared` に理由を返す。
|
|
994
|
+
同じ値の再保存・成果物の追加・同じ操作で済みを付け直すときは外さない。未完了へ戻すと外れるのは今までどおり
|
|
995
|
+
- **今の値に当てる**: 操作は書く直前に読み直したファイルの値に当て、1つでも規則に合わなければ何も書かない(`rev` を渡せば競合も分かる)
|
|
996
|
+
- **Preflight のタスク案**: 案(`drafts/D*.md`)も `acceptanceCriteria` を持つ。Codex・手元のエージェントは文の並びで書き、
|
|
997
|
+
P3 が読むときに A1, A2, ... を振る(`shared/acceptance.ts` の `readDraftCriteria`)。読めない基準は案の `acceptanceProblems`
|
|
998
|
+
(案のファイルには書かない)に出し、手元の結果の取り込み(`--complete`)では直せる問題として断る。Codex の run では案に残して
|
|
999
|
+
ログに出し、その案はタスク化を断る(直せば消える)。人の編集は並び全体の置き換えで、編集を始めたときの基準
|
|
1000
|
+
(`expectedCriteria`)と今の基準が違えば題と同じく 409 で書かない(同じ題のまま他で基準が変わっても上書きしない)。
|
|
1001
|
+
タスク化は採用した案の基準を ID ごと写し、振った最後の番号を `acceptanceSeq` に引き継ぐ。やり直しで作ったタスクは
|
|
1002
|
+
上書きしない。前回の案の基準(人の編集を含む)は再評価の引き継ぎに書く。基準の無い前の run の案は基準なしとして扱う
|
|
1003
|
+
- **壊れた直接編集**: 読めない項目(重複した ID・空の文・知らない結果など)は除いて読み、理由を `acceptanceProblems`(ファイルには
|
|
1004
|
+
書かない)に出す。問題のあるタスクの基準・証拠は操作で変えず(直すよう知らせる)、関係のない更新ではファイルの元の値をそのまま
|
|
1005
|
+
書き戻す(`core/store/collection.ts` の `keepRaw`)。黙って消さない
|
|
1006
|
+
|
|
1007
|
+
### 品質基準
|
|
1008
|
+
|
|
1009
|
+
プロジェクトとして守る最低限の水準(コーディング規約・構成と依存の向き・検証・文書の更新・lint など)を project.yaml の `quality` に
|
|
1010
|
+
持つ。初めて作ったときの状態に任せず、明記するため。Preflight の観点(`preflight.instructions`)・タスクのレビューの観点
|
|
1011
|
+
(`taskReview.viewpoints`)とは別の項目で、どちらもそのまま残る。
|
|
1012
|
+
|
|
1013
|
+
```yaml
|
|
1014
|
+
quality:
|
|
1015
|
+
templates: [{ id: basic, version: 1 }] # 採用したテンプレート(版)
|
|
1016
|
+
standards:
|
|
1017
|
+
- id: Q1 # 安定した ID(消した ID は使い直さない)
|
|
1018
|
+
text: プロジェクトのコーディング規約に従う
|
|
1019
|
+
check: { kind: manual, reference: docs/development.md と照らす } # 人の確認
|
|
1020
|
+
source: { template: basic, version: 1, key: conventions }
|
|
1021
|
+
- id: Q5
|
|
1022
|
+
text: lint が警告なしで通る
|
|
1023
|
+
repos: [app] # 対象の参照先(無ければ全部)
|
|
1024
|
+
check: { kind: machine, command: pnpm lint, success: 終了コード 0 } # 機械の検査(作業する側が実行する)
|
|
1025
|
+
exempt: { reason: ... } # 適用の除外(理由が要る)
|
|
1026
|
+
seq: 5 # 振った最後の番号
|
|
1027
|
+
```
|
|
1028
|
+
|
|
1029
|
+
- **状態**: `quality` が無ければ未設定、あれば設定済み(意図して空でもよい)、読めない値(重複した ID・理由の無い除外・確認の方法の
|
|
1030
|
+
欠け)があれば invalid。invalid は未設定として扱い、ファイルの値は消さず、操作は断って直し方を示す。知らない参照先は警告だけ
|
|
1031
|
+
- **上限**: 100 件、文 1000・コマンド 500・成功の条件 500・確かめ方 1000・除外の理由 500 文字
|
|
1032
|
+
- **書き方**: `core/quality.ts` の操作(init・adopt・upgrade・add・replace・edit・remove・exempt・unexempt)を `Workspace.writeQuality` が
|
|
1033
|
+
project.yaml のロックの中で、読み直した最新の値に当て、`quality` の項目だけを書く(コメント・ほかの項目は残す)。設定の保存
|
|
1034
|
+
(PUT /api/project・`p3 config`)・参照先の保存・マイルストーンの保存は `quality` を書かないので、無関係な保存で品質基準は消えない
|
|
1035
|
+
- **版**: 品質だけの中身の hash(`qualityVersion`)。操作に版を渡すと、違えば `quality_conflict`(API 409・CLI 終了コード 3)で何も書かない
|
|
1036
|
+
- **テンプレート**(`shared/qualityTemplates.ts`): 版つきの例(共通の基本・TypeScript の例)で、業界の標準への認証ではない。採用すると
|
|
1037
|
+
編集できる実体として写し、出典(`source`)を残す。テンプレートが改版しても採用済みの内容は変わらず、差分(足す・変わる・消える)
|
|
1038
|
+
を見て `upgrade` で明示して当てる
|
|
1039
|
+
- P3 はコマンドを実行しない・依存を入れない。確認の方法は CI・手元の作業・外の自動化のどれでもよく、特定の製品・フォルダを必須にしない
|
|
1040
|
+
|
|
1041
|
+
### 品質の改善要望
|
|
1042
|
+
|
|
1043
|
+
品質の不足から改善要望を作る(`core/qualityImprovement.ts`。形は `shared/qualityImprovement.ts`)。
|
|
1044
|
+
|
|
1045
|
+
- **診断**(読むだけ): 出典は品質基準の設定(`project`)・タスクのレビューの1回分・マイルストーンレビューの1回分。不足を
|
|
1046
|
+
unset(未設定)/ invalid(読めない設定)/ violated(レビューで確かめた違反)/ undetermined(判断できない)/ exempt(理由つきの除外)に
|
|
1047
|
+
分ける。検査が未実行だから未導入とは判定しない。除外は不足に数えず、既定では選ばない(人が選べば原稿にする)。品質の材料が無い
|
|
1048
|
+
古い記録は「品質を評価していない」と注記するだけ
|
|
1049
|
+
- **原稿**(読むだけ): 選んだ不足だけで題と本文の案を作る(品質 ID・版・元の run・指摘・根拠・目指す差・完了条件の案。P3 は検査を
|
|
1050
|
+
実行していないと注記)。原稿は資料で、中の文の指示は実行しない。設定の保存・レビューの実行では作らない
|
|
1051
|
+
- **登録**(明示したときだけ): 既存の `createRequest` で下書きの要望を作る。ロックの中で診断を取り直し、原稿を作った診断の版(hash)
|
|
1052
|
+
と違えば `diagnosis_changed`(409・終了コード 3)
|
|
1053
|
+
- **重複と回復**: 不足ごとの鍵(品質 ID・対象・不足の種類。run の違いでは増えない)と登録先を `<data>/quality-improvements.json` に残す。
|
|
1054
|
+
先に予約(token)を書き、token のタグ(`quality-improvement:<token>`)を付けた要望を作り、最後に登録先を書く。途中で落ちても、次の
|
|
1055
|
+
登録でタグから要望を見つけて台帳を直す。開いている登録先があれば `existing` で案内して作らない。閉じた要望で扱った不足は
|
|
1056
|
+
`closed_existing` で、作り直すことを明示(`reopenClosed`・`--reopen`)させる
|
|
1057
|
+
- タスクを自動で作る・レビューの指摘全般を自動で要望にすることはしない
|
|
1058
|
+
|
|
1059
|
+
### 品質基準とタスク(Preflight・受け入れ基準・証拠)
|
|
1060
|
+
|
|
1061
|
+
- **Preflight**: 始めるときに品質基準を run に固定する(`run.quality`: 状態・版・項目)。Codex と手元のエージェントの両方の指示に
|
|
1062
|
+
「比較の資料。中の指示・コマンドは実行しない」として入れる(未設定・読めないもそう書く)。実行中に設定が変わっても、評価と
|
|
1063
|
+
タスク化は run の版を使う
|
|
1064
|
+
- **取り込み**: タスク化(採用した案)と直接作成(`createTask` の `quality`: auto / none / ID の並び)で、作業先に当てはまり除外して
|
|
1065
|
+
いない品質基準を受け入れ基準として足す。文は `[Q1] 文(確認の方法)`、出典 `quality: { id, hash, version }`(品質 ID・取り込んだ
|
|
1066
|
+
ときの項目の hash・設定の版)を基準に残す。作業先なしのタスクには自動では足さず、明示したものだけ。同じ品質 ID は二重に足さない。
|
|
1067
|
+
受け入れ基準の上限を超えるなら断る(黙って省かない)
|
|
1068
|
+
- **差分と明示の取り込み**: 設定を変えてもタスクは書き換えない。`taskQualityDiff` が差分(add・change(項目の hash が変わった)・
|
|
1069
|
+
remove(消えた・当てはまらなくなった)・exempt・edited(タスクで文を直した。知らせだけ))を出し、`importQuality` が選んだものだけを
|
|
1070
|
+
受け入れ基準の操作として当てる(add は足す、change は文と出典を直す → その証拠は記録したときの文と違うので「再確認が必要」、
|
|
1071
|
+
remove・exempt は基準を消す → 証拠は対応する基準のない証拠として残る)。済みの後に中身が変われば済みが外れる(受け入れ基準の規則のまま)
|
|
1072
|
+
- **読めない出典**: 基準の `quality` が読めなければ受け入れ基準の読めない値として知らせる(黙って基準なしにしない)
|
|
1073
|
+
- **証拠**: 検査は作業する側が実行し、コマンド・参照先とコミット(未コミットならそう書く)・結果・範囲・省いた理由を証拠に書く
|
|
1074
|
+
(同梱のスキル)。P3 は実行して確かめたとは表さない
|
|
1075
|
+
|
|
1076
|
+
### 止まっている理由(停止)
|
|
1077
|
+
|
|
1078
|
+
作業中のタスクが進められなくなった(人の判断・権限が要る、前提が崩れた、テストが通らず先に進めない)ことを、状態ではなく
|
|
1079
|
+
作業中のタスクの属性として持つ。状態は 未着手 / 作業中 / 完了 のまま。規則は `shared/taskBlock.ts` の1か所で、CLI
|
|
1080
|
+
(`block` / `unblock`)と API(PATCH の `blockOp`)は同じ操作を `core/requestOps.ts` の `updateTask` に渡すだけ。
|
|
1081
|
+
|
|
1082
|
+
```yaml
|
|
1083
|
+
block: # 今の値(止まっていなければ無い)
|
|
1084
|
+
reason: テストが通らず先に進めない # 何で止まったか(空白だけは不可。2000 文字まで)
|
|
1085
|
+
decision: API の形を変えてよいか # 人に決めてほしいこと(任意。2000 文字まで)
|
|
1086
|
+
since: 2026-11-12T01:00:00.000Z # 止まった時刻(内容を直しても変えない。解除して付け直すと新しくなる)
|
|
1087
|
+
updatedAt: 2026-11-12T01:30:00.000Z
|
|
1088
|
+
updatedBy: ai:claude
|
|
1089
|
+
blockHistory: # 履歴(追記だけ。before / after はそのときの今の値の写し)
|
|
1090
|
+
- { action: set, at: ..., by: ai:claude, after: { reason: ..., since: ... } }
|
|
1091
|
+
- { action: update, at: ..., by: ai:claude, before: {...}, after: {...} }
|
|
1092
|
+
- { action: clear, at: ..., by: human:me, before: {...}, resolution: 形を変えてよい } # 回答・解決の内容は必須(4000 文字まで)
|
|
1093
|
+
```
|
|
1094
|
+
|
|
1095
|
+
- **付ける・直す**は作業中のタスクだけ(`block_not_doing`)。時刻は P3 が付け、変更者は actor。値・履歴をそのまま書く入力の道は
|
|
1096
|
+
持たない(PATCH の `block`・`blockHistory` は捨てる)。同じ内容の付け直し・付いていない解除は何も書かない(履歴も rev も増やさない)
|
|
1097
|
+
- **止まったままの移動**: 作業中から未着手・完了へ動かす更新は断る(`blocked`。API は 409)。解除と移動を同じ更新に書けば、確かめてから
|
|
1098
|
+
1つのファイルに一緒に保存する。付与と作業中でない状態への移動を一緒に書けば断る。解除は状態・作業中にした日時・完了の日時・済み・
|
|
1099
|
+
要望の状態を変えない(自動では再開しない)。既に作業中でないのに停止が付いている(直接編集)タスクは警告だけにし、関係のない
|
|
1100
|
+
更新は断らない(解除で直す)
|
|
1101
|
+
- **今の値に当てる**: 操作は書く直前に読み直したファイルの値と、更新した後の状態で確かめ、今の値と履歴を同じ1回の書き込みに入れる。
|
|
1102
|
+
rev を渡せば競合で何も書かない。同じ OS の権限での直接の書き換え・ほかのプロセスとの完全な排他は保証しない(完全な監査ログではない)
|
|
1103
|
+
- **壊れた直接編集**: 読めない値は除いて読み、理由を `blockProblems`(ファイルには書かない)に出す。問題があれば停止の操作は断り
|
|
1104
|
+
(ファイルの `block` / `blockHistory` を直すよう知らせる)、関係のない更新ではファイルの元の値をそのまま書き戻す(`keepRaw`)
|
|
1105
|
+
- **読む**: `ls --blocked`・GET tasks の `?blocked=true`(ほかの条件と AND。アーカイブの一覧では使えない)。通常の一覧に停止の印・
|
|
1106
|
+
止まった日・理由、show に今の値・履歴・問題、`--brief` に今の値と問題(履歴は省く)。アーカイブしたタスクは今の値・履歴を読むだけ
|
|
1107
|
+
- **集計**: 進捗(`RequestProgress`)に自分の停止の数 `blocked`・配下の数 `subtree.blocked`、タスクの印(`TaskMark`)に今の値。
|
|
1108
|
+
止まっていても作業中に数え、完了率と要望の完了の判定は変えない。全体の合計は自分の数だけを足す(配下を足すと二重に数える)
|
|
1109
|
+
- 変更の記録(`record`)は完了したときに書くもので、停止の履歴とは別
|
|
1110
|
+
|
|
1111
|
+
### タスクの AI レビュー(材料)
|
|
1112
|
+
|
|
1113
|
+
完了したタスクの本文・受け入れ基準に対して、比較対象の変更が基準を満たしているかを、作業したのとは別の Codex のスレッドに
|
|
1114
|
+
読むだけで確かめさせる参考の記録。作業した AI の能力・成績の評価ではない。材料は `core/taskReview/material.ts` が固定する
|
|
1115
|
+
(何も書かない。保存は別)。形は `shared/taskReview.ts`。
|
|
1116
|
+
|
|
1117
|
+
- **対象**: 保存してある完了したタスク(済みも再実行できる)。無い(404)・未完了(`not_done`)・アーカイブ(`archived`)は断る
|
|
1118
|
+
- **タスクの材料**: 本文・受け入れ基準・作業した側の証拠(基準ごとの今の状態 `evidenceStates`、読めない値)・変更の記録・成果物・
|
|
1119
|
+
要望の題と本文。証拠は申告として写し、判定に変えない。基準が無ければ本文の「完了条件」の箇条書き(無ければ箇条書き全部、
|
|
1120
|
+
それも無ければ段落)から比較項目 B1, B2, ... を取り出し、元の段落を残す。基準なし・読めない値・古い証拠・証拠なし・記録なし・
|
|
1121
|
+
成果物なしは注意(`notes`)に残す(比較材料が無いことを黙って満たしているにしない)
|
|
1122
|
+
- **比較対象**(`--target`。省くとタスクの成果物のコミット):
|
|
1123
|
+
- `<参照先>:<コミット>`(カンマで複数): それぞれ親との差分(ルートのコミットは空の tree との差分)
|
|
1124
|
+
- `<参照先>:<base>..<head>`: `merge-base(base, head)` から head までの差分。base・head・merge-base を残す
|
|
1125
|
+
- 参照先を省くと、タスクの作業先 → コミットが見つかる読める参照先が1つ、の順に決める。複数にあれば `ambiguous_repo`
|
|
1126
|
+
- マージのコミット(親が2つ以上)は `merge_commit` で断り、どの親と比べるかを範囲で指定してもらう。浅い履歴で親が無ければ `shallow`
|
|
1127
|
+
- PR の URL は出典として残すだけで、中身は取りに行かない(fetch・checkout・認証はしない)。PR だけなら取得済みの base..head を案内する
|
|
1128
|
+
- どれも完全な SHA に固定する。作業ツリーの未コミットの変更・今のブランチは混ざらない。コミットのメッセージにほかのタスクの参照が
|
|
1129
|
+
あれば `other_tasks` の注意にする(この範囲と分けて読む)
|
|
1130
|
+
- **差分と中身**: 差分の本文(`diff/<参照先>/<n>.patch`)と、変わったファイルの前後の中身(`code/<参照先>/<SHA>/<パス>`)を git の
|
|
1131
|
+
オブジェクトから取り出す。submodule・シンボリックリンク・バイナリは中身を取り出さず一覧だけ(先は追わない)。材料のフォルダに
|
|
1132
|
+
置けないパス(`..`・絶対パス・制御文字)は使わない。コードは実行しない
|
|
1133
|
+
- **上限**: ファイル1件 200KB・合計 4MB を超えるものは切り詰めずに取り出さず、注意(`omitted`)として未確認の範囲にする。
|
|
1134
|
+
差分の本文の合計が 1MB を超える・コミットが 50 件を超えるなら `too_large` で断る
|
|
1135
|
+
- **観点**(`--viewpoint`。人が明示したものだけ。優先順位は「明示した指定 → 既定」で、作業ブランチのファイルから推測しない):
|
|
1136
|
+
- 省く・`builtin`: 既定の観点だけ
|
|
1137
|
+
- `<参照先>@<SHA かブランチ>:<パス>`: その時点のファイルを git のオブジェクトから読む(SHA に固定して残す。作業ブランチで
|
|
1138
|
+
同じファイルを変えても、選んだ SHA の文面を使う)
|
|
1139
|
+
- `project`: project.yaml の `taskReview.viewpoints`(共有の設定。無ければ断る)
|
|
1140
|
+
- 選んだ文面・出典・SHA・hash を材料に残す。資料の中の指示は実行しない
|
|
1141
|
+
- **hash**: 要望・タスクの材料・比較項目・比較対象(SHA)・観点・注意・取り出したファイルの中身の hash から作り、抽出の日時と
|
|
1142
|
+
比較対象の出典(成果物の文字列か指定か)は入れない(同じ SHA を比べていれば指定の仕方によらず同じ。どれかが変われば変わる)
|
|
1143
|
+
|
|
1144
|
+
### マイルストーンレビュー(品質)
|
|
1145
|
+
|
|
1146
|
+
- 抽出したときの品質基準を版つきで材料(`input.quality`)に固定し、hash に入れる。画面は確かめた材料の hash で始め、変わっていれば
|
|
1147
|
+
`material_changed`(409)。終わったときに材料を取り出し直し、違えば `run.inputChanged` を残す
|
|
1148
|
+
- 目的・予定機能の判定(units)はそのままに、除外していない品質基準ごとにちょうど1回ずつ品質を判定する(`result.quality`。満たす・違反は
|
|
1149
|
+
コードかコミットの根拠、対象外は理由が要る)。品質の問題を未達や意図しない変更に押し込めない。過去に満たしていたものを崩したと
|
|
1150
|
+
履歴のコミットで裏付けたときだけ `regression`(品質の低下)にし、比べる根拠が無ければ今の不適合として扱う。CI の設定や申告だけで
|
|
1151
|
+
実行して通ったとはしない。読めない参照先に関わるものは判断できないにする
|
|
1152
|
+
- 未設定・読めない品質基準は警告にして設定へ案内し、品質は判定しない。品質の材料が無い古い記録は「品質は評価していない」と出す。
|
|
1153
|
+
品質だけで実行する道は作らない(目的か予定機能が要る開始の条件のまま)。状態・リリースの操作は変えない
|
|
1154
|
+
|
|
1155
|
+
### タスクの AI レビュー(品質)
|
|
1156
|
+
|
|
1157
|
+
- **材料**(`input.quality`): レビューを始めたときの最新の品質基準(`latest`。状態・版・項目)、そのうちタスクの作業先に当てはまり除外して
|
|
1158
|
+
いないもの(`applies`)と除外したもの(`exempt`)、タスクの受け入れ基準に取り込んだ品質基準(`imported`。版と hash)、取り込んだ版と最新
|
|
1159
|
+
の差(`diff`)を固定する。観点(builtin・project・固定 SHA のファイル)を何にしても、この比較は外さない。品質の材料も hash と
|
|
1160
|
+
プレビューに入り、始める前に変わっていれば `material_changed` で断る。未設定・読めない設定は注意に残し、品質は判定させない
|
|
1161
|
+
- **判定**(`result.quality`): タスクの比較項目(契約の充足)とは別に、`applies` の基準ごとにちょうど1回ずつ、satisfied(満たす)/
|
|
1162
|
+
violated(違反)/ undetermined(判断できない)/ not_applicable(対象外。理由が要る)と理由・根拠・確かめられなかった範囲を出させる。
|
|
1163
|
+
満たす・違反はコード・差分の根拠が要る。検査のコマンドは実行せず、設定があるだけで通ったとはしない。材料に無い全体の構成や変えて
|
|
1164
|
+
いない設定は判断できないとし、未導入と断定しない。取り込んだ版にも反するコードの逸脱と、最新の基準にだけある条件の不足(基準の
|
|
1165
|
+
改定)は理由で分けさせる
|
|
1166
|
+
- **表示**: 違反は「品質の指摘」として出し、作業した側の証拠とは別の判定として扱う。品質の材料が無い古い記録は「品質は評価していない」
|
|
1167
|
+
と出し、新しい基準で補わない。レビューはタスクの状態・済み・証拠を変えず、済みや完了の条件にもしない
|
|
1168
|
+
|
|
1169
|
+
### タスクの AI レビュー(履歴と実行)
|
|
1170
|
+
|
|
1171
|
+
履歴は要望のフォルダの中に置く(`core/taskReview/store.ts`)。要望をアーカイブすれば一緒に動き、タスクをアーカイブしても残って読める。
|
|
1172
|
+
|
|
1173
|
+
```text
|
|
1174
|
+
requests/<要望ID>/task-reviews/<タスクID>/<run>/input.json 固定した材料(作ったら変えない)
|
|
1175
|
+
requests/<要望ID>/task-reviews/<タスクID>/<run>/material/ 材料のファイル(差分・前後のコード。作ったら変えない)
|
|
1176
|
+
requests/<要望ID>/task-reviews/<タスクID>/<run>/run.json 実行の記録(状態・実行者・エンジン・所有者・失敗の理由・取消の要求)
|
|
1177
|
+
requests/<要望ID>/task-reviews/<タスクID>/<run>/review.json 結果(completed のときだけ。書き終えてから completed にする)
|
|
1178
|
+
requests/<要望ID>/task-reviews/.locks/<タスクID>.lock 状態を変えるときのロック(タスクごと)
|
|
1179
|
+
```
|
|
1180
|
+
|
|
1181
|
+
- run の ID は `TR-YYYYMMDD-HHMMSS-xxxx`。要望・タスク・run の ID の形を確かめ、保存先の外を指すもの・材料のパスの `..`・
|
|
1182
|
+
シンボリックリンクは断る。材料のファイルは新しいファイルとしてだけ作り、途中で断ったら作りかけの run を消す
|
|
1183
|
+
- 同じタスクで実行中の run は1つだけ(プロセスの間もロックの中で確かめる)。別のタスク・別のプロジェクトは独立
|
|
1184
|
+
- 状態は running → completed / failed / cancelled の一方向。終わった run の材料・結果は通常の操作で書き換えない(結果を直す口は
|
|
1185
|
+
作らない。直すなら材料を直して別の run でレビューし直す)。同じ OS の権限でファイルを直接書き換えることは防がない
|
|
1186
|
+
- 保存・終わり・回復・取消の規則はマイルストーンレビューと共通(`core/reviewRuns.ts` の `RunControl` とファイルの書き方)。
|
|
1187
|
+
比較材料と結果の形は各レビューに残す(タスクにマイルストーンの ID を割り当てない)
|
|
1188
|
+
- 結果はタスクのファイル(本文・`acceptanceEvidence`)に書かず、タスクの状態・済み・基準・証拠・要望の状態も変えない
|
|
1189
|
+
|
|
1190
|
+
### タスクの AI レビュー(実行)
|
|
1191
|
+
|
|
1192
|
+
`core/taskReview/service.ts`(CLI の `p3 review`・API の `/requests/:rid/tasks/:tid/reviews` が呼ぶ)。依頼文と結果の確かめ方は `review.ts`。
|
|
1193
|
+
|
|
1194
|
+
- **頼む先**: Preflight と同じ Codex の接続(`CodexWorkspaceEngine.ask`。認証・パスの対応・診断・時間と使用量の上限・取消を共有)。
|
|
1195
|
+
毎回新しいスレッドで、作業したスレッドは再開しない。マウントするのは run の材料のフォルダ(`/workspace/material`)だけで、
|
|
1196
|
+
参照先のリポジトリ・データのフォルダは渡さない。Mock は明示したときだけ(失敗しても Mock に切り替えない)。時間の上限は 20 分
|
|
1197
|
+
- **確かめるもの**: 「要望・タスクの基準が成果物で満たされているか」。作業した AI の能力・成績の評価ではないと依頼文に書く。
|
|
1198
|
+
項目ごとの判定(satisfied / missing / undetermined)・理由・根拠・不足、意図しない変更の候補、人が確かめる点(基準の矛盾・本文の
|
|
1199
|
+
追加の要件。直さない)、読めた範囲と読めなかった範囲
|
|
1200
|
+
- **結果の確かめ**: 全部の比較項目がちょうど1回ずつ・区分・件数・文字数。根拠は `<参照先>@<SHA>:<パス>[:行]`(SHA は差分の base か
|
|
1201
|
+
head。変更の一覧に照らし、削除したファイルは前の側、追加したファイルは後の側で受け付ける。今の作業ツリーにあるかは見ない)・
|
|
1202
|
+
`<参照先>@<SHA>`(比較対象のコミット)・材料のファイル・比較項目・タスクの参照。「満たしている」はコード・差分の根拠が要る。
|
|
1203
|
+
形が違う・偽の根拠は失敗(`invalid_output`)
|
|
1204
|
+
- **担当が agent のとき**: `preflight.runner=agent` を Codex を使う同意とみなさない。engine を明示しない開始は `engine_required` で断る
|
|
1205
|
+
(Codex は呼ばない)。画面・CLI は明示の選び方を案内する
|
|
1206
|
+
- **確かめ直し**: プレビューで見た材料の hash(`expectedHash`)を渡すと、始めるときに材料が変わっていれば `material_changed`(409・終了コード 3。画面の登録の変化の `changed` とは別の code)
|
|
1207
|
+
- **手元のエージェント(今は持たない)**: Preflight の `--prepare` / `--complete` と同じ形で、手元のエージェントの別のセッションに材料の
|
|
1208
|
+
フォルダを読ませて結果を書かせる道も考えられる(利点: Codex を使えない環境でも使える・利用者の手元のエージェントの課金で済む)。
|
|
1209
|
+
その場合も、入力は P3 が固定した材料(input.json・material/)だけにし、結果は同じ `parseTaskReview` で確かめてから取り込む契約にする。
|
|
1210
|
+
作業したセッションと同じ文脈で評価させない(新しいセッションで頼む)ことは P3 から保証できないので、初期版は Codex の経路だけにした
|
|
1211
|
+
- 結果はタスクの状態・済み・基準・証拠・要望の状態を変えず、済みの条件にもしない(既存の `check` に条件を足さない)
|
|
1212
|
+
|
|
903
1213
|
### リリースノートの要約(生成の境界)
|
|
904
1214
|
|
|
905
1215
|
マイルストーンのリリースノートの機能の要約は、Preflight と同じ Codex の接続(個人設定・認証・イメージの確かめ・起動の診断)で頼む
|
|
@@ -1088,10 +1398,13 @@ Playwright が入っても、それだけでは描画の安全の条件(ネッ
|
|
|
1088
1398
|
- 着手する前に `p3 show T003 --brief --json` で本文・依存とその状態(`dependencies`)・置き換えの注意(`warnings`)を読む
|
|
1089
1399
|
- 着手する前に、`--brief --json` の `work`(作業先のリポジトリとブランチ)を見て、そのリポジトリでブランチに入る(作業先なしなら移動しない)
|
|
1090
1400
|
- 着手するときは `p3 move T003 doing`。テストを通したら、コミットする前に `p3 move T003 done --output <今ある成果物(変えたファイルや説明)> --record -` で完了にする(変更の記録は必須: 何を変えたか・なぜ・入れた決まり・やめたもの を標準入力から Markdown で。まだ無い URL は書かない)
|
|
1401
|
+
- 受け入れ基準(`--brief --json` の `item.acceptanceCriteria`)があれば着手する前に読み、完了するときに基準ごとの証拠を `--evidence-file evidence.md`(見出し `## A1 met` ごとに通したテスト・コマンドと結果・確かめたこと)で残す。`[Q1]` で始まる基準はプロジェクトの品質基準で、その検査は自分で実行してコマンド・参照先とコミット(未コミットならそう書く)・結果・範囲を証拠に書く(P3 が実行したとは書かない)。満たせなかった・確かめていない項目は `unmet` / `unverified` と理由を正直に書き(推測で `met` にしない)、未達・未検証を残して完了にしたら人に伝える。証拠は自分の申告で、済みにするかは人が決める。基準を自分で消す・書き換えて満たしたことにしない
|
|
1091
1402
|
- 要望のタスクを全部終えたら、コミットする前に `p3 request set <要望ID> status=resolved`(対応済)にする。完了済(done)・見送り(rejected)とタスクの済み(check)は人が決める
|
|
1092
1403
|
- 子の要望(`parent` のある要望)は、親とは別の要望として子ごとのタスクとブランチで作業する(親のタスクにしない)。分割の案の採用(`accept`)は人が行う。子の Preflight は親と同じ担当で、頼まれたときだけ(分割の採用・子の作成から自分で評価へ進まない)。親を対応済にするのは、親のタスクと見送り以外の子(`request show <親> --brief --json` の `children`)が全部終わってから
|
|
1093
1404
|
- データのフォルダがこの作業ツリーの中で git 管理されているなら、要望のフォルダ(`requests/<要望ID>/`)の変更も実装と同じコミットに入れる(後のレビューで要望とやったことを精査するため。子なら祖先の要望のフォルダ、親を対応済にするときは子孫の要望のフォルダ(見送りの子など)のまだ入っていない変更も入れ、ほかの要望・関係ない変更は入れない。外・無視・worktree のときは入らないので、移動や `git add -f` はしない)。push に失敗したら完了の記録は残し、公開できていないことを伝える。要望のフォルダは、マージするまで要望のブランチにしか無い。既定のブランチに切り替えると、その要望(子なら親の子の一覧からも)が消えたように見えるが、データはブランチにある(作り直したり、別のブランチから写したりしない)
|
|
1094
1405
|
- コミットや PR の URL は後から `p3 move T003 done --output <URL>` で足す(完了・記録はそのまま。データをコミットしているなら追記もコミットして push)。複数のリポジトリにまたがるときは最後のタスクに `--repo-output <参照先>=<PR の URL>` で全部の PR を残す
|
|
1406
|
+
- タスクの AI レビュー(`p3 review`)は頼まれずに始めない(Codex を使う)。結果を理由に済みにしたり基準・証拠を書き換えたりしない
|
|
1095
1407
|
- 置き換えられたタスク(`p3 ls` の `※置換`、`--json` の `superseded`)からは始めない。`move` が `warnings` を返したら止めて人に確かめる
|
|
1408
|
+
- 人の判断・権限が要る・前提が崩れた・テストが通らず先に進めないなどでタスクを続けられなくなったら、`p3 block T003 --reason "<具体的な理由>" --decision "<人に決めてほしいこと>" --json` で止まっている理由を付け(通常の修正・調査の途中では使わない)、JSON の `block` で保存できたことを確かめてから、理由・いつから・答えてほしいこと・再開のしかたを人に伝えて作業を終える(止まったまま完了・済み・対応済に進めない。基準や証拠を書き換えない)。回答を受けたら `p3 unblock T003 --resolution "<回答>"` で解除して再開する(解除だけでは再開しない。人が先に解除していたら履歴の回答を読んで確かめる)
|
|
1096
1409
|
- 作業中に新しく必要になった作業は `p3 new "<タイトル>" --body "..."` でタスクにする(人への質問はタスクにしない)
|
|
1097
1410
|
```
|
package/docs/development.md
CHANGED
|
@@ -133,7 +133,7 @@ pnpm video # 使い方の動画を録り直す(.p3-video/p3-
|
|
|
133
133
|
TypeScript 7 の型検査器で tsconfig.json を読む)も動かす。設定は `.oxlintrc.json`。ESLint・Biome・整形の道具は入れていない
|
|
134
134
|
(書式はそろえて書く)。指摘は全部エラーで、警告も使われていない無効化コメントも `pnpm check` を落とす。
|
|
135
135
|
|
|
136
|
-
- **対象**:
|
|
136
|
+
- **対象**: package.json の `lint` に並べた `src`・`scripts`・`test`・`vite.config.ts`・`vitest.config.ts`・`vitest.ui.config.ts`。この中の `.mjs`
|
|
137
137
|
(起動の補助・偽の app-server など)も、TypeScript の対象ではないが型情報なしの規則で検査する。`bin/` は対象の外
|
|
138
138
|
- **除外**: 生成したルート一覧 `src/web/routeTree.gen.ts`。`dist/`・`node_modules/`・`.p3-demo/` は対象のフォルダの外
|
|
139
139
|
- **規則**: plugin は typescript・unicorn・oxc・react・import・promise・vitest。それぞれの correctness(誤りか無意味なコード)を全部
|