再現条件がはっきりしないログイン障害を調べています。手元にはスクリーンショット、テスターからの報告、いくつかの仮説があります。資料を入れるフォルダーを決める前に、「長時間離れた後のログイン失敗を調べる」というアクションを作りましょう。解きたい疑問が、ノートの出発点になります。
アクションを起点にノートを書くとは、観察と決定を、それが役立つ仕事と一緒に残すことです。この記事は架空の調査を使い、観察や修正も例として示します。仕事の進展に合わせて、同じノートがどう変わるかを見ていきます。
疑問と完了条件から始める
最初のノートには、何を知りたいか、何が進展になるかを書きます。原因、すべての作業分解、恒久的な分類を最初から決める必要はありません。
報告：テスターが翌朝、開いたままのタブに戻ると最初のリクエストが失敗した。ログインし直すと成功する。
不明な点：ブラウザ、離れていた時間、アカウントのどれに依存するのか？
完了条件：問題を再現し、原因を説明し、失敗する条件に対して修正を検証できること。
次にすること：おおよその放置時間と、タブを開いたままにしていたかを聞く。
完了条件があれば、「ログインの調査」が認証記事を際限なく集める作業になるのを防げます。資料は、この疑問に答えるか、次の実験を選ぶ助けになるものを残します。
原因を決める前に、起きたことを記録する
翌日、いくつかの条件を試しました。「一晩放置すると失敗した」は観察で、「ブラウザのキャッシュが壊れている」は仮説です。両方を事実として書くと、その後の調査が難しくなります。
- 新しくログイン：最初のリクエストは成功する。
- タブを一晩放置：テスト環境で最初のリクエストが失敗する。
- 現在の仮説：タブが期限切れのセッション状態を再利用している可能性がある。未確認。
- 次の確認：失敗時のリクエストとセッションの時刻を調べる。認証情報をノートにコピーせず、アクセス制限のある診断記録へリンクする。
ありそうな原因を除外できた実験は、成功しなかったものも残しましょう。実験の横に短い結果を添える方が、説明のないリンク集より役立ちます。
未解決の疑問を、次のアクションにする
「セッション期限切れの処理を確認する」は、具体的な作業になりました。ActionDrivenNoteではサブアクションを作り、親のアクションのノートに調査全体を残せます。サブアクションには「期限切れセッションで障害を再現し、アプリの動作を記録する」という完了条件を付けます。
個別の時間や進捗管理が必要な確認は、独立したアクションにします。小さな観察はノートの一行で十分です。タスク一覧を増やしすぎず、未完了の仕事を見える状態にできます。
判明したこと：この例では、タブが期限切れセッションを再利用し、リクエストの失敗後も復旧していなかった。
変更：該当の応答を受けたら古い状態を消し、ログイン画面へ戻す。
検証：期限切れの条件を再試行し、有効なセッションでも正常に動くことを確認する。テストしたビルドと結果へのリンクを残す。
未確認：別のブラウザでも同じ経路を試す。この条件はまだ検証済みとしない。
結果が役立つようになってから、残す場所を決める
ノートには再利用できる説明ができました。「認証」などのテーマがあれば、後から探しやすくなります。最初はアカウント、ブラウザ、セッションのどの問題か不明でした。分類を待つことで、未検証の推測に基づいて整理せずに済みます。
最初の観察も結論と一緒に残してください。詳しい選び方は、タスク完了後に何を残すかをご覧ください。
不確かな仕事をひとつ選んで試す
この方法は、進めるうちに内容が変わる調査、提案、研究、執筆に向いています。定型のリマインダーはタイトルと日付だけで十分かもしれません。完成した参考マニュアルは文書ライブラリーに置けます。
疑問：何を解決したいか？
完了条件：どんな結果があれば終えられるか？
わかっていること：観察とその出典。
確認が必要なこと：仮定と未解決の疑問。
次のアクション：不確実さを減らす一歩。