page

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-27
title: Hello
---
```
## 標準例(log)
出力時のコードブロック冒頭:
`<!-- File: src/content/ja/logs/2026-09-27-memo.md -->`
```yaml
---
date: 2026-09-27
title: 検討メモ
type: log
tags: [meta]
time: "10:00"
---
```