1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

集中が続かないエンジニアが、人とAIエージェントを一緒に働かせるために置いた4つのファイル

1
Last updated at Posted at 2026-11-16

3行で答え
根性で集中するのをやめて、仕事が回る「構造」をGitHubに作った。
AIへの共通ルール (AGENTS.md)、作業ボード、引き継ぎの記録、決めたことの置き場、の4つである。
どのAIエージェントでも、最初に AGENTS.md を読めば同じルールで動ける。

今回の疑問

今回、友人と2人でマーケティングの案件を始めた。2人とも、それぞれAIエージェントを使って作業する。相手がどのAIを使うかは決まっていない。動画や画像のやり取りもある。

疑問はこれだ。使うAIがバラバラでも、人とAIが同じ前提で働ける「構造」は作れるか。 しかも、前回どこまでやったかを自分が覚えていなくても回る形で。

作ったもの

置き場所を2つに分けた。

何を どこに 理由
文章、作業ボード、引き継ぎ、決定、下書き、数字 GitHub の非公開リポジトリ どのAIもファイルとして読み書きできる。2人のAIが同時に書いても、Git が変更をまとめ、履歴も残る
動画、画像、デザインの実ファイル Google Drive の共有フォルダ Git は大きいファイルに向かない。リポジトリには素材の一覧だけを置く

リポジトリの中身はこうなっている。

AGENTS.md        AIエージェントと人の共通ルール (最初に読む)
CLAUDE.md        Claude Code 用。AGENTS.md を読み込むだけ
BOARD.md         作業ボード (誰が・何を・どの状態か)
decisions.md     決まったこと (人だけが書く)
log/             作業ごとの引き継ぎ記録 (月ごとのファイル)
proposals/       AIや人からの提案
context/         背景資料
drafts/          下書き
media/INDEX.md   Drive に置いた素材の一覧
metrics/         週ごとの数字

このうち、構造の芯は4つのファイルである。

1. AGENTS.md: どのAIにも同じルールを読ませる

AGENTS.md は、AIのコーディングエージェント向けの README として使われている形式だ。公式サイトには、Codex、Cursor、Gemini CLI、GitHub Copilot のコーディングエージェントなど、読める道具が並んでいる。

Claude Code は、CLAUDE.md がなければ AGENTS.md を直接読む。ただし読めない場面もあるので、公式ドキュメントにあるとおり、CLAUDE.md から読み込む形にした。CLAUDE.md の中身はこれだけである。

このリポジトリのルールは AGENTS.md にある。作業の前に必ず読み、そのとおりに動くこと。

@AGENTS.md

AGENTS.md には、作業の始め方と終わり方を書いた (抜粋)。

## 作業の始め方 (毎回)
1. このファイルを読む。
2. `git pull` してから作業を始める。
3. BOARD.md で、自分の担当と「作業中」の行を確かめる。
4. log/ の最新ファイルの末尾5件を読み、前回どこまで進んだかを知る。
5. decisions.md を読み、決まったことを覆さない。

## 作業の終わり方 (毎回)
log/YYYY-MM.md の末尾に追記する。そのあと BOARD.md の状態を直して push する。

ほかに、ファイルの置き場所、書いてはいけないもの (社外秘のデータ、APIキー、個人の連絡先)、文章の書き方 (結論を先に、日付は 2026-10-29 の形) を書いている。

2. BOARD.md: 2つのAIが同じ作業をしないように

作業ボードは、ただの表である。

| # | 作業 | 担当 | 状態 | 期限 | 資料・メモ |
| --- | --- | --- | --- | --- | --- |
| 3 | X のプロフィール案を作る | 社長 / Claude Code | 確認待ち | | drafts/x/... |

担当の欄には「人の名前 / AIの名前」を書く。着手する前に「作業中」にして push するのがルールだ。人が2人、AIが2つ以上いると、同じ作業を二重にやるのが一番もったいない。状態は「未着手 / 作業中 / 確認待ち / 完了」の4つだけにした。「完了」にするのは人である。

3. log/: 覚えていなくても戻れるように

作業の終わりに、AIが引き継ぎを1つ追記する。

### 2026-11-01 (人の名前) / Claude Code
- やったこと:
- 置いた場所:
- 次にやること / 止まっていること:

次の作業の始めに、AIはこの末尾5件を読む。自分が前回どこまでやったかを忘れていても、AIが覚えている状態になる。集中が続かない自分には、これが一番効く。実際、数日あいたあとで「前回どこまでやった?」と聞くと、AIがログを読んで答えてくれる。自分の記憶よりこちらのほうが確かだ。

4. decisions.md: 決めるのは人

AIは提案まではするが、決めない。提案は proposals/ に、決まったことは人が decisions.md に書く。

| 日付 | 決めたこと | 決めた人 | 資料 |
| --- | --- | --- | --- |

AIは、決まったことを覆さないようにこのファイルを読む。AIが勝手に方針を変えると、2人の作業が噛み合わなくなるからだ。

社外の人と共有する前にやったこと

友人は社外の人である。共有する前に、全ファイルに社外秘が混じっていないかを、AIに2つの観点で別々に確かめさせた。

  • 観点1: 社内のデータ、取引先の情報、社内システムの内情
  • 観点2: 鍵や接続用のURL、個人の連絡先、開けない非公開資料へのリンク

2つのレビューで18ファイルを全部読ませ、指摘は7件出た。たとえば、社内データの数字は消してあったのに、その集計から言える結論が言葉に置き換わって残っていた。数字を消すだけでは足りない、というのは自分では気づけなかった。消したのは数字だけで、意味は残っていた。人の目だけで確かめていたら、そのまま出していたと思う。

2週間半使ってみて

作ったのは 2026-10-29。それから2週間半で、commit は38回になった。友人は Codex と Muse を使っていて、私の Claude Code と合わせて3種類のAIが同じリポジトリで働いた。引き継ぎの記録は11月だけで21件たまり、3つとも同じ書式 (日付・人・AIの名前) で書いていた。マージのコミットは、まだ1つもない。

一方で、ボードの「確認待ち」が溜まった。完了にするのは人、というルールにしたので、詰まるのはAIではなく自分の確認だった。

まだ分からないこと

  • AIごとの癖。同じ AGENTS.md を読んでも、守り方は道具ごとに違うかもしれない。
  • 衝突したときにAI同士でうまく直せるか。

次に書くこと

1か月使ってみた結果を数字で書く。commit の数、ボードが更新された回数、衝突の回数、ルールが守られなかった場面。

参考にしたもの

この記事の下書きは、Claude Code と一緒に書いた。構成と下調べはAIに任せ、体験の部分と最終の判断は自分で書いた。

1
0
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
1
0

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?