schema_version: agents_rule.v1
rule_id: DB_FILE_MANAGEMENT_V1
title: Database file management and canonical path policy
summary:
  - Canonical operational database files live under `src/quant_engine/`.
  - `src/quant_engine/snapshot_admin.db` is the canonical snapshot admin workspace DB.
  - `src/quant_engine/kis_data_collection.db` is the canonical KIS collector DB.
  - `Temp/` is reserved for transient validation artifacts, smoke DBs, and ephemeral test outputs.
  - `outputs/` is reserved for export, archive, and derived artifacts; it must not become the default operational source of truth.
  - If a DB path exists in multiple locations, code and docs must point to the canonical `src/quant_engine/` copy unless an explicit migration or archive tool states otherwise.
  - Legacy DB paths may appear only in documented migration/archive helpers and must not be used by normal operational entry points.