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

BACH ドキュメント - 概要
================================

すべての BACH ドキュメントの中央連絡窓口。

コア ドキュメント
--------------

ルート レベル:
  SKILL.md マスターコンテキスト、アイデンティティ、行動ルール
  README.md プロジェクト概要

system/:
  ARCHITECTURE.md 技術アーキテクチャ、コンポーネント
  ROADMAP.md の開発計画、マイルストーン
  CHANGELOG.md バージョン履歴、変更点

ヘルプ システム (system/docs/help/)
--------------------------

呼び出し: python bach.py --help <トピック>

コンセプト:
  --help コアのコアコンセプト (エージェント/ワークフロー/スキル/ツール)
  --ヘルプメモリ記憶システム（5つの認知タイプ+学習回路）
  --help インジェクター インジェクター システム (自動ヒント)
  --help 統合 統合 (圧縮、減衰、ブースト)
  --help 起動起動ログ

システム:
  --help タスク タスク管理
  --help レッスン レッスン学習システム
  --help パートナー パートナー システム (マルチ LLM)
  --help デーモン デーモン サービス

時間:
  --help Clock 時間表示
  --ヘルプタイマーストップウォッチ
  --help countdown トリガーによるカウントダウン
  -- チェック間のヘルプ
  --統一時間システムの克服に貢献

開発:
  --開発開発ワークフローのヘルプ
  --help usecase ユースケース テスト
  --help バグ修正 バグ修正ログ
  --ヘルプ コーディング コーディング標準

ディレクトリ:
  --help list 利用可能なすべてのトピック

機能 (v1.1.85 以降):
  --help エージェント/<名前> エージェントのドキュメント (例: --help エージェント/ati)
  --help workflow/<名前> ワークフロー ドキュメント
  --help Expert/<名前> エキスパート ドキュメント
  --help <tool_name> DB からのツール情報

SKILLS HIERARCHY (system/skills/)
-----------------------------------

  エージェント/エージェント プロファイル (役割)
  スキル/ワークフロー/ワークフロー定義 (22 ワークフロー)
  エージェント/_experts/ エキスパート構成
  スキル/_services/ サービスの説明
  スキル/_templates/ テンプレート
  パートナー/パートナー LLM 構成
  コネクタ/外部接続
  skill/_os/ OS 固有の設定

DOCS フォルダー (docs/)
-------------------

  ドキュメント/現在の概念と分析
  docs/_archive/ アーカイブ済み/完了した概念
  docs/_ideas/ 将来に向けたアイデア
  docs/_test_and_reports/ テスト結果とレポート
  ドキュメント/分析/分析ドキュメント
  docs/reference/ 外部参照 (クックブックなど)

コード ドキュメント
------------------

  system/bach.py メイン エントリ ポイント (v2.0 レジストリ ベース)
  system/bach_api.py ライブラリ API (タスク、メモリ、バックアップなど)
  システム/コア/コア モジュール (レジストリ、アプリ、データベース、ベース)
  system/hub/*.py ハンドラー実装 (自動検出)
  system/tools/*.py ツール スクリプト

データベース スキーマ
----------------

  system/db/schema.sql 完全な DB スキーマ (210 以上のテーブル)
  system/data/bach.db SQLite データベース

CLI アクセス:
  python bach.py --db スキーマ DB スキーマを表示
  python bach.py --db tables すべてのテーブルを表示

クイックリファレンス
---------------

  バッハとは何ですか？          --ヘルプ wiki/was_ist_bach
  どうやって始めればいいですか？        -- 起動を支援します
  どうやって終わらせればいいですか？        -- シャットダウンを支援します
  タスクを作成しますか?        --ヘルプタスク
  レッスンを保存しますか？      --ヘルプレッスン
  メモリを使用しますか?         --ヘルプメモリ

ドキュメント階層
-------------------------

''`
SKILL.md <- マスターコンテキスト (常に LLM を読み取ります)
    │
    §── ARCHITECTURE.md ← 技術詳細
    │
    §── docs/help/ ← 操作説明
    │ §── core.txt ← コアコンセプト
    │ §──memory.txt ←メモリシステム
    │ ━─……
    │
    §── スキル/ ← 機能定義
    │ §── _エージェント/
    │ §── _ワークフロー/
    │ ━─……
    │
    └── ドキュメント/ <- 概念、分析
        §── CONCEPT_*.md
        ━── アーカイブ/
```

ハンドラーのアーキテクチャ
-------------------

ヘルプ ハンドラー: system/hub/help.py
  - system/docs/help/ からの .txt ファイルを表示します。
  - サブフォルダーをサポート (tools/、wiki/)
  - エージェント、ワークフロー、_エキスパートのエイリアス システム
  - DB からのツールの直接アクセス (v1.1.38+)

ドキュメント ハンドラー: system/hub/docs.py
  - ドキュメント/フォルダーのリスト/検索
  - コンセプト、分析、回路図、その他ごとにグループ化
  - 操作: リスト、表示、検索

---
バージョン: 1.0.1 |作成日: 2026-01-30 |更新日: 2026-02-08
