研究プロジェクトを反復する
このスキルを使用して、1つの研究プロジェクトが変化する中で誠実であり続けるようにします。核となる習慣は次のとおりです:作業を分類し、最も狭く永続的な場所に書き込み、証拠を記録し、共同作業者が必要とする要約とボードのみを同期します。
すべてに貫かれる2つのルール:
- マークダウン優先、ボードはその後。 最初にソースマークダウンまたは
_aiノートを更新します。その後でのみPROJECT_BOARD.htmlを同期します。 - ボードは地図であり、ログではありません。
PROJECT_BOARD.htmlは現在の状態を示し、証拠を指し示します。生のログ、プライベートデータ、絶対パスを保存することは決してありません。
そして、反復を駆動する1つの習慣:新しいアイデア → 新しいサブプロジェクト。 実験の試行が作業の中核です。何か試すことがあるときは、新しい 0-Project/<日付>_<スラッグ>/ を作成し、そこで反復します。上書きしたり、1つの試行を延々と繰り返したりしないでください。サブプロジェクトは小さく、単一目的に保ちます。重複を恐れないでください。これにより、履歴が追記専用で比較可能になります(references/project-iteration-system.md を参照)。
サブプロジェクトにはレーンもあります:
- メインライン — アクティブなパスを定義する現在の試行。
- 一時保留 — 研究思考は完全にシリアルではないため早期にキャプチャされたが、まだ実行されていない将来の試行アイデア。デフォルトのノート:
0-Project/_parking-lot.md。 - アーカイブ — 中止された、または取って代わられた試行。停止理由と証拠とともに保持されます。デフォルトのフォルダ:
0-Project/_archive/。
手軽に保留します。将来のアイデアは、_ai/task_plan.md、1-Docs/、または 0-Project/_parking-lot.md への短いエントリにできます。アイデアに十分な入力、基準、または引き継ぎ価値がある場合にのみ、完全な試行フォルダを作成します。
議論と試行は別々にルーティングします。議論、決定、比較、方法の説明は 1-Docs/<日付>_<トピック>.md に。入力、基準、出力、または結果を伴う具体的な試行は 0-Project/<日付>_<スラッグ>/ に。試行ローカルの議論は 0-Project/<試行>/docs/<日付>_<トピック>.md に。
単独、またはポートフォリオ内で。 このスキルは自己完結型です。任意のパスにある単一のプロジェクトに単独で使用できます。ポートフォリオは必要ありません。プロジェクトに必要なすべて(フォルダ、エントリファイル、ボード、ワーキングメモリ、gitポリシー)はプロジェクトフォルダ内に存在します。オプションで、プロジェクトがポートフォリオ(<スラッグ>-project/<プロジェクト>/)内にある場合、manage-research-portfolio スキルを使用して、ステータス、所有者、優先度、公開状態をポートフォリオダッシュボードに同期します。単独で実行する場合は、このスキルのすべての「ポートフォリオダッシュボード」および「レジストリ」のステップをスキップしてください。これらはオプションの統合であり、前提条件では決してありません。
プロジェクト契約
プロジェクトに同等の名前がすでにない限り、この構造を使用します。これはコピー可能な _PROJECT_TEMPLATE スケルトンです。
<プロジェクト>/
├── README.md エントリ: 一文の目標、フォルダマップ、クイックスタート、現在のステータス
├── PROJECT_GUIDELINES.md プロジェクトローカルの同期ルール、フォルダ境界、HTML分類
├── PROJECT_BOARD.html ボード(看板): 現在の状態マップとナビゲーション
├── GIT_WORKFLOW.md このプロジェクトのgit ID + 変更ごとのコミットポリシー
├── scripts/
│ └── init_project_git.sh IDを設定し、最初のコミットを行うオプションのヘルパー
├── 0-Project/ 具体的な試行/実験(試行ごとに1つの 0-Project/<日付>_<スラッグ>/)
├── 1-Docs/
│ └── README.md 単一の固定Docsエントリ + トピックインデックス
├── 2-Data/
│ └── DATA.md ソース、来歴、許可、バージョン、スキーマ、QC、境界
├── 3-Paper_Survey/
│ └── README.md 読書キュー、論文ノート、エビデンスマトリックス、メソッドソース
├── 4-Skills/
│ └── PROJECT_SKILLS.md プロジェクトローカルのプロンプト、AIルール、再利用可能な手順
└── _ai/
├── project_overview.md 目標、範囲、ステータス、所有者、優先度、次
├── project_board_spec.md PROJECT_BOARD.html がソースからどのように生成/同期されるか
├── task_plan.md 現在のフェーズ、計画、ブロッカー、次
├── findings.md 安定した発見、未解決の質問
└── progress.md 最新の意味のある同期、アクション、検証、コミット
ルートファイルはエントリ + ルール + ボード + gitポリシーです。具体的なものはすべて、最もマッチする番号付きフォルダに配置します。プロジェクトルートに資料を積み上げたり、プロジェクト概要、ボードルール、長期ガイドラインを 0-Project/ 内に決して置かないでください(そのフォルダは具体的な試行専用です)。
書く前に分類する
ユーザーが新しい資料を提供したら、1つの着地場所を選び、その後ボードが変更されるかどうかを決定します。
| ユーザーの意図 | 着地場所 | 影響を受ける可能性のあるボードビュー |
|---|---|---|
| 「これは議論/方法/決定/比較です」 | 1-Docs/<日付>_<トピック>.md + 1-Docs/README.md を更新 | ドキュメントマップ |
| 「これは具体的な実験/試行です」 | 0-Project/<日付>_<スラッグ>/; 試行ローカルのノートはその docs/ の下に | タスク(タスク試行) |
| 「これは既存の試行に関するノートです」 | 0-Project/<試行>/docs/<日付>_<トピック>.md | 通常はタスク、プロジェクトレベルのインデックスを変更する場合はドキュメントマップの場合もある |
| 「これは将来の試行アイデアです」 | _ai/task_plan.md、1-Docs/、または 0-Project/_parking-lot.md; 具体的な場合のみ完全な試行フォルダ | 通常はなし、または一時保留タスクレーン |
| 「この試行は中止されました/取って代わられました」 | 試行フォルダを保持するか、0-Project/_archive/ の下に移動; 停止理由、証拠、および代替案を記載してアーカイブ済みとマーク | アーカイブ/折りたたまれたタスクレーン |
| 「これはデータ/ベンチマーク情報です」 | 2-Data/DATA.md | マテリアル(データ材料) |
| 「これは論文/外部ソース/証拠です」 | 3-Paper_Survey/README.md + エビデンスマトリックス | リファレンス(参考文献) |
| 「これは再利用可能なワークフロー/プロンプト/AIルールです」 | 4-Skills/PROJECT_SKILLS.md | (通常はなし) |
| 「これによりステータス/次のアクション/ブロッカーが変更されます」 | _ai/project_overview.md、_ai/task_plan.md | トップ概要 + プロジェクト進捗 |
分類によってプロジェクト範囲、評価基準、データ境界、公開範囲、または試行がプロジェクトに属するかどうかが変わる場合は、確認済みとして扱う前に質問してください。リスクの低い命名/フォーマットについては、控えめなオプションを選択し、その仮定を _ai/progress.md に記録します。
ボード(看板)
PROJECT_BOARD.html は単一プロジェクトのボードです。ひと目で次のことがわかります:このプロジェクトは何か、現在の状況は何か、何が変わったか、証拠はどこにあるか、どこから続けるか。フォルダと連携しています。各ビューは特定のフォルダまたは _ai ファイルから供給されます。
基本要素:
-
ホーム/戻るリンク(永続的): ページの最前部、左上のブランド領域にあるリンク。ポートフォリオ内では、サイトルート
/を指すBack to dashboardリンクにします。単独の場合は、省略するか、プロジェクト自身のREADME.mdを指すようにします。ページを作成、コピー、公開、更新するときに選択したものを保持します。 -
バージョンステータス: ページバージョン
YYYY-MM-DD-vNと最終同期マーカー(オプションで鮮度/リフレッシュコントロール)。 -
トップ概要(常に表示、薄く): プロジェクト名、一文の説明、ステータス、所有者、最近の同期、現在の焦点、および最大1行の短い進捗行。ソース:
_ai/project_overview.md。フェーズリスト、バージョンカード、試行リスト、または長期的なルートをここに置かないでください。 -
5つの相互排他的なビュー。それぞれがフォルダにマッピングされています:
ビュー 供給元 表示内容 プロジェクト進捗 _ai/progress.md、_ai/findings.md、1-Docs/README.mdプロジェクトレベルの主要な変更のみ:目標、範囲、フェーズ、主要な出力、判断、公開状態、コンパクトなバージョン概要 ドキュメントマップ 1-Docs/README.md+ ルート構造ドキュメントトピックインデックス + VS Codeエクスプローラースタイルの構造ツリー(ルートレベルのファイル/フォルダと <details>/<summary>によるレベル2)、公開しても安全な名前のみタスク(タスク試行) 0-Project/<試行>/最初にメインラインの試行。一時保留中の将来の試行とアーカイブ/非推奨の試行は、別々の折りたたまれたレーンのみ マテリアル(データ材料) 2-Data/DATA.mdデータブロック、公開性、バージョン、品質、使用境界 リファレンス(参考文献) 3-Paper_Survey/README.md論文、メソッドソース、エビデンスステータス、影響。コンテンツがある場合のみ
ボードルール:所有者、ステータス、優先度、将来のフェーズを発明しないでください。独立した「次のステップ」ビューを追加しないでください(次のアクションはトップ概要、_ai/task_plan.md、または試行にあります)。試行と構造ツリーには折りたたまれた <details> を使用します。静かな研究作業台として保ち、ランディングページにしないでください。将来のアイデアと中止された試行は、アクティブなパスと視覚的に競合してはなりません。生成ルールは _ai/project_board_spec.md にあります。完全な契約については references/project-board.md を参照してください。
反復ループ
_ai/project_overview.md、_ai/project_board_spec.md、_ai/task_plan.md、_ai/findings.md、_ai/progress.md、および関連するフォルダのREADMEからコンテキストを復元します。- プロジェクトファイルを編集する前に、オペレーターのGit IDを確認します。欠落している場合は、ユーザーに自身のものを設定するよう求め、一時停止します。
- 現在の反復を一文で命名します:質問、試行、または決定。
- 最初に最も狭いソースファイルを作成または更新します。
- 方向性を変える発見を
_ai/findings.mdに記録します。アクション、検証、失敗したパスを_ai/progress.mdに記録します。 - フェーズ、ブロッカー、または次のアクションが変更されたときに
_ai/task_plan.mdを更新します。 - コンテキスト圧縮の前、小さなステップを完了した後、またはトピック/サブプロジェクトを切り替える前に、最も狭い該当するMarkdownファイルにコンパクトな引き継ぎを書き込みます。
- 同期スケールを適用して
PROJECT_BOARD.htmlに触れるかどうかを決定し、次に変更された安全なファイルを明示的なパスとともにコミットします。
コンテキスト圧縮と引き継ぎ衛生
会話を運ぶコストが高くなる前に、積極的にコンテキストを書き留めます。コンテキストウィンドウが大きくなっているとき、小さなステップが完了したとき、サブプロジェクトが決定点に達したとき、または次のアクションが別のトピック、プロジェクト、または試行に切り替わるときにこれを行います。
最も狭いホームを選択します:
| 状況 | 引き継ぎ場所 |
|---|---|
| プロジェクトレベルの議論、決定、または方法ノート | 1-Docs/<日付>_<トピック>.md |
| 試行レベルのステップ、観察、またはローカルな議論 | 0-Project/<試行>/docs/<日付>_<トピック>.md |
| プロジェクトステータス、ブロッカー、次のアクション、または検証概要 | _ai/progress.md、_ai/findings.md、_ai/task_plan.md |
| クロスプロジェクトまたはポートフォリオコンテキスト | ポートフォリオが存在する場合、そのポートフォリオの <スラッグ>-ai/<日付>_<トピック>.md |
最小限の引き継ぎフィールド:現在の目標、完了したステップ、主要な決定、証拠パス、未解決の質問、次のアクション、およびボード同期が必要かどうか。これをコンパクトに保ちます。完全なトランスクリプトや生のログを貼り付けないでください。
同期スケール
ボードを編集する前に、すべての変更をこのスケールに照らして判断します。
| レベル | トリガー | 更新 |
|---|---|---|
| 0 | 読み取り専用の探索、新しい決定なし | なし |
| 1 | 軽微な発見、小さな失敗ブランチ、一時的なノート | マークダウンまたは _ai のみ |
| 2 | 新しいアーティファクト/パス/QC結果、ブロッカー、次のアクション、ステータス、ドキュメントマップ、構造ツリー、データ境界、リファレンス、または試行の変更 | ソースマークダウンまたは _ai、その後 PROJECT_BOARD.html を同期 |
| 3 | フェーズ、マイルストーン、パブリッククレーム、所有者、優先度、または公開状態の変更 | ソースマークダウン、ボード、PROJECT_GUIDELINES.md、および — プロジェクトがポートフォリオに属する場合のみ — ポートフォリオダッシュボード |
コンテキスト引き継ぎノートは通常レベル1です。次のアクション、ステータス、ブロッカー、ドキュメントマップ、データ境界、リファレンス状態、または試行状態を変更する場合にのみレベル2に引き上げます。
編集のたびにボードを同期しないでください。共同作業者が新しい状態を必要とするときに同期します。
サブプロジェクト記録
各 0-Project/<日付>_<スラッグ>/README.md は次の質問に答える必要があります:試行がテストする質問は何か。使用する入力、論文、データノート、または仮定は何か。実行または推論された内容(目標、仮説、入力、コマンド、メトリクス)は何か。何が失敗し、変更され、安定したか。結論と次のアクション。そしてそれがプロジェクトステータス、データノート、文献ノート、またはボードに影響を与えるかどうか。試行ローカルの議論、ステップの引き継ぎ、設計ノートはその試行の docs/ フォルダに配置します。
失敗した試行を記録します。明確な理由のある失敗したパスは有用なプロジェクト資産です。中止または取って代わられた場合は、停止理由、代替案(ある場合)、最後の証拠、繰り返してはいけないことを示してアーカイブ済みとマークします。安定したフェーズまたは決定点に達した後は、折りたたまれた二次的なアイテムとしてのみボードに表示します。
データと文献
2-Data/DATA.mdを来歴、バージョン、アクセスクラス、許可された場所、スキーマ、QC、および派生アーティファクトの境界に使用します。プロジェクト派生データ(特徴量、軌跡、分析準備済みテーブル、QC中間体)は、グローバルデータ領域ではなく、このプロジェクトの2-Data/の下に保持します。生の機密レコード、個人を特定する例、認証情報、または未公開の抜粋をノート、ボード、または公開コピーに書き込まないでください。3-Paper_Survey/README.mdを、方法、評価、範囲、または解釈を変更する可能性のある証拠に使用します。論文を問題、方法、データまたはベンチマーク、結果、限界、およびこのプロジェクトへの影響によって要約します。複数のソースが1つの主張に影響を与える場合は、エビデンスマトリックスを使用します。長い引用よりも簡潔な言い換えとリンクを優先します。
リファレンス
- プロジェクト構造、エントリファイル、サブプロジェクト、ワーキングメモリファイル、または同期ルールを作成するときは
references/project-iteration-system.mdを読んでください。 PROJECT_BOARD.htmlを作成、レビュー、または同期するときはreferences/project-board.mdを読んでください。- データノート、ベンチマークの来歴、文献要約、または証拠から決定への更新を扱う前に
references/data-and-literature.mdを読んでください。