Wikiアーキテクチャ

状態: 編集方針

編集方針

開発者用とプレイヤー用を分ける。
開発者用には仕様の正本、設計理由、未決事項を置く。
プレイヤー用は内部IDや設計上の議論を省き、遊び方として説明する。
1ページにつき1テーマを扱う。
標準Markdownと相対リンクを使う。
現行仕様と変更履歴を同じ説明内で混在させない。

構成

src/
  components/            Wiki用MDXコンポーネント
  assets/                Wiki掲載画像
  content/docs/
    index.mdx
    architecture/           編集方針
    developer/
      index.md
      planning/             企画・未決事項
      world/                世界観・用語集
      systems/
        combat/
          index.md                    戦闘の操作・進行
          damage-model.md             ダメージ計算・防御
        skill-building/
          index.md                    システム概要
          skill-cores.md              スキルコア
          grid-rules.md               配置・接続規則
          stream-model.md             論理ストリーム
          augment-catalog.md          オーグメント定義
          execution-model.md          評価・実行モデル
          propagation-and-costs.md    伝播強度・マナ
          elemental-interactions.md   属性反応
          build-examples.md           計算付きビルド例
        passives/            探索者パッシブ
        progression/         ラン・報酬
        stages/              ステージ・敵
      production/           対象範囲・検証シナリオ
      templates/            執筆テンプレート
    player/
      index.md
      getting-started/      初回の遊び方
      gameplay/             戦闘・進行
      skill-building/
        index.md                    盤面の組み方
        skill-cores.md              スキルコア一覧
        augments/
          index.mdx                 オーグメント一覧
        routing-and-merging.md      経路・分岐・合流
        elemental-interactions.md   属性反応
        build-examples.md           盤面ビルド例
      passives/              探索者パッシブ

設計状態

ラベル	意味
確定	現在の設計で前提として扱う
設計中	一貫した仕様案があるが検証前
未決	選択肢の比較または検証が必要

WikiはAstro Starlightでローカル表示する。通常ページはMarkdown、カード、図、絞り込みなどを使うページはMDXで作成する。公開・デプロイ設定は含めない。