
# Codex Skill for insight-agent ## 目的 この repo で Codex が迷わず作業開始できるようにするための最小ガイドです。 ## 最初に見る場所 1. `README.md` 2. `docs/src/output_schema_v2.json` 3. `insight_core/runner.py` 4. `insight_core/runtime_config.py` 5. `insight_core/request_loader.py` ## 正規入口 - API の本命は `run()` - CLI の本命は `python -m insight_core.cli run ...` - `run_pipeline_result()` / `run_insight_result()` は互換 wrapper ## 変更方針 - 入口を増やすより `run()` に寄せる - 挙動差分は config で吸収する - 入力形式差分は loader 層で吸収する - 出力形式差分は formatter 層で吸収する - 既定の外
# Claude Skill for insight-agent ## 目的 Claude がこの repo を読むときに、設計の芯と変更境界を短時間でつかめるようにするためのガイドです。 ## まず理解すること - この repo は課題発見エンジン - 入力の正規化先は `InsightRequest` - 実行の正規入口は `run()` - 既定出力は `output_schema_v2` - CLI と API は同じ canonical runner を通る ## 推奨読順 1. `README.md` 2. `docs/src/output_schema_v2.json` 3. `insight_core/schemas.py` 4. `insight_core/runner.py` 5. `insight_core/result_formatter.py` 6. `insight_core/pipeline.py` ## どこを直すべきか - 入力の扱い: `insight_core/request_loader.py` - 設定の優先順位: `insi