@infodb/p3 0.12.0 → 0.13.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 +32 -35
- package/dist/web/assets/CompletionReview-gZKZrDu_.js +1 -0
- package/dist/web/assets/ImprovementDialog-Dno6dPnG.js +1 -0
- package/dist/web/assets/Outputs-BgHalMGb.js +1 -0
- package/dist/web/assets/RequestStatus-hZcBUUIu.js +1 -0
- package/dist/web/assets/Tabs-C3NmwCc3.js +1 -0
- package/dist/web/assets/TagInput-B2b862qn.js +1 -0
- package/dist/web/assets/TaskDrawer-4BQBELXa.js +6 -0
- package/dist/web/assets/_requestId-BMAG1t3o.js +1 -0
- package/dist/web/assets/_requestId-tbg2pA2S.js +1 -0
- package/dist/web/assets/archive-DMl6WyOe.js +1 -0
- package/dist/web/assets/board-BMTcHKyt.js +1 -0
- package/dist/web/assets/done-CL6Nlsua.js +1 -0
- package/dist/web/assets/draft-BvGxfD7v.js +2 -0
- package/dist/web/assets/index-Dp7Fc4VI.css +2 -0
- package/dist/web/assets/index-KdlgMitg.js +12 -0
- package/dist/web/assets/metrics-Cu7gJ7Rk.js +1 -0
- package/dist/web/assets/new-DTXWHuFO.js +1 -0
- package/dist/web/assets/outputs-CXqnjSqV.js +1 -0
- package/dist/web/assets/preflightInput-ClKwkp8R.js +2 -0
- package/dist/web/assets/preload-helper-oLCrNCwz.js +1 -0
- package/dist/web/assets/{quality-Pu6EISAM.js → quality-RFd-7k3r.js} +1 -1
- package/dist/web/assets/release-notes-Bpdi6RdY.js +5 -0
- package/dist/web/assets/requestData-CbFxwW5w.js +1 -0
- package/dist/web/assets/routes-BIt8bExF.js +6 -0
- package/dist/web/assets/settings-CsCqF_1B.js +1 -0
- package/dist/web/assets/ui-BGK72r3u.js +1 -0
- package/dist/web/assets/workTarget-CySfKyfB.js +30 -0
- package/dist/web/index.html +4 -4
- package/docs/architecture.md +300 -36
- package/docs/development.md +60 -16
- package/docs/how-to-use.md +381 -28
- package/docs/installation.md +235 -144
- package/docs/publishing.md +1 -1
- package/lib/cli/agentsStatus.js +197 -0
- package/lib/cli/args.js +72 -8
- package/lib/cli/guide.js +27 -0
- package/lib/cli/guide.md +214 -0
- package/lib/cli/help.js +44 -6
- package/lib/cli/main.js +76 -20
- package/lib/cli/metricsCommands.js +77 -0
- package/lib/cli/output.js +12 -2
- package/lib/cli/project.js +13 -27
- package/lib/cli/qualityCommands.js +33 -8
- package/lib/cli/readOnly.js +15 -0
- package/lib/cli/requestCommands.js +21 -4
- package/lib/cli/requirementCommands.js +288 -0
- package/lib/cli/retroCommands.js +106 -0
- package/lib/cli/revisitCommands.js +73 -0
- package/lib/cli/showView.js +119 -6
- package/lib/cli/taskCommands.js +42 -16
- package/lib/cli/userConfig.js +47 -0
- package/lib/core/completionRefs.js +46 -0
- package/lib/core/metrics/definitions.js +434 -0
- package/lib/core/metrics/index.js +88 -0
- package/lib/core/metrics/manual.js +180 -0
- package/lib/core/ops.js +15 -2
- package/lib/core/preflight/carryover.js +5 -1
- package/lib/core/preflight/codexEngine.js +34 -17
- package/lib/core/preflight/diagnose.js +4 -9
- package/lib/core/preflight/engine.js +9 -0
- package/lib/core/preflight/hostPaths.js +260 -0
- package/lib/core/preflight/input.js +33 -5
- package/lib/core/preflight/instructions.js +18 -1
- package/lib/core/preflight/mockEngine.js +20 -2
- package/lib/core/preflight/render.js +22 -3
- package/lib/core/preflight/service.js +59 -9
- package/lib/core/preflight/uiRender.js +3 -0
- package/lib/core/requestOps.js +206 -14
- package/lib/core/retrospective.js +208 -0
- package/lib/core/reviewCandidates.js +56 -0
- package/lib/core/store/collection.js +20 -1
- package/lib/core/store/normalize.js +22 -4
- package/lib/core/store/preflightStore.js +19 -5
- package/lib/core/store/workspace.js +17 -1
- package/lib/core/taskReview/material.js +7 -0
- package/lib/core/taskReview/review.js +9 -2
- package/lib/server/api/manifest.js +51 -3
- package/lib/server/api/routes.js +131 -11
- package/lib/shared/acceptance.js +258 -18
- package/lib/shared/completionRecord.js +327 -0
- package/lib/shared/metrics.js +42 -0
- package/lib/shared/preflightInput.js +1 -1
- package/lib/shared/requirementSource.js +635 -0
- package/lib/shared/retrospective.js +286 -0
- package/lib/shared/reviewCandidate.js +308 -0
- package/lib/shared/reworkHistory.js +81 -0
- package/package.json +3 -2
- package/skills/p3/SKILL.md +9 -181
- package/dist/web/assets/ImprovementDialog-kQaVBGWH.js +0 -1
- package/dist/web/assets/Outputs-_nU_p3nu.js +0 -1
- package/dist/web/assets/RequestStatus-RG-OVQYY.js +0 -1
- package/dist/web/assets/Tabs-ew9i5SKX.js +0 -1
- package/dist/web/assets/TagInput-BtlJTF7i.js +0 -1
- package/dist/web/assets/TaskDrawer-DW8GyJqI.js +0 -6
- package/dist/web/assets/_requestId-6Nb727dD.js +0 -1
- package/dist/web/assets/_requestId-BykTgPax.js +0 -1
- package/dist/web/assets/appCtx-CxDdXABS.js +0 -1
- package/dist/web/assets/archive-Ckh295Xe.js +0 -1
- package/dist/web/assets/board-BVAIjK-Y.js +0 -1
- package/dist/web/assets/done-BGfA-3MA.js +0 -1
- package/dist/web/assets/draft-CfJeyLOl.js +0 -1
- package/dist/web/assets/index-CgRU744I.css +0 -2
- package/dist/web/assets/index-DacQ0yl4.js +0 -12
- package/dist/web/assets/new-DVygWvVc.js +0 -1
- package/dist/web/assets/outputs-B6xDsLZf.js +0 -1
- package/dist/web/assets/preflightInput-BAeEJYUK.js +0 -2
- package/dist/web/assets/preload-helper-DyCqp21K.js +0 -1
- package/dist/web/assets/release-notes-CCpzyiNf.js +0 -5
- package/dist/web/assets/requestData-D5vBnuMh.js +0 -1
- package/dist/web/assets/routes-Q91zvNc0.js +0 -4
- package/dist/web/assets/settings-BzRgcmUm.js +0 -1
- package/dist/web/assets/workTarget-C9c57JAO.js +0 -30
package/docs/development.md
CHANGED
|
@@ -31,7 +31,7 @@ pnpm typecheck
|
|
|
31
31
|
pnpm lint # oxlint(型情報も使う。下の「lint」)
|
|
32
32
|
pnpm test # ユニットテスト(vitest)。pnpm test:watch で監視
|
|
33
33
|
pnpm test:ui # ブラウザで画面を操作する UI テスト(ビルドした画面が要る。下の「UI テスト」)
|
|
34
|
-
pnpm check # 型検査 + lint + テスト + ビルド + UI テスト
|
|
34
|
+
pnpm check # ブラウザの確認 + 型検査 + lint + テスト + ビルド + UI テスト
|
|
35
35
|
pnpm demo:reset # デモデータ(.p3-demo/)を作り直す
|
|
36
36
|
pnpm verify:pack # 配布物を別の場所に入れて動かす(--docker で codex update と render も)
|
|
37
37
|
pnpm video # 使い方の動画を録り直す(.p3-video/p3-demo.mp4。下の「使い方の動画」)
|
|
@@ -58,16 +58,23 @@ pnpm video # 使い方の動画を録り直す(.p3-video/p3-
|
|
|
58
58
|
XDG_CONFIG_HOME=$TMP/cfg node <このチェックアウト>/bin/p3.mjs init --yes --agents --project sample --dir $TMP/data
|
|
59
59
|
# ルート・サブフォルダ・other/ のそれぞれで、スキルの一覧と場所を聞く(p3 は .agents/skills/p3/SKILL.md、other/ では出ない)
|
|
60
60
|
codex exec --ephemeral --ignore-user-config -s read-only "List every skill available to you with its SKILL.md path. Also quote what each skill root alias (r0, r1) maps to."
|
|
61
|
-
# $p3
|
|
62
|
-
codex exec --ephemeral --ignore-user-config -s read-only '$p3 Do not run
|
|
61
|
+
# $p3 を明示して、入口が最初に実行させるもの(pnpx @infodb/p3 guide --json)と、取れないときに止まることを引用させる
|
|
62
|
+
codex exec --ephemeral --ignore-user-config -s read-only '$p3 Do not run anything. Quote what the skill says to run first and what to do if that fails.'
|
|
63
63
|
```
|
|
64
64
|
|
|
65
|
+
スキルの frontmatter の `metadata`(入口の版 `p3-entry-version`)があっても一覧に出ることも、ここで確かめる。
|
|
65
66
|
個人のスキル(`~/.agents/skills`・`/etc/codex/skills`)と `~/.codex/config.toml` の `[[skills.config]]` に p3 が無いことを先に確かめる。
|
|
66
67
|
Codex がスキルを探す場所は公式の文書(<https://developers.openai.com/codex/skills/> の「Where Codex loads local skills」)
|
|
68
|
+
- 入口から手順を読む流れ(入口 → `pnpx @infodb/p3 guide --json` → `whoami --json`)を本物のエージェントが辿るかは、テストでは確かめ
|
|
69
|
+
られない。入口(`skills/p3/SKILL.md`・`agentsSnippet`)か `ENTRY_VERSION` を変えたときは、一時フォルダのプロジェクトに入口を置いて
|
|
70
|
+
Claude Code・Codex に p3 の作業(「進捗を見せて」など)を頼み、guide を読んでから whoami に進むこと、古い入口(前の全文のスキル)に
|
|
71
|
+
したときは `agents` の状態を人に伝えて自分で `p3 agents` を実行しないことを確かめる。入口は公開版(`pnpx @infodb/p3`)を呼ぶので、
|
|
72
|
+
`guide` を含む版を公開する前は guide が取れない(前の版にはコマンドが無い)。その間は「取れなければ p3 を操作せず、エラーと呼び方を
|
|
73
|
+
伝えて終える」ことだけを確かめ、取れたときの流れは公開した後に確かめる(版と結果はタスクの変更の記録に残す。確かめられなければ未検証と書く)
|
|
67
74
|
- 手元の対話エージェントの Preflight(`--prepare` / `--complete`)は、CLI と取り込みを別プロセスのテストで確かめる
|
|
68
|
-
(`test/localPreflight.test.ts`。PATH を空にして Codex・Docker・claude を呼べない状態で通す)。Claude Code
|
|
69
|
-
担当(`preflight.runner
|
|
70
|
-
契約は `test/agents.test.ts`、agent の親子の prepare → complete → drafts は `test/localPreflight.test.ts`
|
|
75
|
+
(`test/localPreflight.test.ts`。PATH を空にして Codex・Docker・claude を呼べない状態で通す)。Claude Code が入口のスキルから手順(`p3 guide`)を読んで
|
|
76
|
+
担当(`preflight.runner`)どおりに依頼を解釈するか、指示のファイルを読み切るかはテストでは確かめられない。担当で分けた手順の書き方の
|
|
77
|
+
契約は `test/agents.test.ts`、agent の親子の prepare → complete → drafts は `test/localPreflight.test.ts` が確かめる。手順(`src/cli/guide.md`)の Preflight の
|
|
71
78
|
節や指示の形を変えたときは、一時フォルダのプロジェクト(`init --agents claude --preflight-runner agent`)を Claude Code で開き、
|
|
72
79
|
親と子の要望を作って「要望 <ID> の Preflight をして」と頼み、prepare → 成果物 → complete → drafts まで進んで accept しないこと、
|
|
73
80
|
依頼の無い登録では始めないことを確かめる。`p3 config set preflight.runner=codex` に変えて、「Preflight して」とだけ頼むと聞き返すこと、
|
|
@@ -94,12 +101,15 @@ pnpm video # 使い方の動画を録り直す(.p3-video/p3-
|
|
|
94
101
|
`test/ui/*.ui.test.ts` は、ブラウザ(Playwright の Chromium headless shell)で `p3 serve` のビルドした画面を開いて操作する。
|
|
95
102
|
設定は `vitest.ui.config.ts` で、通常の `pnpm test` には入らない。型検査・lint の対象には入る。
|
|
96
103
|
|
|
97
|
-
- `pnpm check`
|
|
98
|
-
|
|
99
|
-
|
|
100
|
-
|
|
101
|
-
|
|
102
|
-
|
|
104
|
+
- `pnpm check` は、最初(型検査の前)に `pnpm check:browser`(`scripts/check-browser.ts`)で Chromium を起動してみる。実行ファイルが
|
|
105
|
+
無い・起動できないなら、理由と入れ方を出してそこで止める(コンテナを作り直して消えたことに、単体テストとビルドを待たずに気づくため。
|
|
106
|
+
`pnpm check` では UI テストを飛ばさない)。続けて型検査・lint・テスト・ビルドの後に `pnpm test:ui` を流す。単独で流すときは先に
|
|
107
|
+
`pnpm build` する(ビルドが無ければ、Chromium の有無によらず失敗にする)
|
|
108
|
+
- Chromium は `pnpm exec playwright-core install chromium-headless-shell` で入れる(自動では入れない)。`pnpm test:ui` を単独で流した
|
|
109
|
+
ときは、Playwright が起動する実行ファイル(既定のキャッシュか `PLAYWRIGHT_BROWSERS_PATH`)が無いときだけ、理由と入れ方を出して
|
|
110
|
+
UI テストを飛ばす(件数は vitest の skipped に出る)。実行ファイルがあるのに起動できない(共有ライブラリが無いなど)・サーバが起きない・操作の対象が
|
|
111
|
+
見つからないときは失敗にする(判定は `test/ui/chromium.ts`、本物の Chromium を使わない確認は `test/uiHarness.test.ts`)。
|
|
112
|
+
共有ライブラリが無いと出たら `pnpm exec playwright-core install-deps chromium-headless-shell` で入れる
|
|
103
113
|
- シナリオごとに一時のフォルダを作り、その中に HOME・個人設定(`XDG_CONFIG_HOME`)・git リポジトリ・データを置いて、本物の CLI
|
|
104
114
|
(`bin/p3.mjs init`・`serve`)で動かす(`test/ui/env.ts`)。子の p3 には親の `P3_*`・`INIT_CWD`・`GIT_*`・`XDG_*` を渡さず、
|
|
105
115
|
Mock のエンジン・変更者・cwd を明示する。手元の個人設定・プロジェクト・`.p3-demo/` には触れない。`p3 serve` は 127.0.0.1 の
|
|
@@ -119,6 +129,10 @@ pnpm video # 使い方の動画を録り直す(.p3-video/p3-
|
|
|
119
129
|
末尾に届くことを測る。進捗・新しい要望・設定の3つのタブ・リリースノート・タスクボード・対応済みは、文書と上のナビゲーションとタブ(設定・リリースノートの tablist)が縦に
|
|
120
130
|
送れないことだけを測る。測るのは名指しした要素(文書・`main`・本文・タブ・上のナビゲーション・実行ログ)の送れる量で、すべての要素を数えはしない。ほかの局所スクロールの
|
|
121
131
|
中身や、通知(再読み込みの失敗・外での削除)が出ているときの高さは測らない
|
|
132
|
+
- 文字の大きさと拡大(`test/ui/readability.ui.test.ts`): 下の「画面の文字と余白」の確認する画面を、幅 1280(明るい)と 375(暗い)で開き、
|
|
133
|
+
見えている文字の計算済みの大きさ(本文・見出し・操作は 16px 以上、補助の情報は 14px 以上。`test/ui/layout.ts` の `fontProblems`)と
|
|
134
|
+
横のはみ出しを測る。200% の拡大は CSS の幅 640×450 で同じ画面を開いてはみ出しを測り、新しい要望(タイトル → 作成)・設定(プロジェクト名 →
|
|
135
|
+
保存 → 元に戻す)・タスクの詳細(入力 → 保存)にキーボード(Tab)で届き、届いた操作が画面内に見えることを確かめる
|
|
122
136
|
- 限界: 画像の比較はしないので、色・重なり方・文字の欠けなど、測っていない見た目の乱れは保証しない。測るのは上の画面・幅・テーマだけ
|
|
123
137
|
- 日本語のフォント: Noto Sans CJK JP があれば、ブラウザを使い方の動画と同じ fontconfig(`scripts/fonts-ja.conf`)で起こし、寸法を
|
|
124
138
|
日本語のフォントで測る(無い環境では既定のフォントのまま測り、そのことを出す。飛ばしはしない)
|
|
@@ -181,6 +195,7 @@ suspicious カテゴリの一括(JSX で要らない `react-in-jsx-scope` な
|
|
|
181
195
|
src/ 依存の向き: shared ← core ← server / cli、web → shared(test/layers.test.ts で確かめる)
|
|
182
196
|
shared/ 型定義・参照の解き方・日付・判定(core と画面の共通。I/O と node: は使わない)
|
|
183
197
|
cli/ p3 CLI(core でファイルを直接操作。serve でサーバも起動する)
|
|
198
|
+
guide.md AI 向けの作業の手順の原本(p3 guide が返す。ビルドで lib/cli/ に写す)
|
|
184
199
|
main.ts 振り分け・プロジェクトと変更者と今の要望の決定・終了コード
|
|
185
200
|
taskCommands.ts / requestCommands.ts / preflightCommands.ts コマンドの種類ごと(変更は core/requestOps.ts を通す)
|
|
186
201
|
args.ts / output.ts / help.ts 入力の解釈・出力・p3 help
|
|
@@ -199,7 +214,7 @@ src/ 依存の向き: shared ← core ← server / cli、web →
|
|
|
199
214
|
routeTree.gen.ts ルート一覧(自動生成)
|
|
200
215
|
components/ 部品(複数のページで使うもの。大きいページの部品は components/<ページ>/)
|
|
201
216
|
bin/p3.mjs CLI の起動口(チェックアウトでは tsx でソースを、配布物ではビルドした lib/ を動かす)
|
|
202
|
-
skills/p3/SKILL.md AI
|
|
217
|
+
skills/p3/SKILL.md AI 向けの入口のスキルの原本(p3 init --agents / p3 agents で .claude/skills・.agents/skills の選んだ先に写す。本文は p3 guide から読ませる)
|
|
203
218
|
scripts/ デモデータ・配布物の確認・使い方の動画(video/)
|
|
204
219
|
docs/ 導入・使い方・開発・設計・公開の文書
|
|
205
220
|
test/ ユニットテスト
|
|
@@ -212,6 +227,25 @@ test/ ユニットテスト
|
|
|
212
227
|
|
|
213
228
|
規則を足すときに直す場所は [docs/architecture.md](architecture.md) の「規則の置き場所」。
|
|
214
229
|
|
|
230
|
+
## 画面の文字と余白
|
|
231
|
+
|
|
232
|
+
文字を小さくして詰め込まない。狭い幅でも文字は縮めず、折り返す・行を高くする・局所スクロールにする。
|
|
233
|
+
|
|
234
|
+
| 用途 | 大きさ | 例 |
|
|
235
|
+
| --- | --- | --- |
|
|
236
|
+
| 本文・フォームの見出し・主な操作 | 16px 以上(`text-base`。基底の大きさ) | 説明の文、一覧の題、表のセル、ボタン・リンク・入力、`Field` の見出し |
|
|
237
|
+
| 見出し | 本文より大きく(`Section` は `text-lg`、ページは `text-xl` / `text-2xl`) | 区切りの見出し、詳細・ダイアログの題 |
|
|
238
|
+
| 補助の情報 | 14px 以上(`text-sm`)。要素に `data-aux` を付けるか等幅(`font-mono`) | ID・日時・件数・バッジ(`Badge`・ステータスの札)・パス・入力の下の補足(`Field` の hint) |
|
|
239
|
+
|
|
240
|
+
- 12px 以下(`text-xs`・`text-[10px]` など)は文字に使わない。記号だけの印(✓ など、文字を持たない装飾)は例外
|
|
241
|
+
- 主な説明に淡い色を使わない。明るいテーマの説明・補足は `text-slate-500` 以上の濃さ(`text-slate-400` は暗いテーマ用)。フォームの見出しは
|
|
242
|
+
`text-slate-700`(暗いテーマは `text-slate-300`)
|
|
243
|
+
- 補助の情報を本文の要素(p・li・label・button など)の中で 14px にするときは `data-aux` を付ける(UI テストが本文と区別する)
|
|
244
|
+
- 狭い進捗の要望名も本文として 16px で、2行まで折り返す(行の高さは2行とステータスの段が入るように決める。`routes/index.tsx` の `ROW_H`)
|
|
245
|
+
- 全体の CSS で大きさを強制的に上書きせず、部品ごと・用途ごとに上の大きさを選ぶ
|
|
246
|
+
- 確認する画面: 進捗・新しい要望・要望の概要と Preflight の案・タスクボードとタスクの詳細・設定(プロジェクト・品質基準)・リリースノート
|
|
247
|
+
(マイルストーン・レビュー)。幅 375 / 1280・明暗のテーマ・200% の拡大で、はみ出しと操作への到達を確かめる(上の「UI テスト」)
|
|
248
|
+
|
|
215
249
|
## npm で配る中身
|
|
216
250
|
|
|
217
251
|
`@infodb/p3` として npm に公開する(公開そのものは人が行う。手順は [docs/publishing.md](publishing.md))。画面と CLI・serve を
|
|
@@ -261,6 +295,14 @@ P3_CODEX_PATH_MAP=/workspaces=/home/me/workspaces node scripts/verify-docker.mjs
|
|
|
261
295
|
serve になること。本物の Codex(ソケット・pathMap・ChatGPT の接続)での Preflight・画面資料・要約の生成は、このスクリプトでは
|
|
262
296
|
確かめない(接続できる環境で手で確かめ、結果を PR に残す。Mock の成功で代わりにしない)。
|
|
263
297
|
|
|
298
|
+
マウントするパスの自動の決め方(`src/core/preflight/hostPaths.ts`)は `node scripts/verify-host-paths.mjs` で本物の Docker で
|
|
299
|
+
確かめる。このマシン(DevContainer など)と、Dockerfile から作ったイメージ(中と外で違うパスの bind 2つ・名前付きボリューム・
|
|
300
|
+
ソケット・コンテナの名前と違うホスト名)の両方で、`codex.pathMap` の無い使い捨ての個人設定の p3 が、`p3 user-config paths` で
|
|
301
|
+
自分のコンテナを確かめてパスを決めること、bind の下の原稿を `p3 render` で PNG にすること、volume の下・コンテナの中だけの原稿・
|
|
302
|
+
繋がらない `DOCKER_HOST` では描画のコンテナを起こさずに止まること(`docker events` で数える)を確かめる。`--work` は Docker の
|
|
303
|
+
ホストから見える(bind の下の)フォルダ(既定はこのリポジトリの親)。本物の Codex の Preflight は ChatGPT のプランを使うので
|
|
304
|
+
このスクリプトでは動かさず、人が `codex.pathMap` を外した状態で `p3 preflight` を実行して確かめる。
|
|
305
|
+
|
|
264
306
|
## 使い方の動画
|
|
265
307
|
|
|
266
308
|
一般公開する使い方の動画(日本語の字幕、約3分)は `pnpm video` で録り直す(`scripts/video/record.mjs`)。機能や画面を
|
|
@@ -286,8 +328,8 @@ serve になること。本物の Codex(ソケット・pathMap・ChatGPT の
|
|
|
286
328
|
|
|
287
329
|
| 文書 | 書くこと |
|
|
288
330
|
| --- | --- |
|
|
289
|
-
| [README](../README.md) |
|
|
290
|
-
| [docs/installation.md](installation.md) |
|
|
331
|
+
| [README](../README.md) | 何をするツールか・必要なもの・最短の手順(参加して画面を開くまで)・次にできること・文書の案内だけ |
|
|
332
|
+
| [docs/installation.md](installation.md) | 導入を段階の順に(段階 0: 参加・作成と画面、段階 1: Preflight の準備(Docker・パスの対応・ChatGPT・Codex のイメージ)、段階 2: 任意の機能への入口)。つまずいたとき・マシンごとの設定・Docker で動かす。段階 0 に段階 1 以降の準備を混ぜない(`test/docs.test.ts`)。段階 2 の機能の操作は使い方ガイドに書き、ここからはリンクする |
|
|
291
333
|
| [docs/how-to-use.md](how-to-use.md) | 使い方の手順とリファレンス(操作・状態・データ・画面・CLI) |
|
|
292
334
|
| [docs/architecture.md](architecture.md) | 設計と規則(なぜそうするか・どこで守っているか) |
|
|
293
335
|
| [docs/chatgpt-sign-in.md](chatgpt-sign-in.md) | ChatGPT のサインインの設計 |
|
|
@@ -296,4 +338,6 @@ serve になること。本物の Codex(ソケット・pathMap・ChatGPT の
|
|
|
296
338
|
|
|
297
339
|
同じ説明を複数の文書に書かない(片方からリンクする)。確認作業の記録(どの幅・どのブラウザで確かめたか)は文書に書かず、
|
|
298
340
|
PR とタスクの変更の記録に残す。CLI のヘルプ(`src/cli/help.ts`)・API の説明(`src/server/api/manifest.ts`)は入口が変わったとき、
|
|
299
|
-
AI
|
|
341
|
+
AI の手順が変わったときは手順の原本 `src/cli/guide.md`(`p3 guide` が返す)の1か所を直す。置く入口(`skills/p3/SKILL.md` と
|
|
342
|
+
`src/cli/project.ts` の `agentsSnippet`(`AGENTS_SNIPPET`))は、入口に書くこと(呼び方・読み込みの約束)を変えたときだけ両方を直し、
|
|
343
|
+
`src/cli/guide.ts` の `ENTRY_VERSION` を上げる(手順の本文だけの改訂では上げない。`test/agents.test.ts` が確かめる)。
|