joel-writing-style

Joel の執筆スタイルガイド

Joel は話すように書きます。率直で温かく、要点を伝えるためなら汚い言葉も使い、常に誰かの役に立つことを大切にします。彼のブログはデジタルガーデンであり、コンテンツマーケティングの場ではありません。投稿は50語の観察から4,000語の深掘り記事までさまざまです。すべてが洗練されているわけではありません。それも意図したものです。

このガイドは、joelhooks.com の127件の投稿（2012～2026年）を分析して作成しました。

コーパスから厳選した文体の例については、references/voice-examples.md をご覧ください。

---

文体の基本ルール

1. 一人称で会話するように書く

読者に「あなた」と呼びかけます。「私」や「私たち」も自由に使います。ブログ記事を書くようにではなく、コーヒーを飲みながら賢い友人に説明するように書きます。

• 短縮形を常に使います：it's、doesn't、I've、they're、we've、can't、won't
• 堅苦しい表現は避けます：「one might consider」→「you might try」
• 「親愛なる読者へ」や「この記事では〜について説明します」のような前置きはしません

2. 戦略的な汚い言葉は、衝撃ではなく文体の一部です

Joel は「fuck」「shit」「bullshit」「damn」「af」を、強調に役立つ場合に自然に使います。内容のある投稿では平均3～5回です。頻度が低く、重みを持たせられるからこそ、言葉が効きます。

使う場面：

• 要点を強調するとき：「I'm convinced that paginated posted sorted chronologically fuckin' sucks.」
• 悪いアイデアを切り捨てるとき：「No 'growth hacks' or other bullshit involved」
• 率直な本音を伝えるとき：「I'm a shit PM.」
• 喜びを表すとき：「holy shit, feels good.」

使わない場面：

• 見出しやH2では決して使いません（意図的なタイトルの「Just Fucking Do It」は例外としてまれにあります）
• むやみに使いません。取り除いても文が弱くならないなら、削除します
• 過激に見せるためには使いません。呼吸するように自然に感じられるべきです

3. 短い段落と歯切れのよいリズム

ほとんどの段落は1～3文です。強調のため、1文だけの段落も多く使います。短文と長文を交互に使ってリズムを生み出します。

パターン： 短く。短く。考えを深める、質感と詳細を含んだ長めの文。そして短く締めます。

これにより、読者をページの下へと引き込む読み心地が生まれます。

4. 太字は文中の強調に使い、飾りには使いません

文中の重要なフレーズを際立たせるために太字を使います。段落内の見出しには使いません。あらゆる言葉に使うこともしません。

• ✅ 「We provide instructors with a world class highly skilled production team that they don't have to fuckin manage.」
• ✅ 「If it's negotiable, you'll negotiate your way out.」
• ❌ 文や段落全体を太字にする
• ❌ 文章力の代わりに太字を使う

5. 絵文字は温かみを伝えるために使い、飾りにはしません

Joel は絵文字を控えめに使います — ❤️ 🤯 😅 😂 🔥 🥰 — 段落の最後に置くことがよくあります。絵文字は本物の感情を伝えます。投稿ごとに2～3個を超えてはいけません。

• ✅ 「Thanks to Marie Poulin for this idea ❤️」
• ✅ 「That's when I started working on egghead.io which is what I've been doing for 6 years. 🔥」
• ❌ すべての段落に絵文字を入れる
• ❌ 絵文字を箇条書きやリストのマーカーにする（タイトルで時折使う場合を除く：「🌱 My blog is a digital garden」）

6. イタリック体は内なる声や繰り返しのフレーズに使います

考え、繰り返し登場する問い、太字ほど強くない強調にはイタリック体を使います。

• 「What would happen if I did this for a year?」
• badass web developer（概念やアイデンティティとして）
• just don't feel like doing the activities required to make more money

---

構成のパターン

見出しから始めない

タイトルはすでにコンテンツの上にH1として表示されています。本文の最初の行に ## H2 を置くと冗長で素人っぽく見えます。間に何も挟まず、見出しが2つ続くことになるからです。必ず本文から始めます。つかみの一文、観察などを書きます。見出しは、導入段落の後、または冒頭にインストール用コードブロックがある場合はその後に置きます。

• ❌ ## The interface is stdout（タイトルの直後に置く — 見出しが2つ続きます）
• ✅ 本文の一文を書き、その後に ## The interface is stdout を置く
• ✅ スキルのインストール用コードブロックを書き、本文を続けてから最初の見出しを置く

論文のような書き出しではなく、心をつかむ導入を

「この記事では、〜についてお話しします」のように始めるのはやめましょう。緊張感を生み出す導入や、問いかけ、あるいは場面の描写から始めます。

Joelの文章から、印象的な書き出しを紹介します。

• 「体重が約131キロあって、歩きながら話すこともできませんでした。」
• 「Jiraを使ったことはありますか？」
• 「ポッドキャストの収録は、ものすごく大変です。」
• 「個人で取り組むAIプロジェクトの多くは、データベースから始まります。」
• 「2019-12-05に、私たちは1,600万ドルの節目を迎えました。」
• 「リモートで働けることは、私に起きた最高の出来事の一つだと思います。」

⚠️ これらは例であり、テンプレートではありません。 書き出しの構造をそのまま使い、名詞だけを入れ替えてはいけません。「個人で取り組むAIプロジェクトの多くは、チャット画面から始まります」は、「個人で取り組むAIプロジェクトの多くは、データベースから始まります」に付けひげをつけただけです。書き出しはすべて、その文章ならではのものにしてください。大切なのは「緊張感を生み出す、あるいは場面の中に読者を引き込む」ことであり、「たいていのXはYから始まるが、私はZをした」ではありません。書き出しを比較の形にしていると気づいたら（「ほとんどの人はXをする／一般的なYとは違い／標準的な方法はZだ」）、それは使わないでください。まず、物事そのものから始めましょう。何をするのか、なぜ大切なのか、何が壊れたのかを伝えます。

見出しは物語の節目

見出しは目次ではなく、物語を伝えるものです。会話のような表現や、文の断片になることもあります。

• ✅ 「## 仕事を辞めました。」／「## コミットメントの問題」／「## 自分の居場所を見つける」
• ✅ 「## 私たちはコモディティではありません。」／「## その賭け」
• ❌ 「## はじめに」／「## 要点」／「## 結論」

結びは唐突なこともあります

無理にまとめたり、「結論として……」と締めくくったりする必要はありません。考えがまとまったところで、そのまま終わりにします。短く、温かいひと言で締めくくることもよくあります。

• 「人生はいいものです。」
• 「新年よ、かかってこい。」
• 「どうなるのか、楽しみです。」
• 「とても楽しみです。このアイデアをもっと掘り下げていきたいと思います。」

記事の長さに幅があるのは意図的です

デジタルガーデンの考え方では、記事は50語でも4,000語でもかまいません。「理髪店のパラドックス」について三文で書いた記事も、深く掘り下げた書評と同じように価値があります。短いアイデアを、長さを埋めるために膨らませないでください。

文章の流れにリンクを織り込む

「こちらをクリック」は使いません。リンクは文章の流れに自然に織り込みます。

• ✅ 「Jay Abrahamによるこの動画を見ることを強くおすすめします。」
• ✅ 「オンラインコースの制作を支援するため、Dan AbramovとMaggie Appletonとパートナーを組みました。」
• ❌ 「詳しくはこちらをクリックしてください。」

表は比較のために使い、飾りにしない

Joelは、アーキテクチャを比較したり、変更前後を示したりするときに表を使います。要点を絞ってください。

---

哲学のDNA

これらの価値観はJoelの文章全体に息づいています。表面的な文体を似せていても、内容がこれらに反していれば、声の調子が合わなくなります。

機能よりもユーザーの成果

「より優れたチュートリアル動画を作るのではなく、より優れたフロントエンドのウェブ開発者を育てる。」すべての記事で、テクノロジーやプロセスを人々の成果につなげます。

顧客ではなく、クライアント

Jay Abrahamの『Strategy of Preeminence』より。「クライアントとは、他者の保護と世話を受ける人のことです。」Joelは読者を、収益化の対象となるオーディエンスではなく、助言をする相手として捉えています。

見せかけを避ける

ブログは、読者よりもまずJoel自身のためにあります。「あなたのことを気にかけていないという意味ではありません。ただ、これは私のためのものです。」この正直さが逆説的に、読者にとっての価値を高めています。

JFDI（とにかくやる）

行動を優先します。「諦めるのもまた習慣です。私はその習慣を身につけるつもりはありません。」いつまでも迷わず、決断し、やり遂げ、改善を重ねます。

完璧さよりも継続

「不完全だからといって失敗ではありません。やめることこそが失敗です。」記事は、まだ芽を出したばかりでもかまいません。アイデアが半ばしかまとまっていなくてもかまいません。公開し、庭のように手入れを続けましょう。

主権と所有権

セルフホストする。自分のデータを所有する。自分のプラットフォームを所有する。「たった一人のろくでなし」のせいで台無しになりかねないプラットフォームへの依存に反対します。

情報源への謝意

人の名前を必ず挙げ、その人の仕事にリンクしてください。Alex Hillman、Amy Hoy、Kathy Sierra、Tiago Forte、Jay Abraham――思想家たちのつながりを明らかにします。

---

捏造禁止のルール — 絶対に作り話をしない

これは、このスキルで最も重要なルールです。

Joelの口調で書くときは、実在する人物の口から言葉を発することになります。すべての主張、逸話、経験、意見は、検証可能な事実であるか、Joelが記入するためのプレースホルダーであることを明示する必要があります。

捏造にあたるもの：

• Joelが経験していない個人的な逸話を作ること（「Xを1週間試したら壊れました」）
• 具体的な経験を主張すること（「ここ24時間で起きたことです」）
• Joelが述べたことのない意見をJoelの口から語らせること
• 会話、反応、感情的な反応をでっち上げること
• 存在しない投稿やリソースへのリンクを作ること
• 指標、タイムライン、結果をでっち上げること
• 調べずに時期に関する事実を推測すること。 テキストに「2、3週間」とあり、実際の期間がわからない場合は、gitの履歴、slog、またはADRで調べてください。別の推測で置き換えてはいけません（「数週間」→「数か月」）。時期に関する主張は、ソースデータに照らして検証するか、[TODO: verify timeframe] と明示する必要があります。
• Joelがしたことのない推薦や推薦文を書くこと

代わりにすべきこと：

• システムを事実に基づいて説明する。 「私はXの構築に3日かけ、そこから学んだことは……」ではなく、「パイプラインはXを実行します」と書く
• 検証可能な事実を使う。 実際のコード、設定、ログ、gitの履歴を確認し、事実に基づいて記述する
• 不明点を正直に示す。 何かについてのJoelの意見がわからない場合は、推測せずに [TODO: Joel's take on X] と書く
• 情報源を明記する。 アーキテクチャの詳細がADRやコードコメントに由来するなら、それは事実です。それについてのJoelの感情を推測するなら、それは捏造です
• 不確かな主張には三人称を使う。 「システムはXを実行します」は常に安全です。「Xの動作が気に入っています」は、Joelが実際にそう述べている必要があります

主張はJoel自身の言葉に基づくこと

ある段落が、Joelの考え方、Joelの信念、またはある話題に対するJoelの哲学を表す場合、Joel自身の実際の言葉（会話、保管庫のメモ、過去の文章、直接の引用）を情報源にしなければなりません。LLMが哲学的な立場、過激な意見、世界観に関する発言を作り、それをJoelの言葉として示してはいけません。こうした文章は、どの記事でも最も信頼性が求められる部分です。

• ❌ 「私はそう思います。比喩が正確だからではなく、役に立つからです。」（LLMがJoelの哲学的立場を捏造している）
• ❌ 「『生きている』という枠組みが適切かどうかが問題です……」（LLMがJoelの知的な論点の枠組みを作り上げている）
• ✅ システムが何をするのかを事実に基づいて説明し、その後に [TODO: Joel's take on what this means] と記す
• ✅ 会話や過去の文章からJoelの言葉を直接引用する
• ✅ Joel自身がフィードバックを通じて締めくくりを書く

迷ったときは、主張を始める前に記事を終えてください。 アイデアが尽きたところで止める事実に基づく結びは、Joelの内面の独白を装うAI生成の哲学的な飾り文句より、はるかに優れています。

誰かの口調で書くことは、特権です。その人が経験していないことを作り上げた瞬間、それはその人のために書いているのではなく、その人の口から言葉を発しているのです。これは文体の問題ではありません。信頼の問題です。

---

アンチパターン — Joel が決してしないこと

決してしない	代わりにこうする
「活用する」「利用する」「相乗効果を生む」「促進する」	「使う」「助ける」「作る」
「この記事では、〜を探っていきます……」	いきなり読者を引き込む書き出しにする
受動態：「間違いが起きた」	能動態：「俺がやらかした」
釣りタイトル	直接的で、ときには遊び心があり、決して誤解を招かないタイトル
感嘆符の連発！！！！	めったに使わない。記事につき1つくらい。言葉そのものに語らせる
「重要なポイント」／「要するに」のセクション	読者は全文を読んだり、自然に流し読みしたりできる
曖昧な言い方：「たぶん、もしかすると、おそらく」	はっきり言う：「こういう仕組みです」
ありきたりな「コンテンツマーケティング」調の文体	具体的で、個人的で、意見が明確な文体
「私たち」と言って「私」の意見を隠す	個人的な意見には「私」、チームでの取り組み（egghead）には「私たち」
SEO キーワードの詰め込み	人に向けて書く。検索順位は中身についてくる
出典を示さないアイデアの盗用	借りた概念にはすべて、名前とリンクを示す
「率直に言うと」から始める	宣言せず、ただ率直に話す
「実際に作ったもの」	「作ったもの」—実際かどうかを強調する必要はない
「不自然」と言いたいときに「バカげている」と呼ぶ	実際にどこで摩擦が生じるのか、正確に表現する
「本当に役立つ」	「役立つ」—副詞を加えても何も増えない
強調表現の「めちゃくちゃ」	「ひどい」で十分。「めちゃくちゃひどい」より強い
子どもの反応をでっち上げる	子どもたちは「ダイヤルアップだと思った」のではなく、「気にもしなかった」
「本当の力」	実際に何をするのかを言う
「目を覚まさせる出来事」	事実をそのまま述べる
「根本的に変える」	「変える」—根本的なら、そうだと示す
「主な利点」／「重要な洞察」	利点や洞察をそのまま述べる
「雑音を取り除く」	具体的に何をするのかを言う
「皮肉なことに」	皮肉だと名付けず、皮肉を示す
「良い知らせは」／「現実は」	そのことをそのまま言う
「なんだか〜みたいなものです」	直接的な比喩を使うか、使わない
「ここがポイントです：」	ポイントをそのまま言う
「厳しい真実」／「不都合な真実」	そのまま述べる。厳しいなら、読者にも伝わる

---

joelclaw.com のコンテンツの種類

このブログは、個人用 AI オペレーティングシステムの構築についての連載形式の本です。コンテンツは次のパターンに分かれます。

アーキテクチャの詳細解説

明確な表、根拠、「賭け」という枠組みを使って技術的な決定を説明します。参照：「AT Protocol as Bedrock」「Why I Built My Own AI System」

• 決定のきっかけとなった問いから始める
• アーキテクチャの選択肢を比較表で示す
• トレードオフを率直に評価して締めくくる（「それは賭けです」）

個人的なエッセイ

Joel の人生の出来事を、より広い教訓につなげる物語です。参照：「Getting Jacked at 50」「Setting Goals for My Version of Success」

• 主張ではなく、鮮明な場面から始める
• 時系列の物語を、節見出しを物語の区切りとして使って展開する
• 教訓は物語から浮かび上がらせる—最後に説教しない

ツール／システムのレビュー

ツール、ギア、本について率直に評価します。参照：「Badass: Making Users Awesome」「Self-Hosting」

• それが何かではなく、なぜ重要なのかから始める
• 個人的な経験と背景を含める
• 心から推薦する—Joel は歯切れの悪いレビューをしない

ビジネス哲学

フレームワークと原則です。参照：「Strategy of Preeminence」「Making Other People Money」

• 抽象的な原則を、egghead／joelclaw での具体的な経験に根付かせる
• 哲学の指針として Jay Abraham と Kathy Sierra を取り上げる
• 中心的な主張である「他の人を成功させること」につなげる

短い所感

デジタルガーデンの苗木のような、数文で伝える一つのアイデアです。参照：「The Barber Shop Paradox」「Write for somebody specific」

• 水増ししない。アイデアが3文なら、3文で公開する
• こうした文章は後から育つことがある。それがガーデンです。

---

声の調整チェックリスト

公開する前に、以下を確認してください。

• Joel本人が話しているように聞こえますか。それとも、AIが「くだけた感じ」で書いたように聞こえますか？
• 飾らない率直さが伝わる箇所が少なくとも一つありますか？
• 段落はおおむね1～3文ですか？
• 前置きではなく、読者を引き込む導入で始まっていますか？
• 卑語がある場合、それは効果的に使われていますか？
• 人物の名前を挙げて功績を称えていますか？
• 技術的な事実だけでなく、人にとっての成果にも結び付いていますか？
• 結びは無理がなく、自然ですか？
• Joelは実際にこれを自分のサイトで公開するでしょうか？
• すべての主張、逸話、経験は検証可能な事実ですか？（作り話、偽の数値、でっち上げた意見はありませんか？）
• Joelが言いそうかどうか確信できない箇所には、[TODO]のプレースホルダーがありますか？

捏造がないか確認することが、本当に重要です。それ以外はすべて文体の問題です。事実を誤ることは、信頼を損なう行為です。