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

ベスト プラクティス
--------------

BACH CLI の第一選択:
  すべての操作には常に bach.py を使用してください
  - タスク --> バッチタスクの追加/リスト/完了
  - メモリ --> bach mem 書き込み/読み取り
  - スキル --> バッハ --スキルリスト/検索
  - ツール --> bach ツール リスト/実行

なぜですか?
  - 安全なエンコーディング (UTF-8)
  - 構造を検証します
  - 腐敗がない
  - 原子力事業
  - 統一インターフェイス

代替手段 (CLI が機能しない場合のみ):
  1. bach_paths.py を使用した Python スクリプト
  2. 直接 DB クエリ (読み取り専用!)
  3. JSON を手動で編集しないでください!

ルール インデックス:
  何？                      どこ？
  CLI 構文 --help cli
  記憶のルール -- 記憶を助ける
  タスク システム -- ヘルプ タスク
  コーディング標準 -- コーディングのヘルプ
  フォルダー構造 --help bach_paths
  命名規則 -- 命名に関するヘルプ
  データ形式 -- ヘルプ形式
  既知の問題 -- ヘルプ レッスン
  ツールの概要 -- ヘルプ ツール
  ツールプレフィックス -- 命名ヘルプ (TOOL PREFIXES セクション)
  Policy Validators tools/_policies/

アーキテクチャ上の原則:
-----------------------
これらのルールはシステム全体に適用されます:

1。コンセプトをドキュメントに一元的に保存/
   すべての CONCEPT_*.md は docs/ (ルート ディレクトリ) に属します。
   すべての計画を 1 か所にまとめられる = 概要がわかりやすくなります。

   実装後: コンセプトを docs/_archive に移動します。

   システム内のマークダウン ファイル:
   - docs/CONCEPT_*.md = コンセプトと計画 (中心!)
   - */README.md = フォルダーガイド、インデックス
   - skill/SKILL.md = エージェント/スキルのドキュメント
   - skill/*.md = エージェントのメイン ドキュメント (ATI.md、STEUER.md)

   ルール: 分散型 .md はナビゲーションとスキルのドキュメントのみに使用されます。
          コンセプトや計画のためのものではありません。

2.ドキュメント/フォルダー構造
   docs/ はシステムの開発に関するものです:

   _archive/ アーカイブされた古い概念 (実装/廃止)
   _ideas/ 長期的なコンセプト (まだ承認されていません)
   _test_and_reports/ 開発者の分析、現在のステータス、テスト
   分析・分析結果とレポート
   リファレンス/リファレンスドキュメント
   (ルート) CONCEPT_*.md - すべてのコンセプトを一元管理
                      すべての計画を 1 か所で実行

   user/ はシステムの使用に関係します。
   ・利用に伴って発生した報告
   - システム開発には向きません

3。進化的な移住
   名前変更/再構築時にハードブレイクが発生することはありません。
   古い構造を一度に移行するのではなく、段階的に移行します。

4.統合データベース
   bach.db = 単一のメイン DB (210 以上のテーブル、その中のすべて)

   注: user.db は v1.1.84 で bach.db にマージされました。
   registry.db (ディストリビューション) と archive.db (アーカイブ) は
   コア システムの一部ではない特別な DB。

5。 JSON の前のデータベース (RecludOS の原則!)
   JSON ファイルは正当な例外的な場合にのみ使用されます。
   デフォルトは常にデータベースです。

   JSON は次の場合にのみ許可されます。
   - ユーザー固有 (新しく作成されたもの、移行されていないもの)
   - 透明性が重要です (ユーザーは直接編集する必要があります)
   - プロセスキャラクター (短命、処理中)
   - インポート/エクスポート交換フォーマット

   詳細: docs/help/formats.txt

6。 DIST_TYPE 3 ステップ
   2 = CORE (システム ファイル、配布はバックアップ)
   1 = TEMPLATE (リセット用の 1x スナップショット)
   0 = USER (ユーザー データ、通常の回転)

7。真実として助けてください
   docs/help/*.txt が主要なドキュメントです。
   異議がある場合: docs/help/ が勝ちます。
