Ordito Init

ordito-init

導入先リポジトリに Ordito の最小構成を生成する scaffold スキル（リファレンス実装の付加スキル, §7.4）。

いつ使うか / 使わないか

• 使う: 新しいリポジトリで Ordito を立ち上げるとき（社内開発者ドキュメントを repo 同梱 → GitHub Pages で配る初期化）。
• 前提: 先に .claude/skills/（と同梱エンジン）を配置済み（scripts/install-into.sh <target>）。
• 使わない: 既存の Ordito プロジェクトでページを足す（ordito-create-page）／HTML を作る（ordito-generate）。
• このスキルは 生成しない（§5.4）。scaffold 後に ordito-generate を案内する。

生成物（既存はスキップ、force:true で上書き）

• ordito.config.json（docs/ir / docs/site / docs/collection.json / template:{id:"dev-docs-standard"} / mode:"deterministic"）
• docs/ir/（IR ストア）と起点ページ docs/ir/guides/getting-started.json
• docs/collection.json（起点ページを掲載したナビ）
• .github/workflows/docs.yml（IR→HTML 生成 → 検証ゲート → GitHub Pages へデプロイ）

入力（JSON, すべて任意）

{ "title": "社内 API ドキュメント", "ir_dir": "docs/ir", "out": "docs/site", "mode": "deterministic" }

root(既定: repo ルート) / ir_dir / out / collection / template_id / mode / title / starter_page(既定 true) / workflow(既定 true) / force(既定 false)。

出力（JSON）

{ ok, root, created:[...], skipped:[...], next_steps:[...], generated:false }

実行

echo '{"title":"社内 API ドキュメント"}' | node "${CLAUDE_SKILL_DIR}/init.js"

next_steps に、初回生成・GitHub Pages の Source 設定・Enterprise Cloud の Pages アクセス制御（Org/SSO 限定）の手順が入る。