Claude Codeを用いたプロジェクト運用層の構築
- •メアリー・オロウは、Claude Codeをプロンプト依存型から構造化されたプロジェクト運用層へと転換させた。
- •このシステムは、メンテナー用ドキュメント、ローカルのJSONメモリ、確立された記録システムを活用してプロジェクトの文脈を維持する。
- •「/standup」や「/bug」などの新しい運用コマンドにより、日常的な開発タスクにおける反復的な手動の文脈入力が削減された。
ソフトウェア開発者のメアリー・オロウは、Claude Codeの使用方法を、大規模かつ反復的なプロンプトに依存する手法から、継続的な開発のためのプロジェクト運用層を構築する手法へと移行させた。彼女は、ツールを開き、文脈を貼り付け、タスクを説明し、翌日にそのサイクルを繰り返すというデフォルトの対話パターンでは、バックログのトリアージ、バグ管理、ステータス報告といった長期的なプロジェクトのニーズに応えるための文脈を維持できないと判断した。この課題を解決するため、彼女は「restofstack/claude-project-ops-starter」というスターターリポジトリを開発した。これは、手動でのセッション設定を繰り返す代わりに、構造化されたファイルと定義済みのワークフローを利用するものである。
実装された構造は5つの核となるコンポーネントで構成される。リポジトリレベルのガイドラインを定める「CLAUDE.md」ファイルは、架空の状態よりも既存の記録システムを優先させるルールを定義する。また、「docs/maintainers/」ディレクトリにあるメンテナー用ドキュメントは、サービス境界、手順書、リリースノートといった永続的なプロジェクトの文脈を提供し、AIと人間の共同作業者が安定した情報にアクセスできるようにしている。作業メモリについては、複雑なデータベースの代わりに軽量で確認が容易な小さなローカルJSONファイルを使用している。彼女は、バックログやプルリクエスト(PR)データの信頼できる情報源(システム・オブ・レコード)はJira、GitHub Issues、Linearなどの既存システムに限定し、AIにはその情報の読み取りと統合のみを任務として課している。
最も重要な操作性の向上は、一般的なタスクに対する反復可能なコマンドの作成である。「/standup」、「/bug」、「/rfe」、「/reflect」、「/weekly-report」といったワークフローを定義することで、プロンプトの乱用を防ぎ、対話のたびに白紙の状態からやり直す必要を排除した。例えば「/standup」コマンドは、メモリ、Gitの状態、バックログデータを集約し、次に取るべき具体的なアクションを推奨する。この構成は、単一の開発者が管理するモノレポ(多くのプロジェクトを一つのリポジトリに格納するソフトウェア開発戦略)の複雑さを管理する上で特に有効である。オロウは、この運用に焦点を当てた設計により、Claude CodeがSpec Kitのような機能特化型ツールとは一線を画した、プロジェクトの推進力を維持するための実用的なインターフェースとして機能することを強調している。