# nanco-reports
nanco の **人に見せる用の HTML deliverables** を置くリポジトリです。月次レビュー、KPI ダッシュボード、戦略の共有版、decision-log の可視化、AI 引用テストの結果などを HTML で生成し、URL で共有できる形にまとめています。
---
## このリポジトリの位置づけ
- **SoT（単一ソース）ではありません。** 事実・トーン・戦略の原典は [`nanco-knowledge`](../nanco-knowledge) 配下の Markdown にあります。
- ここに置く HTML は **「読まれるためのスナップショット」** です。数字を更新するときは、原典の Markdown を直してから本リポジトリで再生成します。
- HTML を直接編集して数字を書き換えるのは NG です（SoT との不整合が起きます）。
- **例外は `labs/` だけ**（2026-10-07〜）。`labs//` は画像・図解の**探索の一次記録**（lab.md・manifest.json・ボード・サムネ・図解のソース）で、再生成できないサムネと選定の記録を持つ。ルールは knowledge（`skills/explore-illustration.md`）、生成画像の原本は Google Drive `Nanco/visual-lab/`。詳しくは [`labs/README.md`](./labs/README.md)。経緯: knowledge の `decision-log/2026-10-07-visual-lab-placement.md`
---
## 隣のリポジトリとの関係
```
~/Desktop/dev/
├── nanco-knowledge/ ← SoT（Markdown）。事実・トーン・戦略の原典
├── nanco-reports/ ← 本リポジトリ。HTML deliverables
├── nanco-next/ ← Web 本体
├── nanco-flutter/ ← Mobile 本体
├── nanco-hp/ ← LP / 公式サイト
└── nanco-analytics/ ← 計測基盤
```
HTML を生成するときは、Claude Code を本リポジトリで起動し、`--add-dir` で knowledge base を参照します:
```bash
cd ~/Desktop/dev/nanco-reports
claude --add-dir ../nanco-knowledge
```
これで Claude が原典の Markdown を読みながら、HTML スナップショットを生成できます。
---
## ディレクトリ構成
```
nanco-reports/
├── index.html ← ハブ（レポート一覧）
├── project-overview.html ← プロジェクト全体像（6層アーキ / 16 役者 / 7 Playbook）
├── strategy-master-plan.html ← マーケ マスタープラン v2.1
├── strategy-roadmaps.html ← 3 戦略ロードマップ
├── decision-log.html ← 判断履歴（全 35 エントリ索引 + 詳細カード 18 件）
├── kpi-dashboard-2026-05.html ← 月次 KPI ダッシュボード
├── ttv-deep-dive-2026-05.html ← TTV 深掘り
├── onboarding-*.html ← オンボーディング刷新 deliverables 一式
├── release-comms-2026-06.html ← 6月リリース発信パック（記事 + メール）
├── help-page-roadmap.html ← ヘルプ網羅化ロードマップ
├── daily-sync-YYYY-MM-DD.html ← 直近 3 日分の daily-sync（差分チェックリスト）
├── weekly-plan-*.html / *-schedule ← 週次・スケジュール系
├── labs/ ← 画像・図解・デッキの探索の一次記録（labs/README.md）
├── tools/
│ └── deck/ ← 動きで説明するデッキのエンジンと書き出し（tools/deck/README.md）
├── assets/
│ ├── nanco.css ← ブランド共通 CSS（ティールグリーン基調）
│ ├── reports-rail.css ← 左サイドの全ページ共通ナビ（rail）
│ └── ... ← ページ別 CSS（onboarding / ttv / weekly 等）
└── _archive/
└── daily-sync/ ← 4 日以上前の daily-sync を退避（05-15 〜 06-08）
```
> **共通ナビ（reports-rail）について**: 各 HTML の左サイドに同一の `