yolos.net
このリポジトリについて
yolos.netは、AIエージェントのみで大規模なWebプロジェクトを運営する実験です。人間はConstitution（docs/constitution.md）を提供した後、AIエージェントが計画・実行・レビュー・改善のすべてを自律的に行います。
実験の目的
- AIのみによる運用パターン（協調、ドリフト、障害モード、回復行動）を長期的に観察する
- AIのみで複雑なプロジェクトを運営するための運用パターンを学ぶ
Constitution（不変）
docs/constitution.md はプロジェクトオーナーが作成した不変のポリシーです。すべてのアクション、ドキュメント、コード変更、生成されたサイトコンテンツはこのConstitutionに準拠する必要があります。
ドキュメント構造
docs/ 直下（現在有効で日常的に参照するドキュメント）
| ファイル | 役割 |
|---|
constitution.md | プロジェクトの不変ポリシー。すべての判断の最上位基準 |
site-concept.md | サイトのコンセプト・方向性の定義 |
character.md | PM エージェントの人格定義（SSoT）。派生は pm-character / blog-writer のみ。コンテンツ内の架空キャラはスコープ外 |
content-quality-requirements.md | コンテンツ品質の要件定義 |
content-trust-levels.md | コンテンツの信頼レベル分類ルール |
blog-writing.md | ブログ記事執筆のガイドライン |
backlog.md | 未着手・進行中タスクのプロダクトバックログ |
rebuild-plan.md | サイト作り直し計画（cycle-278 策定・フェーズR=一斉切替/フェーズC=コンセプト適合） |
ADR/（ディレクトリ） | ADR 兼実験記録（仮説→賭け→観測→記録。1件=1ディレクトリ・docs/ADR/README.md が運用規約） |
japanese-ai-slop.md | 日本語のAI臭チェックリスト（文章品質・DESIGN.md §9 と対） |
yoji-styleguide.md | 四字熟語AI視点例文のスタイルガイド |
ルート直下の DESIGN.md はデザインの定義。docs/site-concept.md とあわせて、constitution.md の下で日々の判断の基準になる。
docs/archive/（廃止済みの仕様書・過去の計画記録）
廃止・完了済みのドキュメントを保管する。現在の運用には影響しないが、意思決定の経緯を参照するために残す。
運用ルール
-
保管対象: 過去の計画・記録・廃止済み仕様。日常参照はしないが経緯を辿る際に参照する。陳腐化したドキュメントはここに移動する。
-
昇格: 新しい作業のために参照する必要が生じた場合は、docs/ 直下または docs/research/ に昇格させる。
-
architecture-decision.md — 旧・単発のアーキテクチャ決定記録（現行の docs/ADR/ の仕組みとは別物）
-
evaluation-rubric.md — 新規・既存コンテンツ候補を評価する汎用ルーブリック（廃止）
-
forced-ideation/ — サイトコンセプト策定時の強制発想セッションの記録
-
research/ — 一時的な調査・分析レポート（以下のdocs/research/に残すものを除く）
docs/cycles/（サイクルドキュメント）
作業サイクルごとの計画・実施記録。1サイクル=1ディレクトリで、TEMPLATE.md を元に cycle-NN/index.md を作成する。
TEMPLATE.md — 新サイクル作成用テンプレート（cycle-NN/index.md としてコピーする）cycle-NN/index.md — 各サイクルの作業計画・実施内容・完了サマリ（正本）cycle-NN/*.md — レビュー経過・事故報告詳細・調査メモなどの補助ファイル（index.md からリンクする）cycle-NN.md — 単一ファイルの旧形式（cycle-283 以前）。参照のみ・新規作成しない
docs/knowledge/（運用を通じて得られた一般化された知見）
サイクル作業から得た再利用可能な知見を一般化して蓄積する。
運用ルール
-
時点情報方式: 各ファイルはそれを記録したサイクルの時点情報として扱う。ファイル名に日付プレフィックス（YYYY-MM-DD-）を付ける。
- 理由: すべてのドキュメントは必ず陳腐化する。常に更新しようとしても手間がかかるばかりで効果はない。陳腐化を前提にし、「いつ得られた知見か」を明確にすることで、将来参照した際に妥当性を判断できるようにする。
-
新しい知見の追加: 新しいサイクルで得られた知見は、新しいファイルとして作成する。既存ファイルの更新は行わない。
-
テーマの重複: 同じテーマの知見が複数ファイルに存在してもよい。新しい方が優先される。
-
2026-03-16-ai-agent-communication.md — エージェント間コミュニケーション設計の知見
-
codegen-patterns.md — コード生成パターンの知見
-
css-modules.md — CSS Modulesに関する知見
-
nextjs.md — Next.jsに関する知見
docs/research/（調査レポート）
意思決定の根拠となる調査・分析レポートを保管する。一時的・完了済みの調査は docs/archive/research/ に移動する。
運用ルール
-
時点情報として保管: 調査結果はすべて陳腐化することを前提に、調査時点の情報として扱う。ファイル名に調査日のプレフィックス（YYYY-MM-DD-）を付ける。
-
保管の前提条件: 調査日時・目的・情報源がファイル内に明示されていること。
-
陳腐化したファイルの扱い: 情報が古くなった調査は docs/archive/research/ に移動する。
-
adsense-and-seo-requirements.md — AdSenseおよびSEO要件の調査
-
competitor-analysis.md — 競合サイト分析
-
competitor-needs-and-ai-strategy-research.md — 競合ニーズとAI戦略調査
-
market-research-*.md — マーケットリサーチシリーズ（高トラフィックカテゴリ・成長パターン・AIコンテンツニッチ）
-
target-user-and-market-research.md — ターゲットユーザーとマーケット調査
-
claude-md-context-position-analysis.md — CLAUDE.mdのコンテキスト配置に関する分析
ターゲット定義について（廃止・cycle-278）
ターゲットユーザー定義の仕組み（旧 docs/targets/）はオーナー指示で廃止した（定義の言葉に頼って実際の利用者の推論を止める傾向が出たため）。来訪者が誰か・市場がどの程度かは、毎サイクルの中でその都度調査・検討し直す（docs/rebuild-plan.md §4）。旧定義は docs/archive/targets/ に保存。
ライセンス
このプロジェクトは MIT License の下で公開されています。
