archilang-floorplan

name	archilang-floorplan
description	archilang CLIで建築間取り図面（SVG平面図）を生成する。YAML仕様を書いてvalidate→fix→renderのループで図面を完成させる。ユーザーが「間取りを作って」「3LDKの図面」「archilangで描いて」「平面図を生成」「floor plan」「間取り図」「archilang」と言ったとき、または住宅の間取り・部屋配置・設備配置に関する図面作成を求められたときに使用する。部屋数やタイプ（LDK、寝室等）の指定があればそれに従い、なければヒアリングする。

archilang Floor Plan Generator

archilang CLIを使ってYAML間取り仕様からSVG平面図を生成するスキル。

前提

• archilangプロジェクト: /Users/akihito/Documents/my-life/.06_Projects/archilang/
• CLI実行: npx tsx src/main.ts （archilangディレクトリから実行）
• 出力先: ユーザー指定がなければ archilang プロジェクト内の output/ に保存

ワークフロー

Step 1: 要件ヒアリング

ユーザーの指示から以下を確認する。不足があれば質問する:

• 間取りタイプ: 1R, 2LDK, 3LDK, 4LDK 等
• 方位: 南向き、東向き等（デフォルト: south）
• 特別な要件: L字型、中庭、設備指定等

最低限「部屋数とタイプ」が決まれば着手できる。細かい寸法はこちらで適切に決める。

Step 2: グリッド設計

910mmモジュール（尺）でグリッドを設計する。目安:

間取り	典型的なグリッド	延床面積目安
1R	4×4	~13m²
2LDK	6×7	~35m²
3LDK	10×8	~66m²
4LDK	12×8	~80m²

部屋配置の原則:

• LDKは南面（採光確保）に配置し、最も広くする
• 水回り（浴室・トイレ・洗面）は北側にまとめる（配管集約）
• 寝室は静かな位置（LDKから離す）
• 玄関は方位（orientation）側に配置

Step 3: YAML生成

references/yaml-spec.md のYAML仕様に従ってYAMLを生成する。

出力先ファイル: /Users/akihito/Documents/my-life/.06_Projects/archilang/output/plan.yaml

YAML生成時の注意:

• archilang: "0.2" は必須
• openings: [] ではなくブロック形式で書く（solveコマンドとの互換性）
• 全ての部屋にドアを設ける（ROOM_WITHOUT_DOOR を避ける）
• 壁座標はグリッド整合させる（GRID_MISALIGNMENT を避ける）
• 設備は部屋サイズに収まるようにする（EQUIPMENT_OUT_OF_BOUNDS を避ける）

Step 4: validate → inspect → fix ループ

cd /Users/akihito/Documents/my-life/.06_Projects/archilang

# 1. バリデーション（JSON形式でfix_hint取得）
npx tsx src/main.ts validate output/plan.yaml --format json

# 2. ASCIIマップで空間確認
npx tsx src/main.ts inspect output/plan.yaml --ascii-map

# 3. エラーがあれば自動修正を試みる
npx tsx src/main.ts solve output/plan.yaml --out output/plan.yaml

# 4. 自動修正できないエラーはfix_hintを参考にYAMLを手動修正
# 5. 再度validate → エラー0になるまで繰り返す

ループの判断基準:

• errorCount: 0 になれば次のステップへ進む
• warning は許容（ただし OPENING_OVERLAP は修正推奨）
• 3回ループしても解決しない場合、残りのエラーをユーザーに報告して判断を仰ぐ

Step 5: レンダリング

cd /Users/akihito/Documents/my-life/.06_Projects/archilang

# SVG + HTML生成
npx tsx src/main.ts output/plan.yaml output/plan.svg

# 面積表も生成
npx tsx src/main.ts output/plan.yaml output/plan.svg --area-table

生成物:

• output/plan.svg — ベクター図面
• output/plan.html — ブラウザプレビュー
• output/plan.area.json — 面積表（--area-table 指定時）

Step 6: 結果報告

以下を報告する:

• 生成されたファイルのパス
• ASCIIマップ（最終版）
• 面積サマリー（部屋ごとのm²/畳数）
• 残りの warning があれば内容

設備配置ガイド

設備を配置する場合の目安:

設備	配置先	wall	position目安
kitchen_counter	LDK/キッチン	壁に沿って	offset: 0
unit_bath	浴室	north	offset: 0
toilet	トイレ	north	offset: 200
washbasin	洗面	east or west	offset: 0
washing_machine	洗面	washbasinと同じ壁	washbasinの隣
refrigerator	LDK/キッチン	kitchen_counterと直交する壁	offset: 0

設備サイズが部屋に収まらない場合は size でオーバーライドする。

トラブルシューティング

問題	原因	対処
UNREACHABLE_ROOM	ドアが外部に繋がっていない	玄関→廊下→各部屋の接続経路を確認
ISOLATED_SUBAREA	壁が部屋を完全分断	壁を短くするか、ドアを追加
EQUIPMENT_OUT_OF_BOUNDS	設備が部屋からはみ出し	size を小さくするか position を調整
SKIPPED_OPENING	共有壁が見つからない	connects の部屋IDが隣接しているか確認