Markdown を唯一の正とする、報告用スライド専用のパワポエディタ。汎用性より作業効率を優先する。
serializeDeck 経由で Markdown を書き換える操作として実装する。
スライド番号・章番号は Markdown に書かない。renderDeck が毎回導出する。masters.dir、既定 ~/.config/mdslide/masters/）に置き、資料は frontmatter master: 名前.pptx で選ぶ。
解決順は frontmatter → 資料フォルダの master.pptx → 設定の既定（resolveMasterId）。黙って先頭を選ばない。IndexedDB は使わない（ADR-0013）。Cover / Agenda / Section / Body-Text / Body-2col（大文字小文字と空白は無視、先頭一致で別名も通る）。判定は roleFromLayoutName。
画像スライドはマスターに専用レイアウトを持たせず、Body-Text の上に src/layouts/geometry.ts の計算で配置する。
プレビューと Python 出力は同じ幾何（deck.json の geometry、EMU）を共有する。幾何を変えるときは geometry.ts とテストを直す。本文を入れる枠も同じ規則で選ぶ（bodyPlaceholders と export_pptx.py の body_placeholders。面積の大きい枠から、2 段は左から。ADR-0023）。
プレビューはマスターの装飾（背景・画像・単色図形・固定文字・フッター類）とテーマのフォント・文字色も描く（importMaster の decor / style、ADR-0017）。グラデーション・効果・SmartArt は近似か省略で、忠実な描画は PowerPoint 側。書き出しは日付・フッター・スライド番号のプレースホルダーをレイアウトから複製する。
本文量の見積もりはマスターの行間・段落前後の間隔・内側余白を使い、本文はマスターのヘッダとフッタの手前に収める（contentBand、ADR-0018）。余白を利用者に書かせない。.md の親フォルダがワークスペース。ファイル名は Workspace.deckFile（既定 deck.md。フォルダを開いたとき・「新しく作る」でフォルダを選んだときはこの名前。ADR-0015）で、deck.md をコードに直書きしない。
images/ / master.pptx / deck.json / out/deck.pptx / notes/ はその隣に置く。
起動直後は起動画面（StartScreen）。サンプルは「サンプルを見る」でだけ表示し、黙って出さない。
ファイル I/O は src/workspace/workspace.ts の Backend インターフェースに閉じ込める。
Electron では main プロセス（Node fs + chokidar 監視 + Python 起動）、ブラウザ版では File System Access API（Chromium のみ、ポーリング）。
レンダラから直接 Node API を触らない。IPC の窓口は electron/preload.ts のみ。
レンダラは sandbox と CSP（vite-csp.ts）の下で動かし、新しいウィンドウと画面遷移は止める。main のファイル系 IPC は、開いたフォルダ・マスターの保管フォルダ・設定ファイルの中だけを扱う（electron/paths.ts）。deck.md の画像も資料フォルダの中の相対パスだけ（src/model/imageSrc.ts と export_pptx.py の asset_path。ADR-0026）。
外部（Claude Code 等）が deck.md を書き換えたら、未編集なら自動再読み込み（ビューアモード）。serializeDeck(parseMarkdown(md)) は末尾改行の正規化を除き md と一致する。tests/unit/model.test.ts を壊さない。src/index.css の :root に集約。色・角丸・影はすべて CSS 変数経由。ライト/ダークは light-dark() で色を一度だけ書き、既定はシステムに従う。設定の外観（appearance.theme）で固定でき、<html data-theme> と Electron の nativeTheme が追従する（ADR-0014）。.toolbar .btn（.primary .quiet）.select .segmented > .seg（.on）.link .banner（.info .warn）.navigator .nav-item .stage .editor .sheet .card。
新しい UI はこれらを使い、インラインの色指定を増やさない。#0a84ff、装飾は影と余白だけ。絵文字・下線リンクは使わない。src/components/Icon.tsx の単色ラインアイコン（SF Symbols 風、20px グリッド、currentColor）だけを使う。画像やアイコンフォントは入れない。
アイコンだけのボタンは .btn.icon（ペインの開閉状態は .on）にし、必ず aria-label（テストと E2E が名前で探す）と data-tip（ホバーやキーボードで移動したときに出る説明。ショートカット併記。表示は Tooltips）を付ける。操作の説明にネイティブの title は使わない（表示までが遅い）。切れた長い文字の全文表示だけは title でよい。文字ボタンにアイコンを添えるときは .btn.with-icon。.vsplitter のドラッグで変え、settings.json に記憶する（navigator.width / editor.width）。hiddenInset + vibrancy: sidebar。body.electron で背景を透過し、サイドバーとツールバーが透ける。EditorPane.tsx の HighlightStyle で CSS 変数に解決する。src/model/ imageSrc.ts (画像参照の判定。フォルダの中の相対パスだけ読む。ADR-0026) imageProcess.ts (貼り付け画像の縮小・形式判定。Chromium の OffscreenCanvas 前提、無ければ原本) fit.ts (表示行モデル。行の高さと段落間隔はマスターから。書き出しの警告は deck.json の fit を使い、Python 側 display_lines は予備として対で保つ) boxes.ts (レイアウトごとの本文枠 pt。内側余白と行間・段落間隔、ヘッダ・フッタを避ける contentBand、重なりの警告 bodyOverlaps) refs.ts (Claude Code 向け参照 deck.md:行 / 画像パス) parser.ts (parse/serialize/move/withAttr) render.ts (numbering, agenda, auto-split) dnd.ts (ドロップ先の判定。章は章の間にだけ落ちる) template.ts (「新しく作る」の空の枠。ADR-0015) types.ts
src/master/ importMaster.ts (pptx zip → layouts/placeholders、本文の枠の選び方 bodyPlaceholders、マスターとレイアウトの装飾 decor・背景・プレースホルダーの見た目 style、テーマ色の解決 parseColor) masterSource.ts (保管フォルダ / メモリのマスター一覧・取り込み) sampleMaster.ts (examples/sample-master.pptx をバンドルし、設定の「見本を取り込む」で保管フォルダへ)
src/store/ deckStore.ts (zustand。markdown 以外はすべて派生値)
src/sample.ts 「サンプルを見る」の組み込みサンプル（E2E が章・スライド名を前提にする）
src/components/ App (ツールバー・ペイン幅) / StartScreen (起動画面: Markdown を開く・新しく作る・フォルダ・最近・サンプル) / ThumbnailPane (DnD、↑↓ で選択、⌥↑↓ で並べ替え) / PreviewPane (レイアウト選択) / SlideCanvas (スライド描画) / EditorPane (CodeMirror + Vim) / SettingsSheet (設定シート: 一般・エディタ・マスター・書き出し・ツール。開くのは useSettingsSheet。ADR-0014 / ADR-0019) / Icon (単色ラインアイコン) / Tooltips (data-tip のホバー説明)
src/export/ exportJson.ts (deck.json 契約 v2: slideSize, geometry 付き) python.ts (起動時の Python 確認の状態と、入れ方のコマンド)
src/layouts/ geometry.ts (画像/本文の配置計算) presets.ts (マスター無し時の既定枠)
src/settings/ settings.ts (settings.json の読み書き。設定は必ずここを通す。ADR-0010)
src/console/ presets.ts (CLI プリセット) terminalStore.ts (端末セッション状態。前面がツールかシェルかの判定 toolInForeground) toolsStore.ts (CLI ツールのプリセットと設定) agentsMd.ts (フォルダ用 AGENTS.md と、それを @import する CLAUDE.md。ADR-0016)
src/console/ prompts.ts (端末に流す定型プロンプト。1 行ずつ。シェルが解釈する記号を含む名前は渡さない) inboxStore.ts (notes/ への下書き自動保存)
src/settings/appearance.ts (外観: <html data-theme> と Electron の nativeTheme。CSS は light-dark() で色を一度だけ書く)
src/components/InboxDrawer.tsx (素材の受け入れと AI への指示。ADR-0012) editorGuides.ts (区切り線・ゲージ・分割マーカーの装飾)
src/components/TerminalPane.tsx (xterm.js 端末) HelpSheet.tsx (使い方。初回起動で自動表示、⌘/)
electron/main.ts (ウィンドウ・アプリメニュー・IPC ハンドラ、settings.json と保管フォルダの場所、書き出しの起動) electron/preload.ts (レンダラに出す唯一の API。sandbox のため CommonJS でビルド) electron/paths.ts (IPC で扱えるパスの判定。リンクを解決して比べる。ADR-0026) electron/pty.ts (node-pty / ホスト中継。前面のプロセス名) electron/ptyHost.cjs electron/python.ts (書き出し用 Python の検出。python-pptx の有無を確かめ、Command Line Tools の無い Mac では /usr/bin/python3 を実行しない。ADR-0019)
src/workspace/ workspace.ts (フォルダ I/O、Markdown ファイルの入口と最近一覧、画像保存、外部変更検知) bootstrap.ts (AGENTS.md / CLAUDE.md / theme.json / tools/mdslide_draw.py / notes/ の生成) history.ts (.mdslide/history/ スナップショットと undo)
src/components/editorExtensions.ts (画像貼り付け/ドロップ、スニペット Ctrl-Space、]] [[ 見出し移動、Mod-s / :w 保存)
tools/ export_pptx.py (deck.json + master.pptx → out.pptx, python-pptx。画像は --assets の中だけ) mdslide_draw.py (theme.json 準拠の図生成。ワークスペースに配布)
docs/ markdown-spec.md, master-guide.md (マスター pptx の作り方と AI 用プロンプト。紹介ページの同節と内容を揃える), testing.md, adr/, backlog.md, media/ (README のデモ GIF とコンセプト図、紹介ページのカルーセル画像 tour/)
.github/pages/ index.html (GitHub Pages の紹介ページ。Tailwind / Lucide は assets/ に置いたものを integrity 付きで読む単一ファイル。サイトのトップに置かれ、README は README.html になる) _config.yml (Jekyll)
.github/workflows/ ci.yml (unit: ubuntu で型・カバレッジ・Python・Web E2E / electron-mac: install.sh のテストと Electron E2E) release.yml (v* タグ。build が dmg / zip を作って署名・インストール・ライセンス表示・fuses を確かめ、publish が下書きに添付してから公開。ADR-0027) pages.yml (紹介ページ・README・docs・install.sh を Pages へ。ADR の目次も作る)。依存の更新は .github/dependabot.yml。CI は `npm ci --ignore-scripts`、checkout はトークンを残さず、action は SHA・runner は版で固定
scripts/ install.sh (配布版を入れる。Releases の zip を https で取り、GitHub が記録した sha256 と署名を確かめて /Applications へ、版を固定した python-pptx を wheel だけで venv へ。Pages の直下に置く。ADR-0022) make_demo_gif.py (実アプリを CDP で操作して README のデモ GIF を再生成) make_tour_images.py (同じく実アプリを操作し、紹介ページのカルーセル画像 docs/media/tour/*.webp を撮る) make_icon.py (docs/media/icon.svg から build/icon.png・icon.icns を生成) make_sample_master.py (examples/sample-master.pptx を python-pptx の既定テンプレートから 16:9 で作る。ADR-0023) make_decorated_master.py (見本に Pillow の生成画像などの装飾を足して examples/decorated-master.pptx を作る)
build/ icon.png / icon.icns (アプリアイコン。electron-builder と開発時の Dock が使う。元は docs/media/icon.svg)
SECURITY.md (脆弱性の知らせ方と配布物の確かめ方) THIRD_PARTY_NOTICES.md (同梱物のライセンス表示と商標。配布アプリの licenses/ にも入れる。ADR-0028) vite-csp.ts (ビルドしたページの CSP。ADR-0026)
tests/helpers/ fakeFs.ts (File System Access API のメモリ版。ブラウザ版の Backend とストアのテスト用) decoratedMaster.ts (見本 pptx に装飾の OOXML を足す。ADR-0017)
examples/ sample-master.pptx（レイアウト名規約の見本。16:9、役割ごとに本文の枠は決まった数。scripts/make_sample_master.py で生成） decorated-master.pptx（ロゴ・帯・画像の表紙・フォント変更を足した見本。プレビューと書き出しの確認用。scripts/make_decorated_master.py で生成）
npm ci # postinstall で node-pty を electron-rebuild（失敗してもホスト中継にフォールバック）
pip install -r requirements-dev.txt # 実行時のみなら requirements.txt
npm run dev # Electron（electron-vite dev）
npm run dev:web # ブラウザ版 http://localhost:5173（Chromium 限定）
npm test # vitest（単体＋内部結合）
npm run test:watch
npm run test:coverage
npm run test:py # tools/ の pptx 出力と図、scripts/install.sh（macOS のみ）
npm run test:e2e # Web E2E（headless Chromium）
npm run test:e2e:electron
npm run test:all
npm run typecheck
npm run build # Electron → out/
npm run build:web # ブラウザ版 → dist/（静的配布可能）
npm run dist:mac # dmg / zip（アドホック署名、公証なし）→ release/
npm run rebuild # node-pty を electron-rebuild し直す
python3 tools/export_pptx.py deck.json --master master.pptx -o out.pptx --assets ./images-root
electron/pty.ts：node-pty をこのプロセスで読み込む。読めなければ electron/ptyHost.cjs をシステム node で起動して中継（ADR-0009）。src/console/terminalStore.ts：セッション状態と設定（開閉・高さ・選択中のツールの自動起動）。src/components/TerminalPane.tsx：xterm.js。SettingsFile と DEFAULT_SETTINGS に項目を足し、localStorage を直接使わない。UI は SettingsSheet のタブに置き、メイン画面（ツールバー・コンソールバー）に設定コントロールを置かない（ADR-0014）。コンソールバーの「起動するツール」の選択は起動操作の一部として残す（ADR-0024）。frontmatter を書き換える「資料の設定」（この資料のマスター、レイアウト）は別で、メイン画面に残す。presets.ts の PRESET_TOOLS。プリセットを増やすときはコマンド名が公式のものであることを確認する。AGENTS.md（規約）と CLAUDE.md（@AGENTS.md の 1 行）、theme.json tools/mdslide_draw.py notes/ を用意する（src/workspace/bootstrap.ts）。Markdown 規約を変えたら agentsMd.ts も更新する。規約は AGENTS.md にだけ書き、CLAUDE.md には書かない（ADR-0016）。src/console/prompts.ts。1 行で書く（端末に 1 メッセージとして流す）。electron-builder.yml の asarUnpack と postinstall を更新する。docs/testing.md。npm run test:all が通ることを PR の条件にする。vitest.config.ts）。閾値を下げてはいけない。tests/unit/workspace.test.ts masterSource.test.ts appearance.test.ts exportTab.test.tsx など）でブリッジ呼び出しを、tests/e2e/test_electron.py で実機を確かめる。main から送るイベント（アプリメニューの app:open-settings など）は tests/integration/electronApp.test.tsx で確かめる（ADR-0024）。tests/python/ を先に更新する。deck.json の契約変更は version を上げる。src/model）を変更したら必ずテストを追加・更新する。UI より先にモデルで振る舞いを確定する。deck.json の契約（ExportDeck）を変えるときは version を上げ、Python 側の検証も更新する。docs/backlog.md の順。ADR は docs/adr/ に追記（番号連番、既存は変更せず supersede）。docs/markdown-spec.md の規約で deck.md を書く。番号は書かない。図は ![TODO 説明]() のプレースホルダで置き、人が後から貼り付ける。images/ に PNG を書き、 で参照する。