複数プロジェクトを横断・進化させる
ソリューションズ (Solutions) の機序

flowchart TD
  %% 始端・終端
    ROOT_START(["🚀 横断タスク開始"])
    ROOT_END(["🏁 横断タスク完了"])

  %% 人間側
    subgraph HUMAN["👤 人間の行う作業"]
        H_START(["開始"]) --> H_A1["「依頼書」を作成する"]
        H_A1 --> H_O1[/"「依頼書」"/]
        H_O1 --> H_O2[/"「開始合図」"/]
        H_O2 --> H_A2["作業開始を号令する"]
        H_A2 --> H_END(["終了"])
    end

  %% AIエージェント側
    subgraph MAIN["🤖 AIエージェントの仕事（ソリューションズ横断作業）"]
        M_START(["開始"])

      %% オブジェクト
        M_O_INST[/"「基本ルール」
solutionsInstruction.md"/]
        M_O_SKILL[/"「特定ジャンルルール」
solutionsSkill.md"/]
        M_O_IDX[/"「構造・機序説明」
solutionsIndex.md"/]
        M_O_REQ[/"「依頼書」
solutionsRequest.md"/]
        M_O_WORK_OLD[/"「ワークスペース」
※既存リソース"/]
        M_O_WORK_NEW[/"「ワークスペース」
※新規作成分"/]
        M_O_SCRIPT_OLD[/"「スクリプト」
※過去の再利用"/]
        M_O_SCRIPT_NEW[/"「スクリプト」
※新規生成"/]
        M_O_SCRIPT_README[/"「スクリプトREADME」
solutionsREADME.md"/]
        M_O_WORK_README[/"「ワークスペースREADME」
solutionsREADME.md"/]
        M_O_EXEC["AIが複数プロジェクトを横断して依頼を遂行する"]
        M_O_OUT[/"「成果物」
.solutionsOutput/"/]
        M_O_LESSON[/"「教訓（ワークファイル）」
.solutionsFeedback/"/]
        M_O_PROP_INST[/"「基本ルール改善提案」"/]
        M_O_PROP_SKILL[/"「特定ジャンル改善提案」"/]
        M_O_LETTER[/"「手紙（ガス抜き）」
.solutionsBrainstorming/"/]

      %% アクション
        M_A_INST["「基本ルール」を把握する"]
        M_A_SKILL["「特定ジャンルルール」を把握する"]
        M_A_IDX["「構造・機序」を把握する"]
        M_A_REQ["「依頼書」を把握する"]
        M_A_START["「依頼書」の内容に従い作業開始"]
        M_A_WORK_CHK[".solutionsWorkspace/solutionsREADME.mdをサーチし
既存リソースを確認"]
        M_A_WORK_NEW[".solutionsWorkspaceに新規リソースを作成"]
        M_A_WORK_USE["既存の.solutionsWorkspaceリソースを利用"]
        M_A_SCRIPT_CHK["「スクリプト」再利用の判定。
.solutionsScript/solutionsREADME.mdをサーチ"]
        M_A_SCRIPT_USE["過去の「スクリプト」を再利用
※修正可能"]
        M_A_SCRIPT_NEW["「スクリプト」を新規生成する"]
        M_A_LESSON["「教訓」を.solutionsFeedbackに出力する"]
        M_A_OUT["「成果物」を生成する"]
        M_A_SCRIPT_SAVE["今回の「スクリプト」を保存する"]
        M_A_SCRIPT_README_UPD[".solutionsScript/solutionsREADME.mdを更新する"]
        M_A_WORK_README_UPD[".solutionsWorkspace/solutionsREADME.mdを更新する"]
        M_A_PROP_INST["「基本ルール改善提案」を作成する"]
        M_A_PROP_SKILL["「特定ジャンル改善提案」を作成する"]
        M_A_LETTER["作業を振り返り「手紙」を
.solutionsBrainstormingに出力する"]

      %% ブランチ
        M_B_WORK{"外部ツールのインストールや
構造外作業が必要か?"}
        M_B_WORK_REUSE{".solutionsWorkspaceに
再利用可能なリソースがあるか?"}
        M_B_SCRIPT{"今回の作業は「スクリプト」
生成が必要か?"}
        M_B_SCRIPT_REUSE{"「スクリプト」再利用可能か?"}
        M_B_DONE{"作業完了したか?"}
        M_B_OUT{"「成果物」の生成が必要か?"}
        M_B_SCRIPT_SAVE{"新しい「スクリプト」を使用したか?"}
        M_B_WORK_SAVE{"新しい「ワークスペース」
リソースを使用したか?"}
        M_B_PROP_INST{"教訓から基本ルールの
改善提案が必要か?"}
        M_B_PROP_SKILL{"教訓から特定ジャンルの
改善提案が必要か?"}

      %% フロー接続（ノード直接接続）
        M_START --> M_O_INST --> M_A_INST --> M_O_SKILL --> M_A_SKILL --> M_O_IDX --> M_A_IDX --> M_O_REQ --> M_A_REQ --> M_A_START
        M_A_START --> M_B_WORK

        %% ワークスペース判定
        M_B_WORK -->|YES| M_A_WORK_CHK
        M_B_WORK -->|NO | M_A_SCRIPT_CHK
        M_A_WORK_CHK --> M_B_WORK_REUSE
        M_B_WORK_REUSE -->|YES| M_A_WORK_USE
        M_B_WORK_REUSE -->|NO | M_A_WORK_NEW
        M_A_WORK_USE --> M_O_WORK_OLD --> M_O_EXEC
        M_A_WORK_NEW --> M_O_WORK_NEW --> M_O_EXEC

        %% スクリプト判定
        M_A_SCRIPT_CHK --> M_B_SCRIPT
        M_B_SCRIPT -->|YES| M_B_SCRIPT_REUSE
        M_B_SCRIPT -->|NO | M_O_EXEC
        M_B_SCRIPT_REUSE -->|YES| M_A_SCRIPT_USE
        M_B_SCRIPT_REUSE -->|NO | M_A_SCRIPT_NEW
        M_A_SCRIPT_USE --> M_O_SCRIPT_OLD --> M_O_EXEC
        M_A_SCRIPT_NEW --> M_O_SCRIPT_NEW --> M_O_EXEC

        %% 作業遂行・完了判定
        M_O_EXEC --> M_B_DONE
        M_B_DONE -->|YES| M_B_OUT
        M_B_DONE -->|NO | M_O_EXEC

        %% 成果物生成
        M_B_OUT -->|YES| M_A_OUT
        M_B_OUT -->|NO | M_A_LESSON
        M_A_OUT --> M_O_OUT --> M_A_LESSON

        %% 教訓・改善提案
        M_A_LESSON --> M_O_LESSON --> M_B_PROP_INST
        M_B_PROP_INST -->|YES| M_A_PROP_INST
        M_B_PROP_INST -->|NO | M_B_PROP_SKILL
        M_A_PROP_INST --> M_O_PROP_INST --> M_B_PROP_SKILL
        M_B_PROP_SKILL -->|YES| M_A_PROP_SKILL
        M_B_PROP_SKILL -->|NO | M_B_SCRIPT_SAVE
        M_A_PROP_SKILL --> M_O_PROP_SKILL --> M_B_SCRIPT_SAVE

        %% 保存・後処理
        M_B_SCRIPT_SAVE -->|YES| M_A_SCRIPT_SAVE
        M_B_SCRIPT_SAVE -->|NO | M_B_WORK_SAVE
        M_A_SCRIPT_SAVE --> M_A_SCRIPT_README_UPD --> M_O_SCRIPT_README --> M_B_WORK_SAVE
        M_B_WORK_SAVE -->|YES| M_A_WORK_README_UPD
        M_B_WORK_SAVE -->|NO | M_A_LETTER
        M_A_WORK_README_UPD --> M_O_WORK_README --> M_A_LETTER

        %% ブレインストーミング
        M_A_LETTER --> M_O_LETTER --> M_END_NODE(["終了"])
    end

  %% 全体結合
    ROOT_START --> H_START
    H_END --> M_START
    M_END_NODE --> ROOT_END
          

sequenceDiagram
    participant HUMAN          AS 【人】
    participant AGENT          AS 【AIエージェント】
    participant ENTRYPOINT     AS 【開始合図】
solutionsEntryPoint.md
    participant INSTRUCTION    AS 【基本ルール】
solutionsInstruction.md
    participant SKILL          AS 【特定ジャンル】
solutionsSkill.md
    participant INDEX          AS 【構造図】
solutionsIndex.md
    participant REQUEST        AS 【依頼書】
solutionsRequest.md
    participant WORKSPACE      AS 【ワークスペース】
.solutionsWorkspace/
    participant SCRIPT         AS 【スクリプト】
.solutionsScript/
    participant TARGET_PROJS   AS 【各一般プロジェクト】
morimori_template 等
    participant OUTPUT         AS 【成果物・提案】
.solutionsOutput/
    participant FEEDBACK       AS 【教訓記録】
.solutionsFeedback/
    participant BRAINSTORMING  AS 【手紙】
.solutionsBrainstorming/
    
    HUMAN           ->> ENTRYPOINT     : 作業開始の号令
    ENTRYPOINT     -->> AGENT          : 読み込み指示
    AGENT           ->> INSTRUCTION    : 基本ルールの読み込み
    INSTRUCTION    -->> AGENT          : 
    AGENT           ->> SKILL          : 特定ジャンルルールの読み込み
    SKILL          -->> AGENT          : 
    AGENT           ->> INDEX          : 構造と機序の読み込み
    INDEX          -->> AGENT          : 
    AGENT           ->> REQUEST        : 依頼書の読み込み
    REQUEST        -->> AGENT          : 
    
    rect rgba(99, 102, 241, 0.15)
    loop ※依頼が完了するまで※ 
※コンテキスト維持上限が尽きるまで※
        AGENT           ->> WORKSPACE      : 既存リソースのサーチ・利用・新規作成
        WORKSPACE      -->> AGENT          : 
        AGENT           ->> SCRIPT         : 既存スクリプトのサーチ・利用・新規作成
        SCRIPT         -->> AGENT          : 
        AGENT           ->> TARGET_PROJS   : 複数プロジェクトを横断した調査・編集・操作
        TARGET_PROJS   -->> AGENT          : 
        AGENT           ->> OUTPUT         : 成果物や共有用ファイルの出力
        OUTPUT         -->> HUMAN          : 人によるレビュー・追加依頼
        HUMAN           ->> AGENT          : 【適宜】チャットでのフィードバック
    end
    end

    AGENT           ->> FEEDBACK       : 今回の教訓（lesson）を出力
    AGENT           ->> OUTPUT         : 教訓をもとに改善提案（instruction/skill）を出力
    HUMAN           ->> AGENT          : 完了の通知とお礼
    AGENT           ->> BRAINSTORMING  : 作業を振り返り、自由な手紙を出力
    BRAINSTORMING  -->> HUMAN          : 
    AGENT          -->> HUMAN          : 総括