# Portability: UNIVERSAL
# Last validated: 2026-05-17
# Next review: 2027-05-17

BACH CORE CONCEPT
=================

「エージェントは役割であり、その中での目標指向の意図です。
ワークフローは実行のための頭脳です。
スキル、ツール、サービスは実行のためのツールです。
これらは共にコアとなります。"

四本の柱
----------------

''`
┌─────────────────────────────┐
│ コア │
---------------------------------------------------------------------- ─--------------------------------------------------------┤
│ │
│ ┌─────────┐ ┌─────────┐ ┌───────────┐ │
│ │ エージェント │ │ ワークフロー │ │ スキル/ツール/SVC │ │
│ │ │ │ │ │ │
│ │ 役割 + │───>│ 頭脳 │───>│ 道具 │ │
│ │ 意図 │ │ 制御 │ │ 実行 │ │
│ │ │ │ │ │ │
│ │ 誰 + なぜ│ │ どのように │ │ 何をどうする │ │
│ ━━━━━━━━━━━━━━━━━━━┘ ━━━━━━━━━┘ ━━━━━━━━━━━━━━━━━━━━━━━━━━━┘ │
│ │
━━━━━━━━━━━━━━━━━━━━━━━━┘
```

エージェント = 役割 + 目標指向の意図
---------------------------------------

- このタスクにおける私は誰ですか?
- なぜ私はこれをしているのですか？ (目標、動機)
- 視点と意思決定の枠組みを定義する

例:
  - 開発者エージェント: コードの作成、デバッグ、テスト
  - パーソナルアシスタント: ユーザーの日常生活をサポートします。
  - 研究専門家: 情報を検索して評価します

保管場所: Agents/*.txt

ワークフロー = 実行のための頭脳
---------------------------------

- タスクはどのように実行されますか?
- プロセス、順序、決定を制御します
- 手順に関する知識: 段階的な説明

例:
  - バグ修正ワークフロー: 再現 -> 分析 -> 修正 -> テスト
  - レビューのワークフロー: 読む -> 評価 -> コメント -> 決定
  - 起動ワークフロー: チェック -> ロード -> 初期化 -> 準備完了

保管場所: skill/workflows/*.md

次の理由により、ワークフローは中央にあります。
  1. あなたが実際のコントロールを引き継ぎます
  2. スキル、ツール、サービスを調整する
  3. テスト可能 (ユースケース テスト)
  4. 再利用可能です

スキル / ツール / サービス = ツール
-------------------------------------

- タスクは何で実行されますか?
- 特定のスキルと機能
- ワークフローによって呼び出されます

|タイプ |説明 |場所 |
|----------|--------------------------|----------------------------|
|スキル |知識 + 手順 (.txt) |スキル/*.txt |
|ツール | Python スクリプト (.py) |ツール/*.py |
|サービス|外部サービス | API/CLI 経由 

|INTERPLAY
-------------

```
ユーザーリクエスト
     │
     v
┌─────────┐
│ エージェント │ 「私は開発者です。目標: バグを修正することです。」
━─────────┘
     │
     v
┌─────────┐
│ ワークフロー │ 「1.再現 2.分析 3.修正」
━─────────┘
     │
     v
┌───────────────────┐
│ スキル / ツール / サービス │
│ - debugger.py (ツール) │
│ - git-workflow.txt (スキル) │
│ - テストランナー（サービス） │
━━━━━━━━━━━━┘
     │
     v
結果
```

LLM 認識
-------------------

動作中の LLM は次のことを認識している必要があります:
1. 存在するエージェント (agents/)
2. 利用可能なワークフロー (スキル/ワークフロー/)
3. どのようなスキル/ツール/サービスがあるか (スキル/、ツール/)

これは次のようにして実現されます。
- ハンドラーレジストリ (system/core/registry.py) - ハンドラーの自動検出
- Tool-Auto-Discovery (tools/tool_auto_discovery.py) - ツールを DB にスキャンします
- DBエントリ（ツールテーブル、hierarchy_items）
- 起動の概要にはセッション コンテキストが表示されます

参照: --help 起動、--help ツール

品質保証 (ワークフロー-TUEV)
-----------------------------------

ワークフローは非常に重要であるため、確認する必要があります:

1。ユースケーステスト
   - テストケースをDBに収集
   - 自動実行
   - 評価: 非常に良い / 良い / 満足 / 十分 / 失敗

2. TUEVの手順
   - ワークフローには有効期限があります
   - 有効期限が切れた場合: メンテナンスタスクを自動的に作成します
   - 確認後: 新しい有効期限を設定

3.新しいコンポーネントのチェックリスト
   [ ] ユーザーデータがなくても動作しますか?
   [ ] CLI コマンドは使用できますか?
   [ ] ファイル/フォルダからの入力は可能ですか？
   [ ] 構造化DBに出力しますか？
   [ ] スキャン/インポートは反復可能 (冪等) ですか?
   [ ] ハードコードされたパスはありませんか?

参照: WF-TUEV タスク (開発中)

関連概念
------------------

- docs/help/memory.txt - 認知モデルとしての記憶
- docs/help/agents.txt - エージェント システムの詳細
- docs/help/workflow.txt - ワークフロー システムの詳細
- docs/help/skills.txt - スキル階層
- docs/help/tools.txt - ツール システムの詳細
- system/ARCHITECTURE.md - 全体的なアーキテクチャ

---
バージョン: 1.0.1 |作成日: 2026-01-30 |更新日: 2026-02-08
(中心概念: エージェント/ワークフロー/スキル/ツール)
