Doc Harness：セッション間でプロジェクトの状態を維持するためのClaudeコードスキル

Doc Harnessは、長時間にわたる作業セッション中にAIエージェントがプロジェクトの状態を見失う問題を解決するために設計されたClaude Codeスキルです。プロジェクトフォルダ内に軽量なドキュメントシステムを作成し、どのエージェントでもプロジェクトの状況を理解し、確立されたルールに従い、シームレスに作業を継続できるようにします。

解決する課題

このツールは、複数のセッションにまたがるプロジェクトでClaude Codeを使用する際の一般的な問題に対処します：エージェントが最近の作業内容を忘れてしまうコンテキストのリセット、30ファイル以上のプロジェクトのナビゲーションの難しさ、「コミット前に必ずテストする」などの確立されたルールの徐々の忘却、新しいエージェントにプロジェクトを20分以上かけて再説明する必要性などです。

仕組み

Doc Harnessは、プロジェクトフォルダ内に5つの構造化ファイルを維持します。重要なファイルはCURRENT_STATUS.mdで、「動く車」の構造を使用します：

• 最近の履歴（どこから来たか）
• 現在の作業詳細（現在地）
• 次のステップ（どこへ向かうか）
• 作業原則（運転方法）

作業フェーズが終了すると、詳細は永続的にアーカイブされ、ステータスは次のフェーズのためにクリアされます。

コマンド

このスキルは2つの主要なコマンドを提供します：

• /doc-harness init - プロジェクトに合わせて5つのドキュメントを作成
• /doc-harness check - ドキュメントの健全性を監査（ファイルが登録されているか、ステータスが最新か確認）し、プロジェクトのルールをエージェントに読み戻し、ルールが守られているかどうかの振り返りを促します

基本原則

このツールは「書き留めなければ失う」という原則で動作します。AIのコンテキストは一時的ですが、ファイルは永続的であることを認識しています。重要な結果、決定、洞察はすべてファイルに保存され、インデックスに登録されるべきです。

インストール

git clone https://github.com/cilidinezy-commits/doc-harness.git
cp -r doc-harness/skill ~/.claude/skills/doc-harness

インストール後、スラッシュコマンドを使用せずに自然言語でエージェントに「プロジェクトのドキュメントをセットアップして」と指示できます。

互換性

研究論文、SaaS機能、データ分析、記事、ソフトウェアライブラリ、複数セッションにまたがるあらゆるプロジェクトタイプで動作します。英語版と中国語版が含まれており、このツールはMITライセンスでリリースされています。