---
title: "問題"
description: "「問題」：yokoten ガイドの一章。"
canonical: https://yokoten.app/ja/docs/guide/the-problem
lang: ja
source: https://github.com/yokoten-labs/yokoten/blob/v0.1.2/docs/i18n/ja/guide.md
ref: "v0.1.2"
---

> For AI agents: the documentation index is at https://yokoten.app/llms.txt. To set up yokoten in a project, follow https://yokoten.app/agents.md.

# 問題

AI エージェントと数か月プロジェクトを進めると、いろいろなことを痛い目で学びます。エージェントが、失敗するテストを「直す」ためにテストのほうを変える。誰もレビューしていないコミットがプルリクエストでマージされる。サーバーのアドレスが追跡対象のファイルに入る。そこでルールを一つ、フックを一つ、チェックを一つ足します。そのプロジェクトは良くなります。

そのあと新しいプロジェクトを始めると、あるいは古いプロジェクトに戻ると、そのどれもありません。教訓は一つのリポジトリと、あなたの頭の中にだけあります。思い出して頼まなければ、エージェントはゼロから始めます。

yokoten は、その教訓を、自分でチェックするものに変えます。

- **理由のあるルール。** 十二の核心ルールがあります。どれも、なぜあるのか（インシデント、まだ何も起きていなければリスク）と、どのチェックがそれを保つかを書いています。チェックのないルールは、願いです。
- **自分で走る番人。** ツール呼び出しのフックが、悪いコマンドの実行前にエージェントを止めます。コミットチェックが、フックに見えないものを捕まえます。CI は、どちらも通らずに作られたコミットに対して、同じチェックを走らせます。
- **覚えていなくても済むリマインダー。** すべてのセッションは `doctor` から始まります。プロジェクトが道のどの関所にいるかと、次の一手を一つ伝えます。エージェントがそれを出してくれるので、あなたが覚える必要はありません。

---

前の章: [名前の由来](https://yokoten.app/ja/docs/guide/the-name.md)
次の章: [初日に変わること](https://yokoten.app/ja/docs/guide/what-changes-on-day-one.md)
