paper-repro

英語のAI論文（arXiv）を読み解き、再現実装まで支援する正式版プロダクト。 最初のリリースでは「タイプB（学習なし・公式実装あり）」の論文を縦切りで完成させ、 その後のリリースでタイプA、GPU実行、レンダリング、LLM-as-a-Judgeへ段階的に拡張する。

---

📍 開発ロードマップの進捗

現在地: フェーズ0「土台の仕上げ」／ 全7フェーズ中 0 完了。次の一手は 0-1 の永続化。

フェーズの状態と各フェーズの内訳は docs/roadmap.md が正本である。 本書は表を複製しない。

📐 設計工程の進捗（IPA 6編中、対象4編）

現在地: 対象4編すべて作成済み。要求33件に対する再検査を2026年9月8〜9日に実施。バッチ編・帳票編は非該当。

詳細は docs/arch-guide/arc-artifact-order.md（作成順序の原則）を参照。

編	枠組み	一覧	共通ルール	フロー・遷移	説明・レイアウト
画面	✅ v0.2.3	✅ v0.2	✅ v0.2	✅ v0.1	✅ 7画面
システム振舞い	✅ v0.3	✅ 62業務 v0.4	✅ v0.2	✅ フロー v0.1・状態 v0.1	✅ 6グループ
データモデル	✅ v0.2	✅ 18エンティティ v0.5	✅ v0.2	✅ ER図 v0.1・CRUD図 v0.2	✅ 論理定義 v0.3・物理仕様 v1.0
外部インタフェース	✅ v0.1.2	✅ v0.5.1	—	✅ 関連図 v0.1.2	✅ IF-01〜IF-05
バッチ	—	—	—	—	—
帳票	—	—	—	—	—

要求カバレッジ（2026年9月9日の実測）

要求33件（メイン12・サブ21）に対する各編の対応である。

編	対応済み	未対応	未対応の理由
画面	実装単位 F-01〜F-21 のうち16	5	画面の形が決まらないと判断できない（一覧 5節）
システム振舞い	29 / 33	4	すべて画面編の判断待ち（一覧 4節）
データモデル	29 / 33	4	すべて画面編の判断待ち（一覧 3節）
外部インタフェース	網羅を宣言しない	2	IF-06 の接続先と収集手段の判断待ち（一覧 4.5節）

⚠️ 未対応はすべて担当工程・解除条件・再判断の期限を持つ。 根拠は .agents/skills/paper-repro-requirement-deferral/SKILL.md。

⚠️ 未対応はすべて「後工程待ち」である。 いま着手できるものは残っていない。 システム振舞い編とデータモデル編の4件は同一（REQ-C12・REQ-C04-S03・REQ-C09-S05・REQ-C10-S05）で、 いずれも arc-screen-list.md 5.3〜5.5節の解除が起点になる。 画面編が動けば3編が同時に動く。

一覧が先である。 詳細から書き始めると、完了を判定できず、粒度も揃わない。 根拠は docs/arch-guide/arc-artifact-order.md を参照。

システム振舞い編とデータモデル編の✅は、現行の確定要求を要求単位で設計したことを示す。 データモデルは18エンティティの論理設計であり、物理仕様はProject／Paperだけが確定している。 4工程成果物は作成済みだが、レビュー結果は✅2・🔨11・⏳1で、全体成熟度は仕掛である。 注釈群と演習履歴群は、保持先未確定の2ギャップとしてUSDMへ戻している。 REQ-C02〜REQ-C11はUSDM仕様未展開のため、両編とも仕様展開後に再検査する。 → USDM展開は2026年9月8日に完了し、4編とも再検査した。 結果は上の要求カバレッジ表を参照。

⚠️ 画面編の入出力項目一覧とアクション明細は、実装フェーズで書く （arc-screen.md 3節）。 桁数・省略規則・初期表示は実装しないと決まらないためであり、未着手ではなく意図的な先送りである。 画面編の工程成果物は6件中4件が完成（7画面とも2節・3節が枠のみ）。 バッチ編・帳票編の — は未着手ではなく非該当である。定期実行される処理と印刷帳票が存在しない。 根拠は docs/worknotes/decision-batch-report-not-applicable.md を参照。 ソフトウェア実装の現在地は変わらずフェーズ0である。

IPA 6編の設計工程の進捗は、本表が正本である。 版数と✅は本表だけが持つ。 ソフトウェア実装の進捗は docs/roadmap.md の管轄で、軸が異なる。 直近の作業内容は docs/devlog/ の最新ファイルを見る。

🧪 動作確認の方針

各開発項目には、それを画面で確かめる手段を必ず対にする。 バックエンドだけを作って「テストが通ったので完了」とはしない。 各フェーズの確認画面は docs/roadmap.md の「◯◯の確認画面」を見る。

確認に投入する論文は docs/test-papers.md の基準論文を使う。

基準論文	StructEval（arXiv:2505.20139）
選定理由	タイプB・GPU不要・公式実装あり・照合できる数値あり・CC BY 4.0

毎回同じ論文を使うことで、前回との違いが画面の差として現れる。

---

ドキュメント

⚠️ 全体像はここから。 docs/repository-map.md — 追跡ファイル223件を14カテゴリへ分け、相対リンクから抽出した依存関係を2つの図で示す。

docs/README.md が索引の正本である。 目的から文書を探すときはここから入る。

よく使う入口:

• 日々のルーチン: docs/daily-routine.md
• 進捗: docs/roadmap.md
• 要件: docs/requirements.md
• 設計: docs/product-design.md
• AI開発指示: AGENTS.md

AI Agent 連携と共通スキル

当プロジェクトでは、Claude Code、Codex、Antigravity IDEを併用したリレー開発を行っています。 共通ルールの正本はAGENTS.md、スキル本文の正本は.agents/skills/である。 Claude Codeは.claude/skills/の短い入口から同じ正本を読み、手順本文を重複管理しない。 paper-reproでは、GitHubへ登録されたリポジトリスキルだけを使用し、個人領域やプラグインキャッシュのスキルを適用しない。

実装済み共通スキル

• paper-repro-skill-source-policy: Git追跡・HEAD・リモート同期を確認し、リポジトリスキルだけを許可
• paper-repro-arch-guide: 要求から設計文書へ展開し、Mermaid CLIで図を実描画して検証
• arxiv-paper-repro: AI/ML論文の再現実装、部分採用、スコア不一致の切り分け
• paper-repro-devlog: paper-repro開発の日次知識をdocs/devlog/へ資産化
• paper-repro-commit-output: commit/push、SHA照合、チャットで個別コピー可能なGitHub URL、実行結果検証
• paper-repro-delegate-integration: 素材ファイルを既存文書へ統合する依頼文の型。章の挿入・番号の繰り下げ・参照の修正
• paper-repro-requirement-deferral: 要求項目を今の要件定義で決めるか後工程へ送るかの判定。保留に担当工程・解除条件・再判断の期限を必須化
• paper-repro-upstream-isolation: 要件定義と4編の設計の途中で、既存の実装やテストの状態を判断材料にしない

Claude Code、Codex、Antigravity IDEの併用

CodexとAntigravity IDEは.agents/skills/を直接利用し、Claude Codeは.claude/skills/から 同じ本文を参照する。WindowsでのGit利用を安定させるため、シンボリックリンクではなく短い参照入口を使う。

会話履歴そのものは3環境間で共有されない。切り替える前に変更を保存し、テスト結果、判断理由、 未解決事項、次の一手を Git と docs/devlog/ に残す。切り替え後は git status、最新コミット、AGENTS.md、最新devlogを確認してから作業する。

仕様はOpenAI Codex Agent Skills、 Claude Code Skills、 Google Antigravity Skillsを参照。

---

🧱 技術スタック（概要）

層	技術	ポート
フロントエンド	Next.js 14 + React 18 + TypeScript 5	3000
バックエンド	FastAPI + uvicorn（Python）	8000
データ層	PostgreSQL 16 / Redis 7（Docker上）	5432 / 6379

重い処理は Python、画面は TypeScript という分業。 評価・スコア照合の Python 資産を流用するため、バックエンドを Python に寄せている。

各技術の詳細と選定理由 👉 docs/tech-stack.md

---

⚡ 開発環境の起動（ワンコマンド）

毎回コマンドを打ち分けずに、スクリプト1本で PostgreSQL 起動 → バックエンド起動 → Swagger UI を開くまで実行できる。

Windows

.\scripts\start-dev.ps1

Mac / Linux

./scripts/start-dev.sh

使い方・実行後に確認する事項のチェックリスト・つまずいたときの対処は 👉 docs/dev-startup.md

---

🔁 日々のルーチンワーク（まずここを見る）

開発を始める前・終えるときは、docs/daily-routine.md を開いてなぞる。

毎日やること

1. 前回の docs/devlog/ 最新ファイルで「翌日の計画」を確認
2. 環境を起動（上のワンコマンド → docs/dev-startup.md）
3. AGENTS.md の共通指示に従って開発（設計で迷ったら docs/arch-guide/）
4. テストを回す → git status で .env が出ないことを確認 → コミット＆プッシュ
5. 「今日の分を資産化して」 で devlog を作り、コミット＆NotebookLMへ

節目でやること（フェーズ完了・大きな機能追加のとき）

• CCAF適用率の再計測 → docs/arch-guide/coverage-remeasure-howto.md
• docs/roadmap.md の進捗更新
• docs/history/project-history.md に経緯を追記

適用率の再計測は毎日ではない。数値は機能が実装されて初めて動くため、 フェーズ完了などのトリガー時に測る。

---

必要なもの

• Node.js 18 以上（Next.js に必要）
• Python（開発環境の版は docs/tech-stack.md を参照）
• VS Code 1.98.0 以上
• Docker Desktop（PostgreSQL / Redis をコンテナで動かす）
• Claude Code または Codex（両方を併用可能）
• Anthropic の利用環境（Claude Codeを使う場合。対応プランまたはAPIキー）

初回セットアップ

2回目以降は上の「ワンコマンド起動」だけでよい。初回は次を実行する。

# 1. リポジトリのルートで、環境変数ファイルを用意
cp .env.example .env
#   → .env を開いて ANTHROPIC_API_KEY などを設定

# 2. バックエンドの仮想環境と依存関係
cd backend
python -m venv .venv
source .venv/bin/activate        # Windows: .venv\Scripts\Activate.ps1
pip install -r requirements.txt

# 3. フロントエンドの依存関係
cd ../frontend
cp .env.local.example .env.local
npm install

以降は scripts/start-dev.ps1（または .sh）でバックエンドまで起動し、 画面も見るなら別ターミナルで cd frontend && npm run dev（http://localhost:3000）。

Claude Code / Codex での開発の始め方

お使いのOSに合った手順書を参照すること（コマンドが異なるため）:

• Windows: docs/getting-started-vscode-windows.md
• Mac / Linux: docs/getting-started-vscode.md

要点（共通）：

1. VS Code で このフォルダ（ルート）を開く（File → Open Folder）
2. Claude Codeを使う場合は、拡張機能パネルで "Claude Code"（発行元 Anthropic） をインストールしてサインイン
3. Codexを使う場合は、Codexでこのリポジトリルートを開く
4. 「AGENTS.md と docs/product-design.md を読み、最新devlogを確認してから作業を始めて」と依頼

ディレクトリ構成

paper-repro/
├── AGENTS.md          ← AI開発指示の正本
├── CLAUDE.md          ← AGENTS.md への入口
├── README.md
├── docker-compose.yml ← PostgreSQL + Redis
├── scripts/           ← 起動スクリプト・検証スクリプト
├── backend/           ← FastAPI（Python）
├── frontend/          ← Next.js（TypeScript）
├── .agents/skills/    ← リポジトリスキルの正本
├── .claude/skills/    ← Claude Code 用の入口
└── docs/              ← 設計・要件・記録

docs/ 配下の構成と各文書の内容は docs/README.md を参照。 本書はファイル一覧を複製しない。

開発の進め方

docs/product-design.md の第6章「実装の着手順」と docs/roadmap.md に従い、 縦切りで進める。まず1論文が最後まで通る細い線を作り、そこに機能を足す。

---

🔗 関連プロジェクト

このプロジェクトは、Claude Certified Architect – Foundations（CCAR-F）で学んだ設計の型を、 実際のアプリ開発に適用する実践という位置づけを持つ。

リポジトリ	役割	このプロジェクトとの関係
ccar-f-study-skills	学ぶ — CCAR-F 試験対策の Custom Claude Skills 集	そこで学んだ型を、本プロジェクトで実際に適用している
paper-repro（本リポジトリ）	実践する — 学んだ型を適用したアプリ開発	適用方針は docs/arch-guide/、適用度は ccaf-coverage-*.md に記録

適用の記録

「どのノウハウを、開発のどの工程で、どこまで使ったか」を計測して残している。

• 設計指針: docs/arch-guide/README.md
• CCAF 5ドメインとの対応表: docs/arch-guide/ccaf-patterns.md
• 適用率インジケーター: docs/arch-guide/ の ccaf-coverage-YYYY-MM-DD.md

ライセンス

このプロジェクトは MIT ライセンスで公開している。詳細は LICENSE を参照。