======================================================================== 3画面パック ― ポータル / PM / SW 仕事の「いまどこ」と「やり方」を、2枚の画面で見えるようにする一式 ======================================================================== これは説明書ではありません。 あなたの右腕（社内で動かしている AI エージェント）に渡す「仕様書」です。 右腕にこの一式を読ませると、あなたの会社の環境に同じ3画面ができます。 ------------------------------------------------------------------------ 何ができるか ------------------------------------------------------------------------ PM（案件のかんばん） いま案件が何件あり、どこに居て、次に何をするか。 そして「手が止まっているもの」が赤く出ます。 SW（仕事の型の升目） どの仕事が、もう人に渡せる形になっているか。 塗り絵のように埋まっていきます。 ポータル（デスク） 記録・調査・渡した成果物を置く棚。 型の「中身」はここにあります。 ひとことで言うと ―― PM が動かし、SW が数え、デスクが中身を持つ。 ------------------------------------------------------------------------ ★ すでに Wiki を使っている場合（いちばん大事なところ） ------------------------------------------------------------------------ いまの Wiki は、捨てません。 Wiki こそが「デスク（＝中身を持つ場所）」そのものです。 3画面は、その上に「動かす板（PM）」と「数える升目（SW）」を 足す、という話です。 進め方は、この3つの順です。 複製する → 並行で動かす → 問題が無ければ引っ越す 元の Wiki は読み取り専用のまま残し、複製した側で作ります。 最初から引っ越しを前提に、その準備をしながら進めます。 そして、見た目だけ作りかけた画面があるなら、それは使いません。 部分的に足すと、ヘッダーの不揃いとリンク切れが増えるだけです。 ゼロから作り直します（手順は 10_implementation.md）。 ------------------------------------------------------------------------ 入っているもの ― 3つの束で読ませます ------------------------------------------------------------------------ ① 何を作るのか 09_requirements.md 要件定義 ★ 最初にこれを読ませる 解く問題／既存 Wiki との関係／やらないこと／ 機械で判定できる受入条件 B1〜B10 ② どういう形にするのか 00_structure.md 構造と3画面の役割 01_data.md 表9枚の仕様（列ごと） 02_pm.md PM 画面の仕様 03_sw.md SW 画面の仕様 04_portal.md ポータルの仕様と、言葉の決め 05_build.md 作り方と、確かめ方（合格条件つき） ③ どう進めるのか 10_implementation.md 実装指示。ゼロから作り直す手順（段1〜段8） 共通ヘッダーの仕様／並行運用の判断表／ やってはいけないこと／人に聞くこと 06_portal_minimum.md （旧）当日の応急処置。作り直すなら 10 を見る data/ 表の雛形 CSV 10枚（9表＋辞書）と schema.sql ※ 中身はサンプルです。差し替えて使ってください ※ person.csv と invoice.csv はヘッダー行のみ（空） ------------------------------------------------------------------------ 渡し方 ― 3手 ------------------------------------------------------------------------ 【1手目】 この一式を、右腕が読める場所に置く 解凍して出てきた pmsw-pack/ のフォルダごと、 右腕の作業フォルダに置きます。 作業フォルダ/ pmsw-pack/ 09_requirements.md ← ① 最初に読ませる 00_structure.md 01_data.md 02_pm.md 03_sw.md 04_portal.md 05_build.md ← ② 形 10_implementation.md ← ③ 作り直す手順（段1〜段8） 06_portal_minimum.md （旧） 07_comment_req.md （あとで足す） 08_comment_spec.md （あとで足す） data/ ... （CSV 10枚 ＋ schema.sql） 【2手目】 右腕に、最初の1言を渡す 下の枠の中を、まるごとコピーして、そのまま貼ってください。 書き換えるところはありません。 ┌──────────────────────────────────────────────────────────────┐ pmsw-pack/ に、3画面（ポータル / PM / SW）の仕様が入っています。 次の順で、8枚とも読んでください。 09_requirements.md → 00_structure.md → 01_data.md → 02_pm.md → 03_sw.md → 04_portal.md → 05_build.md → 10_implementation.md 前提を2つ、先に伝えます。 ・いま作りかけの画面は使いません。ゼロから作り直します。 ・いまの Wiki は捨てません。複製して、そちらで作ります。 元の Wiki は読み取り専用のまま残します。 読み終えたら、まだ何も作らずに、次の4つだけ私に報告してください。 1. この3画面が、それぞれ何のためのものか。あなたの言葉で。 2. 「人が直す場所」は、どこだと書いてありましたか。 3. 10_implementation.md の段1をやって、いまの Wiki の一覧表を 出してください。（この段では、ファイルを1つも書き換えないこと） 4. うちの会社に当てはめたとき、data/area.csv と data/stage.csv に 何を書けばよさそうか。あなたの案を、表で出してください。 （サンプルの中身は、そのまま使わないでください） 仕様の中で意味が分からないところ、私に確認しないと決められない ところがあれば、工夫して先へ進まず、そこで止めて聞いてください。 止めて聞くべきことの一覧は、10_implementation.md の10節にあります。 └──────────────────────────────────────────────────────────────┘ 【3手目】 返ってきた案を、あなたが直す 3つ目の「領域と工程の案」が、この仕組みのいちばん大事なところです。 あなたの会社の言葉に直してください。 きれいな分類を作る必要はありません。 いま実際にやっている仕事のまとまりで切ってください。 ここが決まったら、右腕にこう言えば先へ進みます。 この形でいきます。10_implementation.md の段2から段6まで 進めてください。段ごとに「終わりの印」を出してから次へ。 そのあと 09_requirements.md の受入条件 B1〜B10 を実際に 実行して、出力をそのまま見せてください。 ------------------------------------------------------------------------ ★ 出来たと言われたら、これだけは見てください ------------------------------------------------------------------------ 「HTTP 200 が返りました」「エラーはありませんでした」は、 出来たことの証拠ではありません。 次の2つを、必ず見せてもらってください。 (1) 受入条件 B1〜B10 の、実際の出力 09_requirements.md の第8節にあります。 「確認しました」だけの報告は受け取らないでください。 特に B4（元の Wiki が1文字も変わっていない）と B3（3画面のヘッダーが同一）は、必ず出力で見てください。 (2) わざと壊した CSV を1回食わせて、止まったこと 検査があることと、検査が効いていることは別です。 壊しても通ってしまうなら、検査は入っていません。 ------------------------------------------------------------------------ ★ 最初に必ず知っておいてほしい、3つの決めごと ------------------------------------------------------------------------ 1. 画面を直しても、意味がありません PM と SW は「生成物」です。表（CSV）から機械が作り直します。 画面を直しても、次に作り直した瞬間に消えます。 直す場所は、表だけです。 2. 型は、先に作りません SW の升目が空っぽなのは、正常な状態です。 案件を1件回して、通った工程の型だけが、通ったぶんだけ埋まります。 空の升目を埋めるために、仕事の無い手順書を書き起こさないでください。 やった瞬間に、この画面は「宿題リスト」になって、見られなくなります。 3. 止めている案件は、警告しません 「決めて止めている」のと「忘れている」のは、別ものです。 いつまで待つかを書いた案件は、鳴りません。 決めていない案件だけが鳴ります。 こうしないと、毎日どれかが赤くなって、板を見るのが苦痛になり、 やがて誰も見なくなります。見ない板は、無いのと同じです。 ------------------------------------------------------------------------ 3画面ができたあとの、次の1歩（07 / 08） ------------------------------------------------------------------------ 07_comment_req.md コメント機能の要件定義 08_comment_spec.md コメント機能の仕様書 Wiki のページの下に「ひと言」を書く欄を付けて、書いたものが Discord に飛び、右腕が気づいて動く——という仕組みの仕様です。 3画面とは別の作りものなので、00〜06 と同時にやらないでください。 3画面が見えるようになってから、この2枚を右腕に渡します。 ------------------------------------------------------------------------ これは実験です。正解ではありません ------------------------------------------------------------------------ この形が良いという証拠は、まだありません。 合わないところは、右腕に言って直させてください。 ただし、直したら「何を、なぜ変えたか」だけ、どこかに残してください。 変えすぎたときに戻せます。 ========================================================================