ホーム » 記事一覧 » 作ったもの » codexでテキスト管理のプロジェクトを建てた話

codexでテキスト管理のプロジェクトを建てた話

最近、AIエージェントを組み込んだサービス開発をやってみたい気持ちが強くなっていました。エンジニア向けの開発でAIエージェントを使うぶんにはだいぶ慣れてきたのですが、これをもっと誰でも使える粒度に落とし込むのが自分の役割だな、とずっと思っています。

ただ、時間がなかなかできませんね。

実際に時間を取られていたのはコードを書くところそのものより、その前の「何をするべきか」を考える時間でした。大きいタスクに取りかかる前に、まず何に分けるか、どこまで調べるか、どこから着手するかを整理するところで、かなりの時間を使っていました。

しかも、こういう作業は熱が入りすぎると本来そこまでやらなくていいことまで掘り始めてしまいます。コードを書くのは楽しいけれど、その前段の整理や下調べに時間を使いすぎるのは、あまり健全ではないなとも感じていました。やってみたら楽しいのですけども。

だったら、この「切り分ける」「調べる」「一歩目を見つける」みたいな部分を、AIエージェントに寄せてみればいいのではないか。そんな発想から、codex でテキスト管理のためのプロジェクトを作ってみることにしました。

何を実行したか

やったことはシンプルで、まず「日々のタスク調整と実行支援のためのワークスペース」をひとつ作りました。GitHub でプライベートリポジトリを作って、そこに日々のメモ、作業中の断片、判断ログ、参照資料を置く形で運用しています。

実行環境は、Dell のデスクトップに Ubuntu Server を入れて、VS Code のリモート接続でつなぐ形です。その上で codex をフルアクセスで動かしています。毎回確認を挟まずにファイル移動や編集までしてくれるので、単なるチャット相手ではなく、かなり実務寄りの補助役として使えています。

codex を使っているのは OpenAIの課金をしているからです。流行りの Claude Code は必要になったら程度で考えてますが、まずは今手元で出来ることの範囲で考えてやっています。

任せているのは主に、切り分け、調査、振り返りです。普通のメモツールのように雑に書き出した内容をもとに、必要ならファイルへ切り出してくれたり、整理したうえで返してくれたりするので、この体感がかなり良いです。

ですけども、整理した量のわりに大きな成果がどんどん出ているかというと、そこはまだこれからです。でも、普段のタスク切り分けは確実に早くなりました。AIエージェントを思いついたらすぐ試せる環境が手元にあること自体も、かなり大きいです。

本命としては、最終的に codex が補助するだけではなく、寝ている間にある程度自動で進んでいる状態まで持っていきたいと思っています。切り分けたタスクが自然に集まるので、その蓄積をもとに codex や ollama が自走する流れまで作れたら面白そうです。

README.md はこんな感じです。「とりあえず作ってみて」「こっちに変えてみて」で積み上がっていったので特に工夫とかはまだ無いです。 AGENTS.md も同じような内容になってます。

# Task Split Workspace

日々のタスク調整と実行支援のためのワークスペース。

## Start Here

- [AGENTS.md](AGENTS.md): どこに何があるかの案内
- [work/00_current.md](work/00_current.md): 毎回最初に開く、生の書き出しファイル

## Core Files

- [AGENTS.md](AGENTS.md): ルールと作業場所のインデックス
- [rules/AGENT_GUIDE.md](rules/AGENT_GUIDE.md): この場所でエージェントが従う前提条件
- [rules/LOGGING_RULES.md](rules/LOGGING_RULES.md): ログを資産化するための保存ルール
- [rules/GIT_RULES.md](rules/GIT_RULES.md): この場所向けの `git` 運用ルール
- [work/00_current.md](work/00_current.md): 当日の断片的なメモ、考え、相談材料の入口

## Directories

- [rules/](rules/): エージェント用ルール
- [work/](work/): 当日の作業場所
- [cloud/tasks/](cloud/tasks/): 判断不要のクラウド自律タスク置き場
- [cloud/results/](cloud/results/): クラウド自律タスク成果物置き場
- [cloud/done/](cloud/done/): 実行済みクラウドタスク置き場
- [logs/](logs/): 1日1本の短い判断ログ
- [logs/cloud_async/](logs/cloud_async/): 非同期クラウド実行の専用ログ
- [scratch/](scratch/): 一時メモ
- [archives/](archives/): 退避した古い記録

## Structure

- [AGENTS.md](AGENTS.md): どこに何があるかを示す案内ファイル
- [README.md](README.md): この場所の入口説明
- [rules/](rules/): エージェント、ログ、`git` に関する運用ルール
- [work/](work/): 当日の作業ファイルを置く場所
- [work/00_current.md](work/00_current.md): 人間が最初に断片的に書き出す当日作業ファイル
- [cloud/tasks/](cloud/tasks/): 判断不要のクラウド自律タスク置き場
- [cloud/results/](cloud/results/): クラウド自律タスク成果物置き場
- [cloud/done/](cloud/done/): 実行済みクラウドタスク置き場
- [logs/](logs/): 1日1本の短い判断ログ
- [logs/cloud_async/](logs/cloud_async/): 非同期クラウド実行の専用ログ
- [scratch/](scratch/): 一時メモ、整理前メモ
- [archives/](archives/): 参照頻度の下がった記録や旧ルール

## Naming Rules

- 判断ログ: `YYYY-MM-DD-log.md`
- 非同期クラウドログ: `cloud_async/YYYY-MM-DD-cloud-log.md`
- クラウド自律タスク: `YYYY-MM-DD-topic-task.md`
- 一時メモ: `YYYY-MM-DD-topic.md`

## Usage Rules

- 毎回まず [work/00_current.md](work/00_current.md) を開く
- まず人間が [work/00_current.md](work/00_current.md) に無秩序に書き出す
- 当日の整理、実行、相談はその内容を元に [work/](work/) で進める
- 必要に応じて [work/](work/) 内で補助ファイルへ切り分ける
- 判断不要で自律実行できる依頼は [cloud/tasks/](cloud/tasks/) に1タスク1ファイルで置く
- 非同期クラウド実行の進捗や結果は [logs/cloud_async/](logs/cloud_async/) に記録する
- 区切りか日末に、必要な判断だけを `logs/YYYY-MM-DD-log.md` へ保存する
- Codex は、作業の区切りごとに `logs/YYYY-MM-DD-log.md` へ `判断 / 詰まり / 次の一手` を短く追記する
- 退避資料や旧版は [archives/](archives/) へ移す
- 保存後、[work/00_current.md](work/00_current.md) は空に戻すか、次回開始用の断片だけ残す
- 短く残す判断は [logs/](logs/) に置く
- まだ粗いメモは [scratch/](scratch/) に置く

## First Use

1. 毎回まず [AGENTS.md](AGENTS.md) か [work/00_current.md](work/00_current.md) を開く
2. 人間は [work/00_current.md](work/00_current.md) に断片的に書き出す
3. 相談時は [work/00_current.md](work/00_current.md) を基準に目的、制約、期限、迷いどころを渡す
4. 必要なら当日の追加メモや切り分けファイルを [work/](work/) に作る
5. 優先方針や再タスク化待ちは [work/20_priority-policy.md](work/20_priority-policy.md) で見る
6. セッション終わりに必要な判断だけを `logs/YYYY-MM-DD-log.md` に短く保存する
7. Codex に作業を任せたときは、区切りごとに `logs/YYYY-MM-DD-log.md` へ短い判断ログを残す
8. 退避したいメモや旧版資料は [archives/](archives/) へ移す
9. ルールを変えたら `git` で履歴に残す
10. ログやアーカイブでは Markdown リンクを使わず、ファイル名で参照する

どうだったか

使ってみた感想をひとことで言うと、かなり万能感があります。ただ、その万能感のわりに仕事が全部終わるわけではないので、そこは勘違いしないようにしたいところです。気分は良くなるのですが、それだけで満足してしまうのはたぶん危ないです。

それでも良かったのは、ルールをすぐ変えられることでした。ワークスペースの運用ルールや置き場所の決め方を、使いながらどんどん直せます。しかも Git で管理しているので、「あの資料もしかして消えた?」が起きにくい想定で運用できます。こまめに push しておけば、その安心感も大きいです。

フラッシュアイデアをまとめて眺めるだけでも、「これは今やるタイミングじゃないな」と判断しやすくなりました。優先順位も宣言しておけば、本来の優先順位と違うことをやり始めると、codex が整理を通して方向修正してくれる感じもあります。

codex でタスクを切り出して、人間がどっちへ行くべきかを判断して、必要なら新しく codex が動けるプロジェクトを作って、また実装や調査を任せる。この往復ができるようになってから、試す速度はかなり上がりました。

codex はコーディングエージェントとして語られることが多いですが、こういうテキスト管理も普通に任せられるな、というのが今回の発見でした。もし同じことを試すなら、毎回確認を挟まなくてもファイル移動や編集までできるフルアクセス寄りの環境は、かなり相性がいいと思います。

大げさなマシンが必要なわけでもなく、手元の安い古い PC を SSH 接続用に使うだけでも、十分始められそうです。

投稿者

ここまで読んでいただき、ありがとうございます。

このサイトでは、私自身が関わっていることや、興味を持って試していることをそのまま置いています。

内容を見ていて、
「少し話を聞いてみたい」
「協業できる部分がありそう」
と感じる点があれば、下記のお問い合わせフォームからご連絡ください。状況を確認したうえで、必要な範囲でお返事します。

特に、以下の構築サービスも提供しているのでご興味ありましたらご相談ください。


Comments

コメントを残す

メールアドレスが公開されることはありません。 が付いている欄は必須項目です