散文編集 は何をしますか？
「事実ではなく言葉と形」を扱います。このファイルの横にある NOTES.md に具体例があります。
テスト
すべての文は読者に「何をすべきか」「何を期待すべきか」「間違えたらどうなるか」のいずれかを伝えます。どれも伝えない文は削除します。簡潔さは短さではありません。長さを合わせるために内容を削るのではなく、その周りの足場を削ります。
削除対象
- 前置きばかりのつかみ。 内容を最初の文に置きます。
- 言い換え。 最高の場所で一度だけ言います。
- 埋め草の接続詞（「注目に値するのは」「前述のとおり」「〜するために」）。
- 行動を変えない編集者的コメント（「地味だが重要」）。
- 曖昧な数量表現（「驚くほどの割合」）。本当に機能する理由を述べるか、主張を削ります。
- コミットを避ける婉曲表現。 本当の不確実性は、判断基準とともに率直に述べます。
- 強調のための引用。 読者の行動を変える警告にのみ使用します。
生成テキストの痕跡を削除
モデルは最も多くの読者に合うものを選びますが、書き手は一人の読者と一つの主題のために選びます。まず構造に注目します。単語の習慣はモデルごとに変わるからです。この読者がまだ持っていないものを提供する文だけを残します。
- 直接述べずに段階を踏む。 誰も言っていない「XではなくY」、要点を繰り返す一行の締めくくり、要点の前の助走、深そうで何も主張しないことわざ。事実を述べます。
- 型通りのリズム。 いたるところの三連符とダッシュ、繰り返される文の始まり、積み重なる修飾語。三つあるときだけ三つ使います。
- 誇張。 普通の事実を「極めて重要」や「ロバスト」と呼ぶ、販売用の言葉、名前のない権威、意味を含意する「-ing」形の修飾語。それが何をするかを述べるか、削ります。
- 型通りの書式。 すべての項目を太字にし、すべての考えに見出しをつける。強調や構造に意味がない場合。
- 草稿の残骸。 チャットのラッパー、知識限界の免責事項、最初の文として繰り返される見出し、主題ではなく文書自体についてのテキスト。
- 間違った読者。 読者が既に知っていることを再度説明し、決定が最後に来るようにする。
書き手が意図したものを残し、削除したものの代わりに何も追加しません。真の対比、本当の三つのリスト、引用された出典は残します。痕跡は、何も追加しない場合にのみ数えます。
保護：「なぜ」は決して無駄ではない
「なぜ」を説明する文（この順序、このツール、このチェックが先、このステップは省略できない理由）は、指示を発行しない場合でも保護します。その理由があれば、読者は文書が想定していないケースに対処し、手順がもはや適用されない時を判断できます。自明でない場合、特にセキュリティやコンプライアンスルールにおいて、理由を記述します。意図が、どのルールも適用されない場合にルールを適用可能にするからです。一文に飾りと理由の両方がある場合は、理由を残すように書き直します。テストは「これを読まなかったら読者はこの作業がより下手になるか」です。
根拠のない構造を削除
階層、表、行列、入れ子見出し、分岐は、作業に必要な場合にのみ追加します。厳密に見えるからではありません。問いかけます：作業は実際にここで分岐しますか（すべての読者が同じ経路をたどるならリストです）？このステップは必要ですか、それともただ網羅的に見えるだけですか？手順が四つのステップなら四つと書きます：初回読破で従える四段階手順は、流し読みされる正しい九段階手順より優れています。落とし穴、順序の罠、「なぜ」は残します。
モデルが読み込む指示
ルールシート、スキル、ロールファイル、プロンプトは、読み込むたびにトークンで支払われます。読者はモデルであり、ルールの物語ではなくルール自体を必要とします。読み込まれるタイミング（D28）で価格設定します：
- 毎セッション（ルールシート、スキルとロールの説明）：ルールのみ。説明はスキルの対象範囲と読み込みタイミングを300文字未満で示します。
tools/check.pyが予算を強制します。 - 使用時（スキルまたはロールの本文）：ルールと理由の一文。ルールがなくても選択可能に見える場合にのみ、具体的な失敗事例を一つ、日付や数、プロジェクト名なしで記述します。
- オンデマンド（
NOTES.md、EVIDENCE*.md）：インシデント、数値、日付、出典。本文はこれらを参照します。
命令形で書きます。他の読み込まれたファイルが保持するルールを言い換えず、名前で参照します。docs/REQUIREMENTS.tsv に固定された要件は、書き換えに伴って移動し、決して静かに消えません。
手順の構成
目的 → 使用時 → 開始前 → 手順 → 確認 → うまくいかない場合 → エスカレーション
- 確認を決して省略しない：最も頻繁に省略され、最も価値のある部分です。
- 各ステップは一つの動作。UI要素は正確に命名します。完全なパスを示します。
- 不可逆的なステップは、ステップの前に、後ではなくフラグを立てます。
- 有能な他人のために書きます：ドメインは知っているが、この環境は見たことがない人。
- タイトルは検索されるであろう名前を付けます。日付、バージョン、「v2」は使いません。
文体
- 平易な言葉、短い文。
- 罰則を含む制約を和らげない（没収、解約、データ損失、個人責任）：率直に述べます。
- ベンダーのドキュメントはコピーせずリンクし、自分たちの作業方法に固有のことだけを文書化します：転載は到着時点で古くなっています。