harnessops 0.1.1

AI支援ハーネスプロジェクト向けのフィードバックと改善実験OS

HarnessOps

HarnessOps は、AI Agent がハーネスプロジェクトの失敗、フィードバック、評価、改善判断を証拠付きで扱うための運用基盤です。

このプロジェクトは基本的にAI経由で利用します。人間がCLI手順を覚えることより、何をAI Agentに任せるか、どこに記録が残るか、どの安全条件が守られるかを把握することを重視します。

人間が把握すること

HarnessOps は3つのリポジトリ役割を分けます。

レイヤー	オーバーレイ	目的
プロジェクトリポジトリ	harness-feedback/	失敗、ローカル回避策、上流へ送る候補を記録します。
ターゲットリポジトリ	harness-lab/	受け取ったフィードバックを評価ケース、仮説、判断に変換します。
HarnessOps リポジトリ	harness-lab/	HarnessOps 自身のCLI、スキーマ、プラグイン、運用ループを改善します。

プロジェクト固有の研究方針、論文内容、実験転換は harness-feedback/ ではなく、各プロジェクトの research/ または notes/ に置きます。上流やメタ改善へ回す内容は、必ずルーティングとサニタイズを通します。

名前

• GitHub repository: Nkzono99/harnessops
• PyPI package: harnessops
• Python import: harnessops
• CLI: hops

読む順番

• 人間がAI Agent経由で使い始める: docs/get-started-with-agent.md
• AI Agent向けの運用手順: docs/agent-user-guide.md
• target repositoryへ組み込むAgentに渡す文書: docs/target-integration-agent-brief.md
• project repository単体へ組み込むAgentに渡す文書: docs/project-repository-integration-agent-brief.md
• 現行仕様の正本: SPEC.md
• 設計思想: docs/design-principles.md
• 今後のロードマップ: docs/roadmap.md
• 個別仕様の補助資料: specs/

安全上の前提

• hops が HarnessOps 状態変更の正本です。Agentやプラグインは、.harnessops/、harness-feedback/、harness-lab/ の構造を直接組み替えません。
• 未サニタイズのフィードバックは既定で外部出力されません。
• 採用済み判断には、証拠、回帰リスク、ガードパスが必要です。
• 生成ビューは更新されますが、人が作成した records/ 配下の履歴はビュー更新で再生成されません。

開発時の確認

PYTHONPATH="$PWD/src" python3.11 -m pytest -q
uv run --with-editable . hops doctor --check-overlay --check-records
uv run --with-editable . hops migrate --check