xichia/novel-framework

novel-framework は何をしますか？

小説開発のためのGitスタイルフレームワーク。カノン、ブランチ、決定ログ、エージェントスキル、可逆的なストーリーアーキテクチャを提供します。

概要

xichia/novel-frameworkは、小説執筆プロセスにバージョン管理のベストプラクティスを取り入れます。ストーリーを「カノン」（正史）として管理し、プロットの分岐を「ブランチ」で扱い、すべての重要なストーリー上の決定を「決定ログ」として記録します。

主な機能

• カノン管理: 正史となるストーリーラインをmainまたはcanonブランチで管理
• ブランチ戦略: 実験的なプロット、代替エンディング、サイドストーリーを独立したブランチで開発
• 決定ログ: すべてのストーリー上の決定をコミットとして記録し、必要に応じて元に戻せる
• エージェントスキル: AIアシスタントが実行可能な執筆タスクをスキルとして定義
• 可逆的アーキテクチャ: いつでも以前の状態にロールバック可能

対応プラットフォーム

• Claude Code
• Cursor
• Codex
• その他のAIエージェント

インストール方法

# リポジトリをクローン
git clone https://github.com/xichia/novel-framework.git
cd novel-framework

# 必要な依存関係をインストール
pip install -r requirements.txt

クイックスタート

1. 新しい小説プロジェクトを作成:

   novel-framework init my-novel
   cd my-novel
   

2. カノンブランチに切り替え:

   novel-framework checkout canons
   

3. 最初の章を追加:

   novel-framework chapter add "プロローグ"
   

4. 決定をコミット:

   novel-framework commit -m "プロローグのストーリー決定: 主人公の年齢を25歳に設定"
   

エージェントスキルの使用例

キャラクター設定の生成

@skill character-generator create --archetype "ヒーロー" --personality "勇敢, 衝動的"

プロットの矛盾チェック

@skill plot-checker analyze --branch feature/alternate-ending

設定

novel.yamlでプロジェクト設定を行います:

project:
  name: "my-novel"
  author: "著者名"
  canon_branch: "canon"
  decision_log:
    enabled: true
    format: "markdown"
  agent_skills:
    - character-generator
    - plot-checker
    - dialogue-polisher

ライセンス

MIT