CLAUDE.mdの書き方と効果：プロジェクト設定ファイルでAIの動作を制御する方法
Shiori
AIがプロジェクト開始時に最初に読む設定ファイル「CLAUDE.md」の書き方と、設定前後でAIの動作がどう変わるかを具体的に説明します。
Blog
ClaudeとCodexの使い分け：同じリポジトリで2つのAIにバトンタッチした判断基準
Shiori
同じプロジェクトでClaude CodeとCodexを使い分けている判断基準と、途中でバトンタッチした具体例を記録します。
DocとBlogで引用ルールを変えた理由：個人体験記事の参考文献設計
Shiori
ドキュメント記事とブログ記事では、引用が必要な情報の種類が異なります。体験と外部事実が混在する記事での引用判断の基準と、体験部分と事実部分を分けて書き直す方法を整理します。
featureブランチでGitコンフリクトが4回起きてから撤退した記録：AIとのGit運用の実際
Shiori
featureブランチで4回連続してGitコンフリクトが発生し、最終的にブランチを破棄して再起動した経緯と、そこから得た教訓を記録します。
MermaidとAIの組み合わせで発生した問題：図が正しく表示されなかった5つのパターンと対処
Shiori
AIがMermaid記法を書く際に実際に発生した5つの問題パターン（特殊文字、矢印の向き、ラベル長、日本語、入れ子）と、それぞれの対処方法を記録します。
shared/ディレクトリの設計：AIが参照するルール・スキル・ワークフローの整理方法
Shiori
AIに渡すルールファイルが増えてきたときの整理方法を説明します。rules・skills・workflowという3つの役割でファイルを分類したshared/ディレクトリの設計思想を紹介します。
SKILL.mdでAIの専門タスクを定義する：スキル設計で再現性を高める方法
Shiori
AIに毎回同じ指示を繰り返すより、スキルファイルとして手順を定義しておく方が作業品質が安定します。このサイトで実際に作ったSKILL.mdの設計と、その効果を整理します。
Spec First：AIに実装させる前に仕様書を書くと、なぜ結果が安定するのか
Shiori
AIへの実装依頼の前に仕様書を書くことで、意図と異なる実装や繰り返し修正が減ります。Spec Firstという考え方と、仕様書の書き方を説明します。
VercelのCI/CD設定をAIと進めた手順：デプロイ自動化の実装記録
Shiori
コードを変更するたびに手動で公開作業をしていたサイトを、Vercelのデプロイ自動化機能を使って自動更新できるように設定した体験記録です。AIと一緒に設定を進めた手順と、発生した問題への対処を整理します。
Vibe Coding 入門で最初につまずく3つのポイントと対処法
Shiori
Vibe Codingを始めたときに経験した3つの具体的な問題（曖昧な指示、意図と異なるデザイン生成、文脈の途切れ）とその対処法を整理します。
Vibe Codingでサイトを作って3ヶ月で学んだこと：技術・設計・運用の気づきをまとめた総括
Shiori
AI Learning PlaygroundをVibe Codingで構築・運用した3ヶ月間を振り返り、技術・設計・運用の3フェーズで得た気づきを整理します。
Vibe Codingでサイトを構築した全工程：設計から公開まで、AIとどう進めたか
Shiori
AIと協働してゼロからWebサイトを構築した体験を工程順に記録します。何をAIに任せ、何を自分で判断したかを具体的に説明します。
Vibe Codingとは何か：コードを「書く」から「指示する」に変わる開発スタイル
Shiori
Vibe Codingの概念を整理します。プログラミングの知識がなくてもAIへの指示でサイトや機能を作れる開発スタイルとはどういうものか、何ができて何ができないかを具体的に説明します。
Vibe Codingの次のステップ：「作れる」から「継続的に維持できる」への移行で必要になったこと
Shiori
Vibe Codingでサイトを作った後、維持・運用のフェーズに入って初めて必要になったハーネス・テスト・バリデーションの実例を記録します。
コミット前の変更がある状態でClaude CodeからCodexへ引き継ぐ手順
Shiori
dirty worktreeの状態でClaude CodeからCodexへ移るときに起きた問題と、安全に引き継ぐための手順を記録します。
トークン節約とコード品質のバランス：設定を削りすぎて品質が下がった実例
Shiori
AIへの入力情報を削減してコストを下げようとしたところ、出力品質が下がった実例と、何を削ると問題になるかの判断基準を記録します。
ハーネスエンジニアリングとは何か：AIをプロジェクトで継続的に使うための設計手法
Shiori
AIに毎回同じ質問をしても答えが変わる、前回の作業を覚えていない——そうした課題への対処として「ハーネスエンジニアリング」という設計手法を整理します。
ハーネスエンジニアリングの費用対効果：設定ファイルへの投資が工数削減につながった実例
Shiori
CLAUDE.mdやルールファイルを整備する時間は本当に必要なのか。ハーネス整備の前後で何が変わったかを、体験をもとに具体的に説明します。
ハーネスドリフトとは何か：AIの設定とコードのずれを検出・防止する方法
Shiori
設定ファイルとコードの実態が時間とともにずれていく「ドリフト」は、AIを使ったプロジェクトで発生しやすい問題です。その原因と防止策を整理します。
ブログ執筆AIの設定方法：my-blog-writing SKILLで著者の声とトーンを定義したこと
Shiori
AIに記事を書かせると著者らしさが消えやすい問題に対し、my-blog-writing SKILLで著者の視点・文体・禁止表現・E-E-A-Tのチェックリストを定義しました。スキル定義前と後の品質の変化を整理します。