Al0olo/Agents-village

ドキュメントスタイル

• 要点を先に述べる。一文につき一つのアイデア。短い文章。
• 一般的な表現よりも具体的に：数字、ファイル、コマンド、名前。
• 読者向けのドキュメントでは、プロセス説明や自己参照をしない。
• 不要な語句は削除：「重要な点として」「〜するために」「堅牢」「活用」「包括的」「シームレス」。
• テーブルは比較のためだけに使用。リストは手順か並列項目のみ。
• 不確実性は該当する場所で一度だけ述べ、それを解決する方法を示す。
• 各ディレクトリにはREADME.md（内容と、人向けの説明）とAGENTS.md（エージェントが行動するためのルール）を配置する。ディレクトリの目的やルールが変わったら両方を更新する。
• 読者向けのドキュメントには、署名と最大1つの日付を記載する。運用状態はdocs/HANDOFF.mdとdocs/handoff/LOG.mdに記録する。
• 他人の立場で読み直す。読み手が飛ばすであろう部分は削除する。