Skip to content

ルールブックの作成

🏗️ ルールブックの作成:意志力を不要にする「フィールド効果」の展開

Section titled “🏗️ ルールブックの作成:意志力を不要にする「フィールド効果」の展開”

ルールブックとは、読み物ではありません。**「チームの特性を最大限に引き出し、状態異常(バグ・不整合)を自動的にはじくための、CI/CDという名の防衛回路」**です。

1. ⚔️ コーディング規約:自動化された「わざマシン」

Section titled “1. ⚔️ コーディング規約:自動化された「わざマシン」”

人間のレビューで「命名規則」を指摘するのは、PP(パワーポイント)の無駄遣いです。

Linter/Formatterという名の「ジャッジくん」:

命名規則やコードスタイルは、人間が判断するのではなく、保存時やCI時に強制修正(オートリカバー)させなさい。

**「ルールを守る」のではなく「ルールから外れることが物理的に不可能」**な環境を構築する。

2. 📡 Git・レビュー運用:意思決定の「通信プロトコル」

Section titled “2. 📡 Git・レビュー運用:意思決定の「通信プロトコル」”

情報のパケットロスを防ぎ、最短距離で「マージ」という名の勝利へ到達します。

ラベル制(MUST/IMO/ASK)の導入:

コメントに温度感(属性)を付与せよ。これにより、**「効果は ばつぐんだ(修正必須)」なのか、単なる「にらみつける(私見)」**なのかを一目で判別させ、レビューの停滞を回避する。

ブランチ戦略という「進軍ルート」:

どのブランチが「本番(殿堂入り)」なのかを明確にし、マージの掟をシステム(Protected Branches)で縛りなさい。

3. 🛡️ テスト・デプロイ:全滅を防ぐ「きあいのタスキ」

Section titled “3. 🛡️ テスト・デプロイ:全滅を防ぐ「きあいのタスキ」”

手動の動作確認は、命中率30%の「一撃必殺わざ」を連発するような博打です。

CIでの自動検証:

テストが通らないPRは、マージボタンを無効化(ロック)せよ。

**「きあいのタスキ」**のごとく、致命的な不具合が本番環境へ到達するのをシステム的に阻止しなさい。

4. ♻️ ルールブックの管理:死文化という「どく」状態の回避

Section titled “4. ♻️ ルールブックの管理:死文化という「どく」状態の回避”

ドキュメントと実態の乖離は、組織を内側から蝕む「どく」です。

Configこそが「唯一の真実(SSOT)」:

ルールを変更したいなら、ドキュメントを書く前に .eslintrc.prettierrc を修正するPRを出せ。

**「Configが正義、ドキュメントは添え物」**という優先順位を徹底し、ドキュメントと実装の不整合を根絶しなさい。

🪓 リーダー(トップトレーナー)への最終助言

Section titled “🪓 リーダー(トップトレーナー)への最終助言”

「素晴らしいルールとは、それを意識しなくても守れてしまうルールのことである。」

ルールブックを「分厚い教典」にしてはいけません。それはエンジニアの「すばやさ」を奪う**「しめつける」**にしかなりません。

目指すべきは、LinterやCIという強力な**「とくせい」**をチーム全体に付与し、英雄たちが「ただコードを書いているだけ」で、勝手に最高品質のプロダクトが組み上がってしまうような、洗練された「対戦環境(エコシステム)」の構築です。