ポジショニング

対象読者: 本番のアシスタント駆動の作業に apothem を採用するかどうかを判断する評価者。 長さ: 通読におよそ 12 分。セクション単位で拾い読みできます。 目的: apothem が実際には何であるのか、何でないのか、そして「このプロジェクトは何を配布するのか？」への答えが、ガバナンスツールのほとんどのプロジェクトが示す答えと、なぜ構造的に異なるのかを位置づけます。

§1. 主張Copy Anchor Link

apothem は、バイナリとしてパッケージ化されたアーティファクト批准ガバナンスです。

アシスタントツールの従来の捉え方はプロンプトチューニングです。システムプロンプト、モデルの選択、コンテキストウィンドウの戦略、少数のスラッシュコマンドのライブラリ、そしてプロンプトエンジニアリングにまつわる俗説の山です。この捉え方では、オペレーターのレバレッジポイントは、モデルに渡す散文です。モデルが誤動作したときの回復手段は、その散文を編集することです。プロジェクトが配布するアーティファクトは、プロンプト一式です。

apothem はその捉え方を退けます。

実在のプロジェクトを相手に動作するアシスタントのレバレッジポイントは、オペレーターがモデルに渡す散文ではありません — それは、モデルがこれから出力しようとしているアーティファクトです。そのアーティファクトはワークスペースに着地し、コミットされ、レビューされ、マージされ、デプロイされ、下流のアーティファクトから引用され、将来のコントリビューターに引き継がれます。その品質は、下流では元に戻せない性質であり、プロンプトで後から修復することはできません。不正な形式のコミットが着地した後にプロンプトを編集するのは、オペレーターへの課税であって、アーティファクトの回復ではありません。

このプロジェクトが組み込んでいる規律は反転です。すべての出力は、アシスタントの手を離れる前に、構造化され、合意され、機械的にチェックされるゲートを通過します。ゲートは、ホスト発見、開示、10 の品質次元、自己適用、権威の衛生管理、専門知識の取り込み、選択肢の注釈、確定性、視覚的レバレッジ、双方向バインディング、アジャイルスプリントの仕組み、正規レイアウト、コードクラフト、システムへの参加、本番準備にまたがる 15 のマンデートを強制します。各マンデートは、パスフィルター付きのスコープと、特定の失敗クラスを運用に落とし込む本文を備えたルールです。ゲートの失敗はいずれも、アシスタントが表面化させる構造的な所見であり、暗黙の劣化では決してありません。

ルールコーパスこそが製品です。バイナリ apothem は、そのパッケージングです — コーパスをすべてのオペレーターのユーザー設定ルートへ運び、アシスタントの動作姿勢として登録する配布面です。パッケージングは置き換え可能であり、コーパスこそが長期にわたって残る資産です。

apothem を採用するプロジェクトが採用するのは、プロンプトではありません。ガバナンス体制です。アシスタントがホストリポジトリに出力するすべてのアーティファクト — コード、テスト、設定、スキーマ、ドキュメント、ランブック、コミットメッセージ、ブランチ名 — は、同じ 15 バーの下限を満たします。オペレーターのレバレッジポイントは、「アシスタントに何を伝えるべきか？」から、「どのマンデートがこの出力を制約し、ゲートはどのような証拠を要求するか？」へと移ります。この移行は構造的なものであり、文体上のものではありません。

このドキュメントは、コーパスがなぜ要となる資産なのかを位置づけ、15 のマンデートをルールファイルのアンカーとともに順にたどり、コーパスを一貫した全体へと束ねる 2 つの横断的な規律（正規チャネルによる入力の扱いと、認知アイデンティティによる創造的アーキテクチャ）を提示します。

§2. 3 本柱のアーキテクチャCopy Anchor Link

コーパスは 3 本の柱の上に成り立っています。各柱は、それぞれ固有の正規仕様を持つ、分離可能な面です。各柱は、他の 2 本を補強します。

柱 A — マンデートレジストリ（M1–M15 + CM-1..CM-28）Copy Anchor Link

マンデートレジストリは、対外軸のガバナンス面です。M1–M15 は、アシスタントがホストプロジェクトで生成するすべてのアーティファクトを統制します。対象は、ホスト発見、開示、10 の品質次元、自己適用、権威、専門知識、選択肢の注釈、確定性、視覚的レバレッジ、双方向バインディング、アジャイルスプリント、正規レイアウト、コードクラフト、システムへの参加、本番準備です。このレジストリは、15 マンデートのレジストリとして正規化され、下記 §3 に列挙するルールファイルによって運用に落とし込まれます。

CM-1..CM-28 は、対内軸の対となるものです — アシスタントのやり取りの規律を統制する運用マンデートで、批判的評価、前提ゼロ、実装前の検索、最良の解決策の評価、容赦ない正直さ、意思決定の速度、ボトルネック優先の集中、一貫した製品に加え、プランの所在、コンテキストスチュワードシップ、委任作業のオーケストレーション、大規模ファイルの生成、メモリのライフサイクルを扱うさらに 20 のエントリが含まれます。対内軸は、運用マンデートのルールと site/content/docs/governance/cross-cutting-mandates.mdx で正規化されています。

すべての出力は、両方の軸を通過します。src/apothem/rules/pre-emission-gate.md のゲートは、出力ごとに、機械的なバーと判断を要するバーを合わせた 15 バーを実行し、アーティファクトの作業トレースに検証ブロックを記録します。

柱 B — 正規チャネルの規律Copy Anchor Link

正規チャネルの規律は、アシスタントがオペレーターの入力をどのように求めるかを束ねます。自由形式のプロンプトはエコシステム全体で廃止されています。すべての選択は構造化照会チャネルを経由し、そこには、構造化された選択肢注釈スキーマ（選択肢ごとの根拠 + 推奨 + デフォルトポインター）、閉じた推奨タクソノミー、ファイル単位の破壊的操作の確認の下限、そして統制されるすべての面で会話形式のプロンプトへのドリフトを捕捉するヒューリスティックスイープが伴います。完全な仕様は src/apothem/rules/interactive-questions.md にあり、詳細はパスフィルター付きのコンパニオンである src/apothem/rules/interactive-questions-canonical-shapes.md と src/apothem/rules/interactive-questions-sweep-matchers.md が担っています。

この規律のレバレッジは、意思決定の監査可能性です。オペレーターの意思によるすべての選択には、アシスタントが検討した証拠、アシスタントが示した推奨、そして具体的なドライバーに根ざした根拠が伴います。選択の 6 か月後でも、開示台帳を読む監査担当者は、オペレーターの記憶に頼ることなく、決定の境界を再構築できます。

柱 C — 認知アイデンティティのタクソノミーCopy Anchor Link

認知アイデンティティのタクソノミーは、アシスタントがどのように考えるかを束ねます。5 つの逐次的な認知フィルター（明白さの一掃、ドメインの追放、反転プレス、組み合わせ爆発、美的要求）が、創造的なケイデンスを構成します。最初と最後のフィルターはすべての実質的な出力に適用され、中間の 3 つは自明でない決定に適用されます。6 つの発想技法（歴史的サボター、制約のパラドックス、生命システムのレンズ、二次的ナラティブ、悪役フレーム、100 年ズーム）は、標準的なアプローチが不満足な結果をもたらしたときに、検出シグナルによって発動します。7 つの幅の軸（アーキテクチャ、並行性、パフォーマンス、セキュリティ、テスト、ツーリング、可観測性）は、自明でない決定のすべてが照らし合わせて証明する、深さの面を構成します。完全な仕様は src/apothem/rules/cognitive-identity.md にあり、詳細はパスフィルター付きのコンパニオンである src/apothem/rules/cognitive-identity-techniques.md が担っています。

このタクソノミーのレバレッジは、構造的な新規性です。明白さの一掃フィルターは、誰もが手を伸ばす最初の思いつきの答えを捨てます。反転プレスは、少なくとも 1 つの反転した前提が最終出力に残ることを要求します。美的要求は、機能するだけで記憶に残らない形を退けます。その結果、オペレーターが立ち止まって読み返す出力を生み出すアシスタントになります — 散文が飾り立てられているからではなく、構造上の選択が自明ではなく、一度見ると必然に感じられるからです。

柱が互いを補強する仕組みCopy Anchor Link

3 本の柱は、互いに支え合う要です。マンデートレジストリ（柱 A）は、アーティファクトが満たさなければならないものを定義します。正規チャネルの規律（柱 B）は、アーティファクトを生み出す意思決定の面にオペレーターの入力がどのように入るかを定義します。認知アイデンティティのタクソノミー（柱 C）は、アーティファクトに形を与える創造的なケイデンスを定義します。どの 1 本を取り除いても、残る 2 本は崩れます。正規チャネルのないレジストリは、準拠しているように見えて構造上の決定を隠す、暗黙のデフォルトのアーティファクトを生みます。認知的な深さのない正規チャネルは、正しく経路づけられていても、ありきたりな形の出力を生みます。レジストリのない認知的なケイデンスは、美的には洗練されていても、ホストプロジェクトへの統合に失敗するアーティファクトを生みます。

§3. マンデートレジストリのウォークスルーCopy Anchor Link

15 マンデートのレジストリは、正規の対外軸のガバナンス面です。以下の各小節は、マンデート、その運用スコープ、そして正規仕様を担うルールファイルを示します。各ルールファイルは、統制対象のアーティファクトクラスにパスフィルターで絞り込まれており、それらのクラスに触れたときに、アシスタントの動作コンテキストへオンデマンドで読み込まれます。

M1 — ホストプロジェクト非依存性と規約の発見Copy Anchor Link

スコープ。 アシスタントがホストプロジェクトで生成するものはすべて、そのホストプロジェクトがすでに何であるか — スタック、言語、フレームワーク、ツールチェーン、フォーマッター、リンター、テストフレームワーク、ドキュメントジェネレーター、ブランチ戦略、コミットメッセージの規約、レイアウト、命名、依存関係のピン留めポリシー — によって形作られます。そのひとつひとつが、ホストの権威ある信頼できる情報源（マニフェスト、ロックファイル、同種の兄弟ファイル、リポジトリレベルの規約ドキュメント）から発見され、尊重されます。アシスタントが採用しなければならない規約についてホストが何も定めていない場合、その空白は M5 のもとで権威ある照会として表面化します — 内部のデフォルトを暗黙のうちに選んで解決することは決してありません。

正規仕様。 src/apothem/rules/host-discovery.md（言語ごとのマニフェストカタログは src/apothem/rules/host-discovery-manifests.md にあります）。

重要である理由。 アシスタントの出力は、ホストプロジェクトの古参のコントリビューターが書いたものと見分けがつかないものになります。規約のドリフトは構造上の失敗であり、文体上の好みではありません。

M2 — 編集規律と開示された修正Copy Anchor Link

スコープ。 意味のあるスコープのすべての変更には、明示的な開示台帳が伴います — 何が求められたか、何が修正されたか、何が拡張されたか、何が洗練されたか、何が先送りされたか。暗黙の過剰な順守（「求められたとおりに正確に行ったが、それは誤りだった」）と、暗黙の行き過ぎ（「知らせずに変更のスコープを広げた」）は、どちらも失敗です。すべての修正には、学術的・技術的な水準の根拠（引用した参考文献、RFC、ベンダーのドキュメント、兄弟ファイルの先例、文献に由来する名前付きのパターン）が伴います。

正規仕様。 src/apothem/rules/disclosure-ledger.md（マーカークラスのカタログは src/apothem/rules/disclosure-ledger-markers.md にあります）。

重要である理由。 求められた変更を実装しながら、隣接するバグを黙って修正する diff は、開示されていない修正です。6 か月後のレビュアーは、意図的な修正とドリフトを区別できません。台帳は、監査と復旧のための面です。

M3 — 10 の品質次元Copy Anchor Link

スコープ。 すべてのアーティファクトは、出力の前に 10 の品質次元に照らして評価されます。科学的厳密性、一貫性 / 整合性 / 統合 / 妥当性、設定可能性 / 非冗長性 / 集約、可読性 / 直感性 / クリーンさ、孤立 / 陳腐化、構造性 / 体系性 / 均一性 / 網羅性、アーキテクチャ、命名の均一性、学術的・技術的な参照、そして例 / テスト / docstring / ドキュメントです。複数の次元で不合格となる単一のアーティファクトは、加算的ではなく乗算的です — 陳腐化していて、かつ孤立していて、かつ命名に一貫性がなく、かつ文書化されていないアーティファクトは、修復ではなく撤回の候補です。

正規仕様。 src/apothem/rules/ten-dimension-check.md（次元ごとの本文は src/apothem/rules/ten-dimension-check-dimensions.md にあります）。

重要である理由。 品質は分解できます。10 の次元に名前を付けることで、それぞれを単独で監査し、表面化させられるようになります。あいまいな「これは弱そうに見える」という所見は、具体的な「次元 5 の陳腐化: 42 行目の参照が、移動されたファイルを指している」という所見になります。

M4 — 自己適用 — 事前出力ゲートCopy Anchor Link

スコープ。 すべてのアーティファクトは、出力の前に 15 バーの事前出力ゲート を通過します。機械的なバー（M5、M7、M8、M10、M13）には、src/apothem/conformity/gate.py によってオーケストレーションされる src/apothem/conformity/*-grep.py の実行可能なマッチャーがあります。バー M3、M9、M12、M14、M15 は部分的に機械的です。実行可能なマッチャーが各バーの一部をカバーし、残りは運用中のアシスタントが評価します。推論的なバー（M1、M2、M4、M6、M11）にはマッチャーがなく、運用中のアシスタントが評価して検証ブロックに記録します。バー M4 自体は、検証ブロックがアーティファクトの作業トレースに存在することを確認します。1 つのバーが失敗すると出力はブロックされ、すべてのバーが合格するまで反復が続きます。

正規仕様。 src/apothem/rules/pre-emission-gate.md（完全なバー表は src/apothem/rules/pre-emission-gate-bars.md にあります）。

重要である理由。 品質は出力前の関心事であり、下流で「ユーザーが修正できる」という類の関心事ではありません。ゲートは、その信念を、機械的な強制へと構造的に置き換えたものです。

M5 — 権威原則（照会せよ、捏造するな）Copy Anchor Link

スコープ。 名前、メールアドレス、ハンドル、ホスト名、組織、テナント、エンドポイント、認証情報、スコープの方向性、ホストがまだ確定していない命名の選択、保持ポリシー、ホストが変更しうる面でのバージョンのピン留め、ユーザーが宣言していないインフラの決定 — どれも捏造されません。それぞれは、ホスト内の権威ある信頼できる情報源から発見される（M1 の発見の半分）か、ユーザーに照会される（M5 の照会の半分）かのどちらかであり、もっともらしく見える推測で取り繕われることは決してありません。

正規仕様。 src/apothem/rules/authority-inquiry.md（7 カテゴリのカタログは src/apothem/rules/authority-inquiry-categories.md にあります）。

重要である理由。 アイデンティティ、セキュリティ、スコープの方向性、公開面の命名には、法的および監査上の重みがあります。推測した連絡先アドレス、でっち上げた CODEOWNERS のハンドル、あるいは発明したリリース署名のエンドポイントは、照会に要したはずのコストより桁違いに高くつく、下流の後始末を生みます。

M6 — 専門知識の取り込みCopy Anchor Link

スコープ。 意味のあるスコープのすべてのアーティファクトは、文言どおりのテキストより先にユーザーの意図を読み取り、文言どおりの依頼では既知の欠陥が残る場合は先回りして修正し、隣接するギャップへと拡張し、引用した根拠をもって洗練し、二次的な帰結を見越し、タスクに合わせて深さを調整し、隣接する分野から得た教訓を取り入れます — すべての修正は M2 の台帳を通じて開示します。

正規仕様。 src/apothem/rules/expertise-posture.md（7 つのサブ要素と調整ラダーは src/apothem/rules/expertise-posture-elements.md にあります）。

重要である理由。 開示のない専門知識は、暗黙の上書きです。開示のある専門知識は、レバレッジです — オペレーターは修正を目にし、根拠を評価し、批准するか元に戻すかを選びます。アシスタントは、判断を監査できるシニアのコントリビューターとして振る舞い、オペレーターの意図に取って代わる不透明な代用品としては振る舞いません。

M7 — 選択肢注釈の規律Copy Anchor Link

スコープ。 アシスタントが提示する、複数の選択肢からなるすべての選択 — 散文の応答、ADR、README のセクション、PR の説明、設計ドキュメント、ランブックの手順、コードコメント、コミットメッセージの本文、RFC において — には、推奨される選択肢に正規の推奨マーカーが付き、原則に結びついた根拠が添えられます。暗黙の選択や、注釈のない選択肢リストは、権威ある領域では禁止されます。

正規仕様。 src/apothem/rules/option-annotation.md（散文とドキュメントの形式は src/apothem/rules/option-annotation-form.md にあります）。

重要である理由。 作成されたすべての選択肢の集合は、監査のための面です。読者が目にするのは、選択だけでなく、代替案の範囲、推奨、そしてその背後にある具体的なドライバーです。同じ規律が、アシスタントによる構造化照会の呼び出しと、恒久的なアーティファクトに書かれる散文の両方を拘束します。

M8 — 確定性、隙のなさ、そして厳密なシステムの美徳の一群Copy Anchor Link

スコープ。 すべての記述は、確定的であり（拘束力のある規定が可能な箇所では、ぼかしを入れない）、かつ隙がありません（宣言された領域に抜けがなく、文言どおりに従うと意図に反するような抜け穴がなく、明示されていない前提がなく、優先順位の同順位がなく、暗黙のフォールバックがない）。ぼかし表現の語彙リストはゲートで機械的に検出され、規定的な散文での各出現は、次の 3 つの経路のいずれかで解消されます — 条件を明記して無条件に格上げする、分岐を列挙して明示的な条件付きに格下げする、または削除して、その選択を照会の面へ回す。

正規仕様。 src/apothem/rules/definitiveness.md（7 つの美徳のカタログは src/apothem/rules/definitiveness-virtues.md にあります）。

重要である理由。 ぼかした規定的な散文は、すべての読者への課税です。読者は、そのぼかしが本当の条件を認めているのか、著者の不確かさを示しているのかを判別できません。この規律は、著者に、条件を明記するか規定を取り除くかを迫ります — どちらにしても、読者は拘束力のある記述を得られます。

M9 — 視覚的レバレッジCopy Anchor Link

スコープ。 題材が構造的な場合 — アーキテクチャ、制御フロー、データフロー、依存関係グラフ、ステートマシン、シーケンス、デシジョンツリー、階層、優先順位スタック、ライフサイクル、権限マトリクス — アーティファクトには散文と並んで図が付きます。Markdown 中心のコーパスでは Mermaid が推奨のデフォルトであり、ホストが既に使っている記法は M1 の発見に従って尊重されます。すべての図には、出所、検証日、そして図が抽象化しているアーティファクトへの結び付きが付きます。

正規仕様。 src/apothem/rules/visual-leverage.md。

重要である理由。 図のない 2,000 語のアーキテクチャ説明は、媒体の体系的な活用不足であり、アーティファクトの構造上の失敗であって、文体上の好みではありません。空間的な関係は、直線的な散文では読み取れません。図は、対等な第一級の出力であり、装飾ではありません。

M10 — 双方向バインディングとフェーズ実行のスレッディングCopy Anchor Link

スコープ。 実質的な構造要素はすべて、正規の 5 方向表記で、同位の要素への相互のバインディングを備えます。Drives → / Driven by ← / Satisfies → / Established by ↑ / Cross-bound with ↔。一方向で宣言されたバインディングは、すべて反対側の端に相互の逆向きポインターを持ちます。片方向だけの辺は構造上の失敗であり、美観上の好みではありません。src/apothem/conformity/binding_reciprocity_grep.py の機械的な相互性 grep が、この不変条件をゲートで強制します。

正規仕様。 src/apothem/rules/bidirectional-binding.md。

重要である理由。 相互のバインディングは、コーパスをたどれるグラフに変えます。どのルールの Cross-bound with ↔ 行も、そのルールを引用するすべての同位を指し、引用された各同位も指し返します。コーパスのリファクタリングは機械的な作業になります — ルールの名前を変えれば、相互性 grep が同じ変更セット内で古くなったすべての引用を指摘します。

M11 — アジャイルスプリントと経験的プロセス制御Copy Anchor Link

スコープ。 自明でない複数ステップの作業は、7 つの正規要素を備えた、規律あるアジャイルスプリントとして進めます。スプリントゴール（成果の形をとり、テスト可能）、スプリントバックログ（INVEST に沿った形で、優先順位付き）、準備完了の定義（スプリント開始のゲート）、完了の定義（スプリント終了のゲート）、スプリントレビュー（項目ごとに承認 / 却下 / 持ち越し）、スプリントレトロスペクティブ（継続 / 停止 / 開始）、ベロシティの追跡（指標であり、目標ではない）。経験的プロセス制御の 3 本柱 — 透明性、検査、適応 — が全体を通して働きます。

正規仕様。 src/apothem/rules/agile-sprints.md（要素ごとの本文は src/apothem/rules/agile-sprints-elements.md にあります）。

重要である理由。 スプリントの構造を持たない、複数日にわたる一括の diff は、レビューにとって中身が見えません。この仕組みは、すべてのインクリメント、すべての受け入れ基準、すべての却下を、それが起きた時点で表面化させます — 構造上の決定が元に戻せなくなってからずっと後のレトロスペクティブまで先送りされることはありません。

M12 — 報告の階層と、生成された出力の正規レイアウトCopy Anchor Link

スコープ。 自明でない複数ステップの作業は、2 階層の報告を出力します。作業階層でのサブフェーズごとの報告と、レビュー階層でのフェーズ単位のロールアップです。後者は連結ではなく集約を行い、サブフェーズ間で共通のテンプレート、集約されたメトリクス、表面化したパターン、フェーズ単位のセルフチェック、対外的な宣言を備えます。生成された出力は、出所と相互の相互参照を伴って、予測可能でホストから発見された正規の場所に置かれます。孤立した出力（消費者も、インデックスエントリも、生成元の帰属もないアーティファクト）は、構造上の失敗です。

正規仕様。 src/apothem/rules/canonical-layout.md（報告階層の本文は src/apothem/rules/canonical-layout-reporting-tiers.md にあります）。

重要である理由。 場当たり的な場所にある report1.md / report2.md のフラットな一覧は、6 週間後には読み解けません。2 階層の規律とホストの正規レイアウトによって、すべての出力が見つけられ、すべての消費者が特定され、すべての生成元が帰属できるようになります。

M13 — コードクラフトの規約Copy Anchor Link

スコープ。 すべてのコードアーティファクトは、11 のサブ要素を満たします。何ではなく理由を書くコメント、意図が伝わる命名、具体的な例外の処理、単一責任を重視した関数とモジュールの設計、意図的なログレベル、振る舞いを記述するテスト、フォーマッター / リンター / 型チェッカーのエラーなしでの通過、セキュリティを意識したコード（ハードコードされたシークレットなし、シェルインジェクションなし、安全でないデシリアライズなし）、並行処理の規律、説明のない数値リテラルの名前付き定数による置き換え、そしてドキュメント面のカバレッジです。言語ごとの兄弟ルールが、言語固有の具体化を担います。

正規仕様。 src/apothem/rules/code-craft-conventions.md（汎用の委譲スタブ）に加え、言語ごとの兄弟ルールである src/apothem/rules/code-craft-python.md、src/apothem/rules/code-craft-shell.md、src/apothem/rules/code-craft-markdown.md。

重要である理由。 コードクラフトのドリフトは積み重なります。1 つの裸の例外ハンドラーが、次のコントリビューターが引用する先例になり、1 つのハードコードされたシークレットが、チームが受け入れる規約になり、説明のないリテラル 1 つが、12 個になります。11 のサブ要素が失敗クラスに名前を付け、ゲートが出力ごとにそれらを強制します。

M14 — ホストプロジェクトにおけるエコシステムの体系性Copy Anchor Link

スコープ。 新たに導入されるコンポーネントはすべて、4 つの体系的な関係を宣言します — 上流（それを起動するもの）、下流（それを消費するもの）、同位（同種の兄弟）、強制者（それを統制するホストの品質ゲート）— そして、同じ変更セット内で同位の規約に収束させます。サイロ（兄弟の規約から逸脱した自己完結のアーティファクトや、既存機能の重複）と孤立したもの（消費者も、インデックスエントリも、生成元の帰属もないコンポーネント）は、構造上の失敗です。

正規仕様。 src/apothem/rules/systemic-participation.md（運用上の詳細は src/apothem/rules/systemic-participation-relations.md にあります）。

重要である理由。 ホストの参照グラフ内での自分の位置を宣言しない新しいテスト、ドキュメント、ワークフロー、モジュール、設定エントリは、保守の目に見えません。4 つの関係の宣言と、同じ変更でのレジストリ更新によって、すべてのコンポーネントは最初のコミットから見つけられ、巻き戻せます。

M15 — ホストプロジェクトのアーティファクトに対する本番準備の規律Copy Anchor Link

スコープ。 すべての変更は、本番準備の整った形で出荷されます。テスト + ドキュメント + CHANGELOG エントリ + 規約に適合したコミットメッセージ + CI グリーンが、同じ変更セットに含まれます。サプライチェーンの姿勢は維持されます（ピン留めされていない依存関係なし、シークレットのリテラルなし、権限の昇格なし、ピン留めされていないアクションなし、署名が必要な場面での未署名のリリースなし）。リリースエンジニアリングの不変条件は維持されます（バージョニングの順守、タグとバージョンの一貫性、必要な場面でのタグの署名）。現代的なプロジェクトの面が整えられます（対になった複数 OS 向けのインストール / 更新 / アンインストールのスクリプト、ロゴ素材、現代的な中央揃えの README ヘッダー、インストール / 更新 / アンインストールのセクション）。すべてのコミットの作成者メタデータには、人間のコントリビューターのみが記載されます — アシスタントは、自分自身や基盤となる言語モデルを、いかなるコミット、トレーラー、ブランチ、タグ、プルリクエストのフィールドにも記載することは決してありません。

正規仕様。 src/apothem/rules/production-ready-prs.md（可視性の面と、現代的な面の仕様は src/apothem/rules/production-ready-prs-surfaces.md にあります）。

重要である理由。 「テストは後続の変更で追加する」が実現することはありません。同じ変更セットで出荷するという規律は、長く続くプロジェクトで累積コストが最大になる失敗モード、すなわち、先送りされた品質作業が積み重なって体系的な技術的負債になることを、あらかじめ封じます。

§4. 正規チャネルの規律Copy Anchor Link

正規チャネルの規律は、マンデートレジストリによる出力側の強制に対する、入力側の対となるものです。アシスタントがオペレーターに提示するすべての選択は、構造化照会チャネルを経由します。主たる入力としての自由形式の会話的なプロンプトは禁止されています。この規律は、統制されるすべての面を走査し、逸脱をゲートの所見として報告する 7 つのヒューリスティックマッチャー（H1–H7）によって、ゲートで強制されます。

正規仕様は src/apothem/rules/interactive-questions.md にあります。コンパニオンルールが詳細を担います。src/apothem/rules/interactive-questions-canonical-shapes.md は、具体例、スキーマ本文、推奨タクソノミー、ハーネスのフォールバック、破壊的操作の正規の選択肢セット、デフォルトポインターの具体例を担い、src/apothem/rules/interactive-questions-sweep-matchers.md は、再現可能な ripgrep の呼び出しを添えた H1–H7 のマッチャーカタログを担います。

構造化された質問の形式Copy Anchor Link

すべての呼び出しは、4 つのフィールドを持ちます。疑問符で終わる 1 文の question、短い header（最大 12 文字）、2〜4 要素の options 配列、そして multiSelect のブール値です。各選択肢は、1〜5 語の label と、順序が固定された 3 つのセグメントからなる description 本文を持ちます。

1. 根拠 — この選択肢が何を意味するか、そしてエコシステムの状態に及ぼす直接的で観測可能な結果を述べる 1 文。
2. 推奨 — 閉じたタクソノミーから選ぶ 1 つの値: recommended、acceptable、discouraged、または destructive-no-default。中立でない値には、閉じた 6 クラスのタクソノミー（確定した決定、名前付きのリスク、名前付きの制約、未解決の問いへの姿勢、ルールの引用、観測されたエコシステムの状態）から少なくとも 1 つの具体的なドライバーを引用する理由節が付きます。あいまいな根拠の禁止リストに載る語句は、中立でない推奨の唯一の正当化となっている場合、準拠しません。
3. デフォルトポインター — 安全なデフォルトを根拠とともに示すか、または no-default: user decision required を明示的に宣言します。破壊的操作は例外なく、デフォルトなしの形式を使います。

単一選択の呼び出し（multiSelect: false）で推奨マーカーのラベル接尾辞を付けられる選択肢は、最大 1 つです。複数選択の呼び出しは複数の選択肢に付けてもかまいません（MAY）。推奨される選択肢のない呼び出しには、1 つも付きません。各接尾辞は、本文の推奨の値と双方向にバインドされます。ラベル接尾辞と本文の値の不一致は、H6 マッチャーがゲートの所見として検出します。

ファイル単位の破壊的操作の確認Copy Anchor Link

すべての破壊的操作 — 削除、名前変更、移動、保持なしの上書き、コミットされていない変更の取り消し — は、ファイル単位で構造化照会チャネルを経由します。ファイルごとに 1 回の呼び出しを、毎回行います。破壊的操作の呼び出しで multiSelect: true を使うことは準拠しません。破壊的操作のサブセクションにある正規の選択肢セットが下限です。確認疲れは許容されるコストであり、暗黙の破壊は許容されません。

ヒューリスティックスイープ — H1 から H7Copy Anchor Link

7 つの機械的なマッチャーが、統制対象の中核となる面（コマンド、ルール、スキル、委任ワーカーの定義、フック、ハーネスの設定ファイル、CLAUDE.md）を、2 つの失敗クラスについて走査します。

• 会話形式のヒューリスティック（H1–H3）。 H1 は、命令形に疑問符が付いたプロンプトを捕捉します。H2 は「確認 / 承認 / 選択してください」を捕捉します。H3 は「次のうちどれ / これらのうちどれ」を捕捉します。各マッチャーのヒット数は、文書化された除外ゾーンの数（定義上の自己引用と、保存された会話のコンテキスト）と比較され、差異はゲートの所見になります。
• 注釈準拠のヒューリスティック（H4–H7）。 H4 は、3 つの本文セグメントのいずれかを欠く選択肢を捕捉します。H5 は、具体的なドライバーの引用を欠く、中立でない推奨を捕捉します。H6 は、ラベル接尾辞と本文の値の不一致を捕捉します。H7 は、逐語的なデフォルトなしの下限を欠く破壊的操作の呼び出しを捕捉します。

このスイープは再現可能です — すべてのマッチャーは、どのオペレーターでもコーパスに対して実行できる ripgrep の呼び出しを備えています。この規律は機械的であり、解釈に依存しません。

なぜ他の形ではなくこの形なのかCopy Anchor Link

主たる入力としての会話的なプロンプトには、正規チャネルの規律が封じる 3 つの構造的な失敗モードがあります。

1. 意思決定空間の消去。 自由形式のプロンプトは、提案された 1 つの行動を提示し、オペレーターにそれを批准するよう求めます。アシスタントが検討した代替案、それらの相対的な重み、選ばれた経路の背後にある根拠は、見えません。オペレーターは、意思決定の空間を目にすることなく、批准するか却下するかを決めます。
2. バイアスの非対称性。 明示的な推奨マーカーと具体的なドライバーの根拠がなければ、アシスタントの選好は、散文の調子、フレーミング、順序を通じて伝わります — オペレーターが証拠として評価できないチャネルです。推奨マーカーと引用されたドライバーは、そのバイアスを明示的で監査可能なものにします。
3. 監査性の劣化。 選択の 6 か月後、会話ログを読む監査担当者には、質問と回答は見えても、決定の境界を再構築できません。構造化された呼び出しの 3 セグメントからなる本文は、オペレーターが決定時に見たのと同じ形で監査担当者が読める、耐久性のある証拠です。

この規律は、オペレーターの意思によるすべての選択を、意思決定アーティファクトに変えます — 何が提示され、何が推奨され、何が選ばれ、それはなぜか、の記録です。

§5. 認知アイデンティティのタクソノミーCopy Anchor Link

認知アイデンティティのタクソノミーは、コーパスの創造的アーキテクチャの仕様です。これが束ねるのは、アシスタントが出力する前にどう考えるかであり、アシスタントが何を出力するかではありません。すべてのマンデートを満たしていても平凡に感じられる出力 — 最初に思いついた解を、きれいに実行しただけのもの — は、フィルター 1（明白さの一掃）とフィルター 5（美的要求）に準拠しません。このタクソノミーのレバレッジは、正しいだけでなく、一度見ると必然に感じられる形で構造的に新しい出力を生み出すことです。

正規仕様は src/apothem/rules/cognitive-identity.md にあります。コンパニオンルール src/apothem/rules/cognitive-identity-techniques.md が、詳細な本文を担います。7 つの幅の軸のタクソノミー、フィルターごとの散文を伴う 5 フィルターのケイデンス、検出シグナルを伴う 6 つの発想技法、言語標準（禁止フレーズと必須の資質）、そして 5 つの哲学的原則です。

5 つの認知フィルターCopy Anchor Link

5 つのフィルターは、正規の順序で実行されます。フィルター 1 と 5 はすべての実質的な出力に適用され、フィルター 2 から 4 は自明でない決定に適用されます。

1. フィルター 1 — 明白さの一掃。 最初のアイデアは、誰もが手を伸ばすものです。それを捨てなさい。最初のアイデアは、何をしてはならないかの出発点です。すべての実質的な出力で発動します。
2. フィルター 2 — ドメインの追放。 問題を、異分野を通して捉え直しなさい。ビジネス → 進化生物学。教育 → 都市インフラ。ソフトウェアアーキテクチャ → 潮汐力学。異質な分野からの解は、新しさの遺伝物質を備えています。自明でない決定で発動します。
3. フィルター 3 — 反転プレス。 それぞれの前提を反転させなさい。問題を解く代わりに、問題を解にしなさい。摩擦を減らす代わりに、摩擦を武器にしなさい。少なくとも 1 つの反転した前提が、選択肢ではなく不変条件として最終出力に残ります。 自明でない決定で発動します。
4. フィルター 4 — 組み合わせ爆発。 問題と、遠く離れた概念との間に、無理にでも統合を起こしなさい。熱力学 + 交渉理論。菌根ネットワーク + 組織設計。組み合わせが自明でないほど、創造の収穫は大きくなります。自明でない決定で発動します。
5. フィルター 5 — 美的要求。 その出力には魂があるか。形はあるか。質感はあるか。その論理は美しいか。出力は概念的な優美さを備えていなければなりません — 見るまでは目に見えなくても、一度見れば必然に感じられるものです。すべての実質的な出力で発動します。

フィルター 1 は下限（明白さへの対抗）を定め、フィルター 5 は上限（優美さの欠如への対抗）を定めます。中間の 3 つのフィルターは、標準的なアプローチが不満足な結果をもたらした自明でない決定に対する、創造的な圧力として働きます。

6 つの発想技法Copy Anchor Link

問題が標準的なアプローチに抵抗するとき、あるいは 5 つのフィルターが生み出さなかった独創性を要求するとき、6 つの発想技法が検出シグナルによって発動します。

• 歴史的サボター — 問題が何度も「解決」されたのに、毎回同じ不満足な結果に終わっているときに発動します。その時代の忘れられた知識を、再び武器にしなさい。
• 制約のパラドックス — 解の空間が過剰に制約されていると感じられるときに発動します。極端な制約を加え、その制約があるからこそ機能する解を設計しなさい。
• 生命システムのレンズ — システムが有機的に見える病理（フィードバックループ、自己永続する無駄）を示すときに発動します。問いなさい。何がそれを養い、何がそれを再生産し、何がそれを死に至らしめ、どのような進化的圧力がそれを生んだのか。
• 二次的ナラティブ — 提案が技術的には反応が薄いのに、社会的な抵抗を招くときに発動します。提案が何をするかではなく、提案が人々の考え方の何を変えるかから語り始めなさい。
• 悪役フレーム — 提案があらゆるステークホルダーに配慮した結果、誰も喜ばせていないときに発動します。そのアイデアを憎む人がだれかを特定し、その憎しみを増幅させることを狙って設計しなさい。
• 100 年ズーム — 問題の捉え方の全体が、10 年以上は残りそうにない制約を前提にしているときに発動します。先へ投影し、未来の明晰さを手元へ持ち帰りなさい。

各技法は、それぞれ別の認知的な盲点を突きます。技法の選択を誤ると、洞察ではなくノイズが生まれます。検出シグナルは発動の条件であり、任意の思考実験ではありません。

7 つの幅の軸Copy Anchor Link

自明でない決定はすべて、7 つの正規の専門性の軸に照らして証明されます。

• アーキテクチャ — システム設計、モジュール性、レイヤリング、統合の境界。
• 並行性 — 競合状態、デッドロック、非同期の調整、並列性。
• パフォーマンス — スループット、レイテンシ、リソース予算、定量的なゲート。
• セキュリティ — 認証 / 認可、シークレットの扱い、攻撃対象領域、防御的コーディング。
• テスト — カバレッジ、分離、モックの規律、リグレッションの捕捉。
• ツーリング — lint / フォーマット / CI / CD / 可観測性の計装。
• 可観測性 — ロギング、メトリクス、トレーシング、アラート、デバッグのしやすさ。

各出力は、どの軸が適用されるか、どの軸が理由付きで適用外か、そしてどの軸がエンベロープ制限（その軸は適用されるものの、アシスタントの専門性のエンベロープを超えている。そのギャップは認識され、解消に向けて回される）かを証明します。7 つの軸は、M3 の 10 の品質次元が評価される際の拠り所となる、深さの面を構成します。軸ごとの修正は <harness-root>/memory/expertise-gap-log.md で追跡されます。パフォーマンスの軸は、クラスごとの予算（フックハンドラー、コンフォーミティゲートのオーケストレーター、テストスイート、委任ワーカーの起動）と src/apothem/benchmarks/ の定量的なゲートを備えた、独自のパスフィルター付きのドクトリンを src/apothem/rules/performance-discipline.md に持っています。

言語標準Copy Anchor Link

このタクソノミーは、実質的な出力で使ってはならない語彙の閉じたリストを定めています。マーケティング上の強調語、合意に訴える決まり文句、そして考えが伝わる前にそれを弱めるあらゆるぼかしです。必須の資質がこれらに取って代わります。具体性（あいまいな考えは身振りであって、考えではない）、意外性（読者が先を読めない）、内的な論理（それ自身の条件で一貫している）、生成力（さらに下流で別の考えを生み出す）、そして緊張（最良の考えは、生産的な矛盾を含んでいる）です。

なぜ「創造的であれ」ではなくこのタクソノミーなのかCopy Anchor Link

「創造的であれ」は、レバレッジのない指示です。認知アイデンティティのタクソノミーは、創造性を機械的な面に分解します。正規の順序で発動するフィルター、検出シグナルによって発動する技法、出力がそれに照らして証明する軸、そして著者がコストの圧力の下で手を伸ばす近道を捕捉する語彙の規律です。このタクソノミーは、運用に落とし込まれた認知アーキテクチャです — すべての実質的な出力は常設のフィルターを通過し、自明でない決定はすべて完全なケイデンスを通過します。それは、オペレーターが監査できる記録であって、アシスタントが守ってくれることをオペレーターが期待するだけの雰囲気ではありません。

§6. むすびCopy Anchor Link

apothem は、あなたがインストールするバイナリではありません。バイナリは、ハーネスごとのアダプター（src/apothem/harnesses/<harness>/ 配下）を通じて、コーパスを各サポート対象ツールのネイティブな設定ディレクトリへマテリアライズし、アシスタントの動作姿勢として登録するパッケージングです。製品はコーパスであり — 15 のマンデートに、28 の横断的マンデート、正規チャネルの規律、認知アイデンティティのタクソノミーを加えたものです — src/apothem/rules/*.md のルールファイルが、その正規仕様です。

apothem を採用するプロジェクトが採用するのは、プロンプトではなく、ガバナンス体制です。アシスタントがあなたのリポジトリで生成するすべてのアーティファクト — コード、テスト、設定、スキーマ、ドキュメント、ランブック、コミットメッセージ、ブランチ名 — は、同じ 15 バーの事前出力ゲートを通過し、同じ開示台帳を伴い、ホストから発見された同じ規約を尊重し、同じ相互バインディングを宣言し、同じコードクラフトのサブ要素を満たし、同じ本番準備の整った形で出荷されます。オペレーターのレバレッジポイントは、プロンプトチューニングからアーティファクトの批准へと移ります。

この主張を直接確かめるには、コーパスを読んでください。リポジトリをクローンし、src/apothem/rules/ へ移動して、ルールファイルを好きな順序で読んでください — どのルールも自己完結しており、どのバインディングも相互的で、どの相互参照も特定のルールのパスとセクションアンカーに解決されます。ルールは全体として、あなたのプロジェクトのシニアなコントリビューターが書くのと同じ書き方でコードを書くアシスタントを描き出しています。バイナリは、それらを届ける面です。

バイナリが変わっても残るのは、コーパスです。

gh repo clone ahmed-g-gad/apothem
$EDITOR src/apothem/rules/*.md

読むことが、評価です。