https://tech.feature-branch.co.jp/tags/%E3%83%8A%E3%83%AC%E3%83%83%E3%82%B8%E5%85%B1%E6%9C%89/Recent content in ナレッジ共有 on Feature Branch Tech BlogHugojaFeature Branch inc.Mon, 06 Jul 2026 18:48:25 +0900https://tech.feature-branch.co.jp/posts/2026/04/work-with-ai/Thu, 02 Apr 2026 00:00:00 +0900https://tech.feature-branch.co.jp/posts/2026/04/work-with-ai/<h1 id="aiと和解する">AIと和解する</h1> <h2 id="はじめに">はじめに</h2> <ul> <li>AIとはなんぞや？AIにコーディングさせても効率落ちるのでは？という印象をもっていた古いエンジニアが、AIと仲良く仕事できるようになっていく過程で感じたことや今後AIと仕事をしていくうえで何を気にしながらやり取りしていこうとしているかを共有したいと思います。</li> </ul> <h2 id="1-怪訝期-こいつ何者">1. 怪訝期 〜こいつ何者？〜</h2> <ul> <li>こちらが実現したいことを伝えても期待通りには捉えてくれないんでしょう？</li> <li>AIに任せても手直しが必要になって、余計に時間がかかるんでしょう？</li> <li>実装はできたとしてもスパゲッティコードになって解読に苦労するんでしょう？</li> <li>ドキュメントを作らせても正確でなく読みづらい文章になるんでしょう？</li> <li>依頼するにも何を任せていいのかがわからない</li> </ul> <p><img src="./images/kegen.png" alt="怪訝期"></p> <h2 id="2-受入期-ちょっと抜けてるけどいい仕事する">2. 受入期 〜ちょっと抜けてるけどいい仕事する〜</h2> <ul> <li>あいまいな質問をしても答えてくれるし、自分でWeb検索して探すより情報収集が早い</li> <li>設計の相談をすると自分が気付いていなかった視点で方式を提案してくれる</li> <li>設計変更やバグ等で現状分析すると、自分で調べるよりはるかに早く分かりやすい結果を返してくれる</li> <li>実装してもらうと不要なコードが残ったり書き方が分かりづらい部分があるなぁ</li> </ul> <p><img src="./images/ukeire.png" alt="受入機"></p> <h2 id="3-和解期-何をお願いしてもこなしてくれる">3. 和解期 〜何をお願いしてもこなしてくれる〜</h2> <ul> <li>関連する複数ファイルを変更しなればならない場合も人が書くより全然速いし的確</li> <li>あいまいな方針から壁打ちで具体化していき細部まで決まれば実装が正確</li> <li>面倒なテストケースの作成もまとめて実施してくれるしアサーションも意味あるものになっている</li> <li>やたらと処理を細分化しようとするけどそれが標準だよなぁ</li> </ul> <p><img src="./images/wakai.png" alt="和解期"></p> <h2 id="4-信頼期-適切な指示で後はお任せ">4. 信頼期 〜適切な指示で後はお任せ〜</h2> <ul> <li>スタートさえ間違わなければ実装はほぼ任せてしまえる</li> <li>成果物のチェックは、一通り行うがざっくりと違和感を探す程度</li> <li>全て依存するのではなく細かいミスは手直しすれば無駄な時間を省ける</li> <li>0.5~0.6人分くらいの作業はAIでこなせる</li> </ul> <p><img src="./images/shinrai.png" alt="信頼期"></p> <h2 id="5-信頼はしているけれど">5. 信頼はしているけれど&hellip;</h2> <ul> <li>設計・実装ではインプットを曖昧にしない <ul> <li>最初のインプットを曖昧にしても壁打ちを繰り返すことで求める結果に辿り着くかもしれないが作業短縮効果が薄れる</li> <li>具体化できている部分をその通りに伝えることでより正確な分析をしてくれるので、結果も速く正確になる</li> </ul> </li> <li>成果物イメージを持つことをサボらない <ul> <li>自分の中で成果物のイメージがあると、想定と違う≒間違いを検出できる</li> <li>AIの間違いでなくとも、自分の間違いに対してその対応で問題ないかのチェックができる</li> </ul> </li> <li>自分が分からないことを任せない <ul> <li>成果物が正しいのか判断できなければ成果物として成り立たない</li> <li>分からないなら分かるまで壁打ちしたから目的の成果物作成を任せる</li> </ul> </li> </ul> <h2 id="6-ただ裏では">6. ただ裏では</h2> <p>ここまでAIを信頼できる状態になっているのは、単にAIの進化だけが要因ではない。 裏で有識者がAGENTS.mdの調整や適切なSkillsの導入をしていることも大きな要因になっている。 なので、単に使い方を工夫するだけでは足りず、AGENTS.mdの書き方やSkillsに対する知識も付ける必要がある。</p> <p><img src="./images/maintenance.png" alt="裏では"></p> <h2 id="7-まとめ">7. まとめ</h2> <ul> <li>AIは日々進化しており信頼できる相棒足りえる</li> <li>現状分析・コーディングレベルの作業はAIの生産性には勝てない</li> <li>人に必要な能力 <ul> <li>成果物を明確にイメージして具体的にAIへ伝える</li> <li>アウトプットと成果物イメージに差異がないか見極める</li> <li>AIの基本設定を行える</li> </ul> </li> </ul>https://tech.feature-branch.co.jp/posts/2026/01/directory-management/Thu, 29 Jan 2026 09:00:00 +0900https://tech.feature-branch.co.jp/posts/2026/01/directory-management/<h2 id="はじめに">はじめに</h2> <p>こういう経験、ありませんか？「とりあえず分けておけば大丈夫」と思っていたら、いつの間にかフォルダーが迷路化していた、というやつです。あるいは「組織の既存のフォルダールールがそうだから」と、理由は分からないけど合わせ続けてきた人も多いはず。だから今回は、迷わないための運用ルールを紹介します。</p> <p>この記事では、次の順で話します。</p> <ul> <li>5階層までに抑える考え方</li> <li>2桁番号の理由と、0〜99の温度感・99アーカイブまでの運用</li> <li>PARA方式の考え方</li> <li>運用で育てていくコツ</li> </ul> <p><img src="./images/Gemini_Generated_Image_jpsa1cjpsa1cjpsa.png" alt="Nano Banana Pro挿絵 - 整理された棚と番号札のついたボックスが並ぶイメージ、明るいオフィス背景"></p> <h2 id="1-5階層整理で深くしすぎないルールを作る">1. 5階層整理で「深くしすぎない」ルールを作る</h2> <p>深い階層は探すコストが高く、浅い階層は名前が長くなりがちです。そこで「5階層まで」と上限を決めると、迷う前に整理の手が止まります。ここで出てくる番号ルールは、後で紹介するJohnny Decimalの考え方をベースにしています。目安は次の通りです。</p> <table> <thead> <tr> <th>階層</th> <th>役割</th> <th>例</th> </tr> </thead> <tbody> <tr> <td>1</td> <td>ルート</td> <td><code>work</code> / <code>personal</code></td> </tr> <tr> <td>2</td> <td>エリア</td> <td><code>sales</code> / <code>product</code>（または <code>10-19_product</code> など）</td> </tr> <tr> <td>3</td> <td>カテゴリ</td> <td><code>12_specs</code> / <code>21_proposals</code></td> </tr> <tr> <td>4</td> <td>アイテム</td> <td><code>12-03_release-2026q1</code></td> </tr> <tr> <td>5</td> <td>ファイル群</td> <td><code>notes.md</code> / <code>images/</code></td> </tr> </tbody> </table> <p>IT会社なら、上位は業務領域、下位は案件や資料の種類がわかるようにすると整理しやすいです。例えば「営業 → プロジェクト → 資料種別」の流れです。</p> <div class="highlight"><div class="chroma"> <table class="lntable"><tr><td class="lntd"> <pre tabindex="0" class="chroma"><code><span class="lnt">1 </span><span class="lnt">2 </span><span class="lnt">3 </span><span class="lnt">4 </span><span class="lnt">5 </span><span class="lnt">6 </span><span class="lnt">7 </span><span class="lnt">8 </span></code></pre></td> <td class="lntd"> <pre tabindex="0" class="chroma"><code class="language-text" data-lang="text"><span class="line"><span class="cl">sales/ </span></span><span class="line"><span class="cl"> 20_projects/ </span></span><span class="line"><span class="cl"> 21_client-a/ </span></span><span class="line"><span class="cl"> 01_プロジェクト計画/ </span></span><span class="line"><span class="cl"> 80_成果物/ </span></span><span class="line"><span class="cl"> 97_送付資料/ </span></span><span class="line"><span class="cl"> 98_受領資料/ </span></span><span class="line"><span class="cl"> 99_archive/ </span></span></code></pre></td></tr></table> </div> </div><p>5階層の考え方は、上位ほど「広い責務」、下位ほど「具体的な成果物」に寄せます。実際のツリー例はこんな感じです。</p>