memory システムの活用: 教訓をどう残しているか
📌 記事の取り扱いについて（公開当時の内容を含みます — タップで詳細）
本記事は公開当時の体験・気づきをまとめたものです。現在のツール数・プラン数・対象年齢・記事数・仕様とは異なる場合があります。最新の内容は各ツールページをご確認ください。ツールや外部サービスの仕様・料金は変更されることがあるため、利用前には各公式情報も併せてご確認ください。記載に誤りを見つけられた場合はお問い合わせフォームよりご連絡いただけると助かります。
ツール工房.ai の開発で地味に効いているのが、相棒のツールが自分で書き残していくメモの活用です。（私が作業ルールを書いておくメモとは別に、相棒側が「作業中に分かったこと」を残していく仕組みがあります。この記事で扱うのは後者のほうです。）
同じ失敗を二度繰り返さないために、教訓やルールを短いメモとして残し続けています。
結論から言うと、「気付いたその瞬間に、1ファイル1テーマで短く残す」が一番運用しやすい、というのが現時点の手応えです。
どんなときにメモを残しているか
メモを残すトリガーは、同じミスを2回やってしまったとき、公式情報と自分の理解がズレていたとき、長時間ハマったとき、ルール化したい運用方針が見えたとき、別のプロジェクトでも再利用できそうな知見、のいずれかです。
逆に「成功したけど一度きり」や「軽微な好み」はメモにしません。ストックは増えるほど検索性が落ちるので、本当に再発防止・再利用に値する話だけを選ぶようにしています。
1ファイル1テーマで短く書く
失敗からの学びにあたるメモは、できるだけ1ファイル1テーマで短く書いています。
1ファイルに複数の話題を混ぜると、検索したときに「他の話に埋もれる」ので、結果として読み返されません。
書き方の型は、次の順番です。
- 何が起きたか
- なぜ起きたか
- どう対処したか
- 次に取るべき行動
長くても画面1〜2スクロール分。長文で書くと結局読み返さないからです。
カテゴリで命名すると検索しやすい
ファイル名の先頭に、種類が分かる目印（接頭辞）を付けて揃えています。
feedback_（失敗からの学び）project_（特定プロジェクトの固有事情）reference_（公式仕様の要点）user_（自分のこと・役割や好み）
目印を揃えておくと、相棒のツールがいまの作業内容に応じて「このタスクなら feedback_ を見に行く」と判断しやすくなる感触があります。なお、これは相棒のツール側の決まりではなく、私が勝手に決めた分類です。実際の入口は、最初に読まれる目次のファイルで、そこから必要なメモをたどる形になっています。
教訓メモの実例
たとえば「公式ページの割引前/割引後を見極める手順」というメモがあります。
スマホ料金比較ツールを作っているとき、相棒が「割引後の安い金額を、割引前の通常料金だと取り違えて表示する」事故が何度かありました。
原因は、ページ上で割引後の金額に色が付いているのですが、機械的に読むときには色情報が失われるためです。
「重要な料金は、元のページの見出しや注意書きまで確認し、必要なときはページの裏側にある色分けの目印まで見る」という対処手順を書き残しました。その後も同じ取り違えの候補は出てきていますが、反映する前に気づいて止められるようにはなりました。
残してはいけないものもある
メモには「パスワードや鍵の実物」「気分で書いた感想」は残さないようにしています。公開前の運用の話を書くことはありますが、それが公開する文章に混ざらないよう、ときどき点検するという形です。
何度も参照される性質上、別の作業のときに急に呼び出される可能性があります。そのときに「これは公開系の作業で読み出してほしくないな」と思うものは、最初から残さないか、置き場所を分けるようにしています。
定期的に整理する
メモは増えすぎると逆に検索しづらくなります。
ときどき棚卸しをして、古くなった説明を直したり、目次を短くまとめ直したりしています。
完璧な整理を狙うのではなく、「明らかに不要なものだけ取り除く」軽い掃除で十分です。
残しておいて良かった、と感じる瞬間
メモを残しておいて一番嬉しかったのは、しばらく経ったころの自分が同じ問題にぶつかったときに、メモのおかげで短時間で解決できた瞬間です。
個人開発は同じテーマを毎日触り続けるわけではありません。間が空くと、前回どこで詰まったかを綺麗に忘れます。
そこで助けてくれるのが、過去の自分が残した短いメモです。
地味で派手さはない作業ですが、長期戦になる個人開発では、こうした記憶のインフラを育てていくことが意外と効いてきます。
残すコストは数分、未来の自分への投資としては破格に安い、という感覚で日々書き足しています。
← 他の制作記を見る ｜ トップ ｜ お問い合わせ