Claude Code My Workflowを読む、学術制作に検証ゲートを置くテンプレート

学術成果物を作るためのフォーク元

Claude Code My Workflowは、Claude Codeを学術作業へ組み込むためのHTMLベースのテンプレートです。READMEは、講義スライド、研究論文、データ分析、再現パッケージを対象に、利用者が目標を説明するとClaudeが計画し、専門エージェントを動かし、問題を直し、品質を確認して結果を提示する流れを示しています。エモリー大学の博士課程コースから抽出された構成を、他の研究者がフォークして自分の分野へ合わせる考え方です。

これは特定分野の完成品ではありません。LaTeXやBeamer、Quarto、Rを使う例が中心ですが、READMEはPython、R、Markdownだけを扱う場合にLaTeXやQuartoのデモを省略できると説明しています。成果物の種類が違えば、知識ベース、レビュー担当、レンダリング、再現手順を置き換える必要があります。テンプレートを複製しただけで研究の妥当性が整うわけではなく、分野の判断を設定と人間のレビューへ残す点が出発点です。

目標から始めてゲートを通す

READMEが示すv2.0の転換は、完璧なプロンプトを先に作るのではなく、目標を置き、ゲート付きの作業ループで成果物へ近づけることです。専門エージェントが個別の作業を担当し、強制ゲートが状態を判定し、利用者が意見の違いを裁定します。レビューを「忘れないで」と書く注意書きで終わらせず、コマンド、フック、状態ファイルへ落とし込むのがこのテンプレートの特徴です。

一つの./scripts/backtest.shで、表面の同期、スキルの整合性、モデルの新しさ、リンクとアンカー、Agent Skills仕様、古さ、リポジトリ衛生、導出カウント、台帳の範囲、フックの再実行を検査するとREADMEは説明しています。インストールしたpre-commitフックはこの確認と品質スコア80以上の検査をコミットごとに走らせます。ゲートが実行されたことは、引用、分析、コードが正しいことの証明ではありません。検査が何を見て、何を見ないかを記録して使う必要があります。

専門エージェントとパス別ルール

READMEは、proofreader、slide-auditor、pedagogy-reviewer、r-reviewer、domain-reviewer、domain-referee、methods-referee、editorなど、異なる観点を担当する専門エージェントを紹介しています。スキルにはcompile-latex、deploy、qa-quarto、review-paper、data-analysis、verify-claims、humanize、simulation-study、r-package-checkなどがあります。成果物の形式と目的に応じて担当を選ぶため、全てを毎回動かす構成ではありません。

ルールは常時読み込むものと、.tex、.qmd、.Rなど一致するパスで起動するものに分かれています。READMEは、パス範囲を使うことで常時オンの設定を約100行に抑えると説明しています。これは必要な文脈を絞る設計ですが、ファイルの置き場所を変えたときにルールが発火しなくなる可能性もあります。新しい分野へ移す場合は、対象拡張子、命名、生成物、レビュー担当の対応を一覧化し、意図したスキルが本当に起動するか確認してください。

品質スコアと主張の検証

品質は0から100で評価され、READMEにはコミット80、プルリクエスト90、理想的な卓越レベル95というしきい値があります。/verify-claimsはドラフトを見ていない検証者を使い、重大度を付け、捏造引用などを検出したときにコミットを止めるHIGH-WARNゲートを持ちます。/audit-reproducibilityは数値主張をスクリプト出力と照合し、passport.yamlに状態を残します。/review-paper --variance Nは一つの判定ではなく、複数回の決定分布を報告します。

/humanizeはAIらしい文体の特徴を検出する読み取り専用のスキルです。品質スコアが高くても、研究設計の妥当性、データの代表性、引用の解釈まで自動で保証するわけではありません。特に人文学や実証研究では、数値の再計算と理論上の主張の検証が別になります。ゲートの合格値を成果物の採否へ直結させず、どの検査が通り、どの判断を人間が引き受けたかをレビュー記録に残すのが正しい使い方です。

最初の環境確認を小さく行う

最小要件はClaude Code、git、Python 3です。macOSとLinuxではPython 3が事前に入っている想定で、HelloWorldのBeamer例にはXeLaTeX、Quarto例にはQuartoが必要です。RとGitHub CLIは推奨され、TikZからSVGへ抽出する場合はpdf2svgが必要になります。READMEは、フォークしてクローンしたあと./scripts/validate-setup.shを実行し、不足するツールとインストールリンクを確認する流れを示しています。

Claudeを起動してスタータープロンプトを貼り、設定ファイルを読み込ませ、プロジェクトへ適応させてから計画モードへ進みます。続いてcompile-latex HelloWorldでPDFを作り、deploy HelloWorldでQuartoをHTMLへ出力します。両方が通ったらデモファイルを削除して実作業へ移る手順です。必要な形式だけ使う場合はデモを省けますが、環境確認そのものを省略する理由にはなりません。まず小さな入力、既知の出力、保存可能なログで道筋を固定するべきです。

権限モードはフォーク直後に見直す

READMEは、Pro、Max、Teamの新しい対話セッションではauto modeが使われ、危険な操作を分類して確認する場合があると説明しています。通常モードは危険なツール呼び出しごとに確認し、acceptEditsやBypassのような選択肢もあります。ここで見落とせないのは、テンプレートの.claude/settings.jsonがdefaultModeをbypassPermissionsにし、Bash、Edit、Writeに広いワイルドカード許可を同梱している点です。README自身がパワーユーザー向けの既定値と説明しています。

信頼できるリポジトリで完全自動の作業を選べることと、どのフォークでも同じ設定を使うことは別です。研究データ、認証情報、公開用リポジトリを扱う場合はdefaultModeをdefaultへ変え、必要なツールを個別に承認する構成を検討してください。自動化が変更を作ったときは、差分、生成物、ログ、外部送信を人間が確認します。品質ゲートがあるから権限を広くしてよい、という推論は成り立ちません。

分野に合わせて二つの出力面を同期

READMEは、テンプレートを新しい分野へ移す手順として、知識ベース、domain-reviewer、BeamerとQuartoの色、R固有の注意、講義マッピング、クイックリファレンス、explorationsフォルダを順に適応するよう示しています。特に色の設定はPreambles/header.texとQuarto/theme-template.scssの双方を更新し、check-palette-sync.shで一致を確認します。

BeamerとQuartoは別の出力面なので、一方だけを変えると講義資料の色や意味がずれます。レビュー対象をコードだけに限定せず、PDF、HTML、図、表、引用、再現パッケージまで同じ契約で確認する必要があります。Rの規約や分野固有の落とし穴も汎用ルールへ無理に押し込まず、対応するパスと知識ベースへ置きます。テンプレートの再利用価値はファイル数ではなく、自分の研究の判断点がどこに記録され、どのゲートで再確認されるかで決まります。

起源、更新、ライセンスを切り分ける

この構成はエモリー大学のEcon 730から抽出され、READMEは博士講義のスライド、インタラクティブなQuarto版、Rによる再現パッケージを作った経験を起源として説明しています。経済学、エネルギー、政治学、工学の研究グループがフォークしたという記載もありますが、個々のフォークの成果や品質を検証した一覧ではありません。CHANGELOG.md、CONTRIBUTING.md、公式サイトを版に合わせて読むべきです。

素材の取得時点で、スター1541、フォーク2984、未解決イシュー5、最終更新日時2026年8月24日が記録されています。リリースはv2.5.1、v2.5.0、v1.9.0です。MITライセンスは利用、改変、配布などを許可しますが、保証を与えません。READMEは本番準備や特定のセキュリティを保証していません。導入判断では、人気や起源ではなく、対象分野のルール、出力の再現、権限設定、引用確認、人間の最終承認が自分の運用に残るかを確かめる必要があります。

編集部の結論

このテンプレートは、Claude Codeに学術成果物の作成を任せたい人よりも、計画、実装、引用確認、再現性、出力品質を一つの手順に組み込みたい研究者や教育担当者に向いています。最初にClaude Codeとgit、Python 3をそろえ、validate-setup.shで不足を確認し、HelloWorldを使って環境を確かめてください。設定ファイルの既定値には広い権限許可とbypassが含まれるため、信頼できるリポジトリ以外では権限モードを見直す必要があります。ゲートの存在は成果物の正しさを保証しないので、最終判断は人間が行うべきです。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes