リファクタリング全項目完了と採番スクリプト疎通
v3 引き継ぎ書の残作業 C・F・G を全て片付けた。
完了したこと
C項: src/pages/[lang]/tags/[tag]/index.astro を新規作成。既存の types/[type]/index.astro を雛形に、列挙元を countByTag(all).keys() に、フィルタを e.tags.includes(tag) に差し替えただけ。詳細ページから既に張られていた tags リンクの切れを解消。
F項: ドキュメント6本を新仕様に整合。
docs/RULES.md: 4分類テーブルを type 自由文字列モデルに置換、scope廃止、v4変更履歴追加docs/SCHEMA.md: 「ID の扱い」節を新設し frontmatter にid:を書かない理由を明記、廃止フィールド一覧を集約docs/EDITORIAL.md: Categories固定表を撤廃し、gem出現順自動割当ルールに置換docs/FLOW.md: 旧ID命名(R-XXXX等)を消去、page_typeinfo/legal分岐を撤廃、Mermaidラベルをダブルクォート囲みで統一AGENTS.md/CLAUDE.md: 同一内容で、key facts+開発コマンド+ドキュメント導線を追記docs/2026-09-21-id-naming-convention.md: frontmatter からid/last_updated/supersedes等を削除、「frontmatter にidを書かない理由」節を追加
G項: scripts/new.mjs を配置、package.json の scripts に "new": "node scripts/new.mjs" を登録。疎通テストとして npm run new -- --lang ja --type reference --slug schema-migration-check を実行し、src/content/ja/reference/2026-09-22-schema-migration-check.md が生成されることを確認。動作確認用の生成ファイルは削除予定。
ビルド確認
最終状態で npm run build が 55 page 生成で完走。動作確認用に一時生成した記事(schema-migration-check の日英2件、new-script-test の1件)が含まれている。
天井の低いセッションの心得(メモ)
このリファクタは複数セッションをまたいだが、以下の運用で破綻せずに完走できた。
- 引き継ぎ書を毎回 v(N+1) として残す: 次のエージェントが 0 から状態を把握できる。特に「完了事項」「残作業」「基本設計(不変)」「重要ファイル一覧」の4節が効いた
- 想像でコードを書かせない: 「雛形の全文を貼れ」で受けてから確定パッチを返す運用。往復1回で済む
- 一括置換で往復数を削る: F項の5ファイル改訂を1メッセージで返した
- エラーは全文コピペ:
Missing script: "new"の debug ログを貼ったことで、package.json未登録が即座に特定できた
次回
リファクタとしては全項目完了。以降は運用モード。修正依頼時は該当ファイル全文を貼ることから始める。拡張候補([[id]] remarkプラグイン、backlink表示、related UI 表示、type別 RSS など)は引き継ぎ書 v4 に列挙済み。