Prompt Templates
いつも使うテンプレートをまとめる。
HTML Split/Bundle 規約
HTML プロジェクトを「分割ソース + ビルド」方式で実装する。共通ツールは配置済み、触らない: <repo>/scripts/html-build/{build,bundle,split,verify,audit-imports,smoke,to-js}.mjs
■ レイアウト- src/tools/{name}/ ← 編集する場所(SSOT・非公開) manifest.json index.html dev 形式テンプレート styles/*.css js/*.{js,ts,tsx}- public/tools/{name}/ ← 配信する場所(bundle のみ) index.html build.mjs の出力(手で編集しない)
■ マーカー(1 行目厳守・BOM なし・先頭に空行なし)- CSS: `/* === @file: styles/NN-name.css === */`- JS: `// === @file: js/NN-name.js ===`- TS: `// === @file: js/NN-name.ts ===`- 2 行目以降に directive: // @import: { name } from './NN-other.ts'; // @export: name1, name2
■ 最重要ルールdirective (`// @import:` / `// @export:`) と実コード (`import` / `export`) を1:1 で対応させる。片方だけ書いてはいけない。
❌ // @import: { Store } from './50-storage.ts'; export function foo() { Store.get(...); } // 実 import なし
✅ // @import: { Store } from './50-storage.ts'; import { Store } from './50-storage.ts'; export function foo() { Store.get(...); }
■ コーディング- import は 1 行ずつ(複数行禁止)- export は実コードに書く(bundle で除去される)- トップレベル副作用禁止。boot() に集約し entry 末尾で boot() を呼ぶ- トップレベル名はプロジェクト全体で一意(bundle で 1 スコープになるため)- ファイル末尾は LF で 1 改行- テンプレートリテラル内に @file / @import を書かない- 循環依存禁止- ミニファイしない
■ index.html (src/tools/{name}/index.html)- dev 形式: <link rel="stylesheet" href="./styles/NN-name.css"> と <script type="module" src="./js/NN-boot.js"></script>- 最初は .js で書く(.js なら /src/ がブラウザで動く)。 必要になったら .ts に移行(dev ESM は動かなくなる。7.4 節参照)。
■ manifest.json (src/tools/{name}/manifest.json){ "name":"{name}", "template":"index.html", "styles":["styles/*.css"], "scripts":["js/*.js"], "entry":"js/90-boot.js", "output":"index.html", "recovered":"src-recovered", "tmp":"tmp", "marker":{"file":"=== @file:"} }
■ 自己検証(すべて exit 0 が前提) node scripts/html-build/build.mjs --project {name} node scripts/html-build/smoke.mjs --project {name} npm run typecheck # TS のみ
■ 出力各ファイルをコードブロックで出力。直前にパスを明記。
■ 要件(ここに個別要件を書く)extract-from-md v6 仕様書 / エージェント指示 / マニュアル
## 出力フォーマット(厳守)
1 ファイル = 1 見出し + 1 コードブロック。説明文はコードブロックの外。
### 形式
## `relative/path/to/file.ext`
```<lang> // === @file: relative/path/to/file.ext === <ファイルの完全な内容> ```
### ルール
1. 見出しは H2 (`##`)。パスはバッククォートで囲む。2. フェンスは三連バッククォート。言語タグ必須。3. コード本体の 1 行目に @file マーカー。推奨形式は `===` 装飾付き: JS/TS : // === @file: js/00-main.js === CSS : /* === @file: styles/00-base.css === */ HTML/XML : <!-- === @file: index.html === --> Python/Sh : # === @file: setup.py === SQL : -- === @file: db/schema.sql === 装飾なし (`// @file: js/00-main.js`) や空白区切り (`// @file js/00-main.js`) も受理されるが、`===` 装飾付きを推奨(HTML bundle 規約と一致)。 1 行目厳守。先頭に空行を入れない。BOM を付けない。4. パスは相対のみ。`./` 不要、`..` 禁止、絶対パス禁止。5. 1 ファイルは 1 コードブロック。省略記号 (`...`) 禁止。6. 途中で切れる場合、必ず `// @part: n/m` を 2 行目に。最終パートに `// @end`。7. 末尾に「確認コマンド」「実行方法」等を書く場合、必ず ```bash 等の 非ファイル言語タグを付ける。8. コードブロック内に説明・diff・チェックリストを書かない。
### 自己検証
生成後、以下が exit 0 になること: node scripts/extract-from-md.mjs <output.md> --dry --verbose (--out 未指定なら <output>/out/ に書かれる)Frontmatter Schema 短縮版の導入
# Frontmatter Schema (Short)
## 出力ルール(重要)コードブロックの1行目に必ずファイルパスをHTMLコメントで記述する:```<!-- File: src/content/ja/{type複数形}/YYYY-MM-DD-slug.md -->```- パスは複数形: `decisions` / `references` / `logs` / `pages`- 言語: `ja` または `en`- 例: `<!-- File: src/content/ja/logs/2026-09-27-handover-note.md -->`
## 必須- `date`: YYYY-MM-DD(初版作成日)- `title`: string
## 任意- `type`: `decision` / `reference` / `log` / `page` など自由文字列- `tags`: string[](小文字ハイフン繋ぎ)- `related`: string[](他記事の id 配列)- `status`: 自由文字列(バッジ表示) - decision: `proposed` / `decided` / `superseded` / `deprecated` - reference: `seed` / `growing` / `evergreen` - page: `draft` / `published`- `description`: string(SEO/OGP、結論が分かる要約)- `time`: "HH:MM"(同日ソート補助)- `updates`: date[](更新履歴、末尾追記)- 可視性フラグ(無効を優先で OR): - `nobuild: true` — ビルド対象外(404) - `nolist: true` — 完全ステルス(URL直打ちのみ、RSS/sitemap/検索/wikiリンク全除外、noindex) - `unlisted: true` — 一覧から除外(トグルONで表示)。RSS/sitemap/検索は通常、SEO通常 - `noindex: true` — noindex + sitemap除外 + Pagefind除外(一覧・RSSには出す)
## type 使い分け- `reference` — 仕様書、マニュアル、参照ドキュメント(長寿命・更新される)- `log` — メモ、引き継ぎ書、作業記録(時点の記録・時系列)- `decision` — ADR(選択の理由・supersede 関係あり)- `page` — About・規約等のサイト運営メタ(`unlisted: true` 明示)
「何について」は type ではなく `tags` で表現する。
## ID とファイル名- ファイル名 basename が id(`id` は frontmatter に書かない)- 命名推奨: `YYYY-MM-DD-slug.md`(`about.md` 等の日付なしも可)- basename は `^[a-z0-9][a-z0-9-]*$`- URL: `/{lang}/{id}/`
## 他記事参照- 本文中は `[[id]]` プレースホルダーを使用- 未存在・`TBD:` 明示は無効表示になる
## 最小例```yaml---date: 2026-09-27title: Hello---```
## 標準例(log)出力時のコードブロック冒頭:`<!-- File: src/content/ja/logs/2026-09-27-memo.md -->`
```yaml---date: 2026-09-27title: 検討メモtype: logtags: [meta]time: "10:00"---```