サービスを見る

考え方と、実践のログ。

脱・人月商売、フルAI駆動の開発、透明な料金。私たちが何を考え、どう手を動かしているか。誇張のない記録として綴ります。

技術AIエージェント時代、強いリポジトリは「AGENTS.md」を持っている ──CopilotがレビューにAGENTS.mdを読み始めた日
Latest · 最新記事

AIエージェント時代、強いリポジトリは「AGENTS.md」を持っている ──CopilotがレビューにAGENTS.mdを読み始めた日

AIコーディングの差は、もう「どのモデルか」だけではない。効くのは「そのリポジトリが自分の作法をAIに渡せているか」だ。賢いAIほど、リポジトリ固有のルール（日本語で返す/RLSを確認/秘密値を出さない/公開後の確認）を知らないと堂々と間違える。2026年6月、各社が同じ“指示の層”に寄ってきた——GitHub Copilotのコードレビューが AGENTS.md を読み始め、Codexは作業前に命令チェーンを組み、Microsoft AgentRC はリポジトリのAI対応度を計測。AGENTS.md は「AI向けREADME」ではなく、setup/test/secret/権限/完了条件を渡す“作業契約＝運用OS”だ。何を書くか（言語/スタック/コマンド/安全/Done）、私たちが各リポに持たせている一次情報、そして万能論への釘（skills/MCP/eval/人のレビューとセット・秘密値は書かない）まで。外部仕様はCAG非検証＝公式発表ベース。

甲斐ショウジ11分で読めます
技術AI駆動開発AIエージェントAGENTS.md開発手法解説
Up next次に読む
tech技術すべて見る（33）→
技術AIエージェント時代、強いリポジトリは「AGENTS.md」を持っている ──CopilotがレビューにAGENTS.mdを読み始めた日

AIエージェント時代、強いリポジトリは「AGENTS.md」を持っている ──CopilotがレビューにAGENTS.mdを読み始めた日

AIコーディングの差は、もう「どのモデルか」だけではない。効くのは「そのリポジトリが自分の作法をAIに渡せているか」だ。賢いAIほど、リポジトリ固有のルール（日本語で返す/RLSを確認/秘密値を出さない/公開後の確認）を知らないと堂々と間違える。2026年6月、各社が同じ“指示の層”に寄ってきた——GitHub Copilotのコードレビューが AGENTS.md を読み始め、Codexは作業前に命令チェーンを組み、Microsoft AgentRC はリポジトリのAI対応度を計測。AGENTS.md は「AI向けREADME」ではなく、setup/test/secret/権限/完了条件を渡す“作業契約＝運用OS”だ。何を書くか（言語/スタック/コマンド/安全/Done）、私たちが各リポに持たせている一次情報、そして万能論への釘（skills/MCP/eval/人のレビューとセット・秘密値は書かない）まで。外部仕様はCAG非検証＝公式発表ベース。

甲斐ショウジ11分で読めます
技術AI駆動開発AIエージェントAGENTS.md開発手法解説
技術「人間が読むWiki」から「AIが引き継ぐ知識」へ ──Google CloudのOKFが名付けた、AIエージェント時代の知識設計

「人間が読むWiki」から「AIが引き継ぐ知識」へ ──Google CloudのOKFが名付けた、AIエージェント時代の知識設計

AIエージェントを毎日使うと、すぐ壁に当たる。モデルは賢いのに、前提・過去の決定・正本・禁止事項を読めないと使えない。足りないのは長いプロンプトでなく「引き継げる知識」だ。Google Cloudが公開した Open Knowledge Format（OKF v0.1）は、知識を Markdown＋YAML frontmatter＋ディレクトリのvendor-neutralな“束”として表す仕様で、この感覚に名前を与えた。私たちは人間とAIが共同編集するMarkdownナレッジベースを日々運用しており、OKFは「ずっとやってきたこと」に共通語がついた感覚。ただし正本はObsidian最適のまま、export層でwikilink→通常リンク・category→type・description補完して書き出すのが安全（実際にOKF互換ページを試作）。企業ナレッジをagent-readyにする導入支援の角度、v0.1 Draft/形式は質を上げない/機密のレーン分けという留保まで。外部仕様はCAG非検証＝公式発表ベース、ナレッジ運用は自社一次情報。

甲斐ショウジ11分で読めます
技術AI駆動開発ナレッジ管理MarkdownGoogle Cloud解説
制作事例技術「あの資料、見てもらえたかな」を終わらせる ──提案資料をURL一つで安全に届け、閲覧まで見える共有ツールを作った

「あの資料、見てもらえたかな」を終わらせる ──提案資料をURL一つで安全に届け、閲覧まで見える共有ツールを作った

メールに添付した提案資料は、相手が開いたのか、どこまで読んだのか分からない。PDFは重くて開かれず、共有リンクは転送し放題で機密には使えない——資料を「送って終わり」にした瞬間、その先は暗闇になる。私たちは提案資料を多く扱う支援企業向けに、資料をURL一つで安全に届け、閲覧の状況まで見えるセキュアな共有ツール（DocSend的）を設計・実装した。①クライアント閲覧者を“会員”にしない二系統認証（Web暗号＋署名付き一時通行証）、②直リンクを塞ぎ隔離枠で映す“見えるけど抜けない”配信、③資料をAIで生成し必要箇所だけ差分編集・同一URLで改訂・自動分類、④現場の要望を1日7リリースで即日反映・大容量50MB対応。技術判断を主役に、安全性とAI活用と改善速度の作り方を書く。クライアント名・ドメイン・認証情報は伏せ、数値は自社実装の事実に基づく匿名例。

甲斐ショウジ10分で読めます
制作事例セキュリティ資料共有AI活用Next.jsWeb Crypto
制作事例技術Google口コミを、店舗運営の「次の一手」に変える ──分析して終わらせない、多店舗対応の改善ツールを作った

Google口コミを、店舗運営の「次の一手」に変える ──分析して終わらせない、多店舗対応の改善ツールを作った

「星4.2、口コミ186件」——その看板を上げるために、明日から何をするか。多くの現場でここが曖昧なまま放置されている。私たちは店舗集客を支援する事業者向けに、Google等の口コミを店舗運営の“打ち手”に変える分析ツールを設計・実装した。①あと★5が何件で評価4.0に届くかを決定論的に正確計算する目標シミュレーション、②業種特性を踏まえてAIが強み・不満を言語化、③低評価×未返信の「要返信の口コミ」抽出、④一覧APIで546店舗を数秒発見し口コミは店舗ごとに取得、⑤毎月の自動同期、⑥A4日本語PDFで客先納品——「分析して終わり」でなく「次に何をするか」まで出す仕組みを、技術判断を主役に書く。クライアント・店舗名は伏せ、数値は自社実装の実データに基づく匿名例。

甲斐ショウジ11分で読めます
制作事例口コミ分析店舗運営AI活用Next.jsマルチテナント
works制作事例すべて見る（17）→
制作事例技術「あの資料、見てもらえたかな」を終わらせる ──提案資料をURL一つで安全に届け、閲覧まで見える共有ツールを作った

「あの資料、見てもらえたかな」を終わらせる ──提案資料をURL一つで安全に届け、閲覧まで見える共有ツールを作った

メールに添付した提案資料は、相手が開いたのか、どこまで読んだのか分からない。PDFは重くて開かれず、共有リンクは転送し放題で機密には使えない——資料を「送って終わり」にした瞬間、その先は暗闇になる。私たちは提案資料を多く扱う支援企業向けに、資料をURL一つで安全に届け、閲覧の状況まで見えるセキュアな共有ツール（DocSend的）を設計・実装した。①クライアント閲覧者を“会員”にしない二系統認証（Web暗号＋署名付き一時通行証）、②直リンクを塞ぎ隔離枠で映す“見えるけど抜けない”配信、③資料をAIで生成し必要箇所だけ差分編集・同一URLで改訂・自動分類、④現場の要望を1日7リリースで即日反映・大容量50MB対応。技術判断を主役に、安全性とAI活用と改善速度の作り方を書く。クライアント名・ドメイン・認証情報は伏せ、数値は自社実装の事実に基づく匿名例。

甲斐ショウジ10分で読めます
制作事例セキュリティ資料共有AI活用Next.jsWeb Crypto
制作事例技術Google口コミを、店舗運営の「次の一手」に変える ──分析して終わらせない、多店舗対応の改善ツールを作った

Google口コミを、店舗運営の「次の一手」に変える ──分析して終わらせない、多店舗対応の改善ツールを作った

「星4.2、口コミ186件」——その看板を上げるために、明日から何をするか。多くの現場でここが曖昧なまま放置されている。私たちは店舗集客を支援する事業者向けに、Google等の口コミを店舗運営の“打ち手”に変える分析ツールを設計・実装した。①あと★5が何件で評価4.0に届くかを決定論的に正確計算する目標シミュレーション、②業種特性を踏まえてAIが強み・不満を言語化、③低評価×未返信の「要返信の口コミ」抽出、④一覧APIで546店舗を数秒発見し口コミは店舗ごとに取得、⑤毎月の自動同期、⑥A4日本語PDFで客先納品——「分析して終わり」でなく「次に何をするか」まで出す仕組みを、技術判断を主役に書く。クライアント・店舗名は伏せ、数値は自社実装の実データに基づく匿名例。

甲斐ショウジ11分で読めます
制作事例口コミ分析店舗運営AI活用Next.jsマルチテナント
制作事例技術このサイトのAIは、自分たちで作った ──HITL・顧客別メモリ・メール⇄チャット双方向を実装した顧客対応AIの中身

このサイトのAIは、自分たちで作った ──HITL・顧客別メモリ・メール⇄チャット双方向を実装した顧客対応AIの中身

CAGサイトの問い合わせに一次対応しているAIは、自分たちで実装した。マルチテナント基盤、RAGと顧客別メモリを持つエージェント、見積もりは人間に渡すHITL設計、メールへの返信がそのままチャットになる双方向統合、そして「全部実機で確かめた」自動検証42項目——本番品質の顧客対応AIを、AI駆動開発で1日で本番稼働に乗せた制作記録。何を作り・どう守り・何をAIに任せないかの設計判断が、速さの主役だ。

甲斐ショウジ10分で読めます
AIエージェント制作事例SupabaseHITLマルチテナントAI駆動開発
制作事例技術Markdownは、もう卒業。AIが作る"見栄えするHTML"を、安全に共有できるようにした話

Markdownは、もう卒業。AIが作る"見栄えするHTML"を、安全に共有できるようにした話

AIに資料を作らせるとmdで返るが、記号が残り表は崩れ、見せるには不向き。今のAIはHTMLが得意で、整った資料を一瞬で書ける。でもHTMLは共有が難しい——DLの手間・見た目崩れ・流出不安。そこで、アップロードすると専用URLが出て、DLなしでセキュアに閲覧できるツールを作った。推測困難URL＋認証＋直リンク遮断＋閲覧ログ。テキストからAIがHTML生成も。作れると届けられるは別問題。

甲斐ショウジ10分で読めます
HTML資料共有セキュリティAI生成制作事例
management経営すべて見る（2）→
制作事例経営 "〇〇市" の政策への声 速報 4 SNS 合算 ・ 24時間ごと更新 すべてXInstagramFacebookThreads 総投稿数1,240 感情スコア+0.43 ポジティブ率58% エンゲージ2,980 投稿数の時系列推移 過去7日間・日次 月水金日 プラットフォーム別 1,240 総投稿数 CASE STUDY · 制作事例 × 経営 数ヶ月の人力を、 AIで1日に畳む。 自治体向けSNS分析ダッシュボードを、実働1日で本番投入した話 電脳技巧集団（AI職人ギルド）

『これ、数ヶ月かかりますよね』を、1日でひっくり返した話

「これ、数ヶ月かかりますよね」——その見積もりの“常識”を、フルAI駆動で覆した制作事例。自治体向けSNS分析ダッシュボードを、実働1日・8コミットでログイン付き本番まで。チャート7種を外部ライブラリ0で実装し、設計判断ごと開示する。

甲斐ショウジ10分で読めます
AI駆動開発制作事例Supabaseダッシュボード脱人月