書架 超魔導 目次

次の変更を出すまで

一人が何をしたら完了か

また関連記事カードを追加するなら、今度は依頼を「記事の途中にカードを出して」で終えない。スマホで本文を読んでいる人が、置いた一枚に気づき、押したら対応する記事を開けるところまでを、一回の変更として書く。記事データが空のときに何を表示するかも先に決める。

自分の仕事でAIに実装を頼むたび、先にこういう条件を揃える時間を取り直すようになった。手順の名前は開発現場によっても違う。私が見たいのは、作る前に誰が何を決め、出来上がったときに同じ条件で開けるかだ。1

関連記事を一枚だけ追加するときの依頼例

読み手はスマートフォンで記事の途中まで読む。本文を邪魔しない位置に関連記事を一枚出す。押すと、表示したタイトルと同じ記事の正規URLを開く。該当する記事がなければ、本文の間に空欄を作らない。確認に使った記事URLと結果を、変更と一緒に残す。

見るものを先に三つ用意する

前の章で壊れたのは、読者がブラウザで受け取ったファイルだった。だから今回は、テストに通ったソースに加えて、公開用に作ったビルドを開く。読者が使う操作を一つずつ実行し、スマホの画面も見る。予定していた変更が出せなければ、どの状態まで戻すかも先に決めておく。

時点私が確かめたいこと
依頼前誰が、どのページを開き、何ができれば完了か
公開前配布用のビルドでその操作が通り、データがない場合も読めるか
公開後実際のURLで同じように操作でき、失敗時に戻す先があるか

時間を戻す場所を残しておく

AIにコードを書いてもらう時間が短くなった。そこで余った時間は、確認する対象を増やすために使える。たとえば新しいカードをデプロイしたあと、記事を開き、実際にカードを押して、元の記事へ戻る。公開したURLを記録しておけば、直してもう一回出したとき、同じ操作をもう一度試せる。

使う人と同じ入口で、自分でも一度操作する。そのために、作り始める前から配布後の画面まで、どこを誰が受け持つかを決める。AIにはそれを伝えてから実装を頼む。

あとがきへ

脚注

  1. 『AI開発でウォーターフォールに帰った話』。 ↩