AGENTS.mdとCLAUDE.mdの違い:同じリポジトリでClaudeとCodexに別々のルールを読ませる方法
CLAUDE.mdとAGENTS.mdの役割の違いと、共通ルールを重複なく管理するためにshared/を活用した設計を説明します。
CLAUDE.mdとAGENTS.mdの役割の違いと、共通ルールを重複なく管理するためにshared/を活用した設計を説明します。
AIに別の作業を依頼していたところ、ナビゲーションのレイアウトが変更されていた経験から、UIを保護するルールをCLAUDE.mdに追加した経緯と効果を説明します。
AIに別の修正を依頼している流れで、本番デプロイコマンドが実行された経緯と、その後に導入した承認制ルールの記録です。
AIが書いた日本語はそのままビジネス文書に使えないことがあります。誇張表現・口語副詞・比喩的な危険表現・個人ブログ的な表現という4つのパターンごとに、具体的な書き換え例を整理します。
設定ファイルの整合性を手動でチェックし続けることには限界があります。AIと一緒にバリデーションスクリプトを作った過程と、自動検出が有効だった理由を整理します。
AIが実装を担当するとき、人間は何をすべきか。AIに任せてよい作業と、人間が必ず確認すべき作業を具体的に分類して整理します。
AIは会話をまたいで記憶を持たないため、修正済みの問題が繰り返されます。その対処として作成した「lessons.md」の設計と運用方法を説明します。
Astro、Starlight、Vercelの3つを組み合わせたサイト構成をAIと一緒に設定した実体験記録。各ツールの役割と、設定作業でAIに委託した部分・自分で確認した部分を整理します。
Claude Code hooksを使って、ファイル編集前のバックアップやコマンド実行後の自動バリデーションを設定した実例を紹介します。
同じプロジェクトでClaude CodeとCodexを使い分けている判断基準と、途中でバトンタッチした具体例を記録します。
AIに渡すルールファイルが増えてきたときの整理方法を説明します。rules・skills・workflowという3つの役割でファイルを分類したshared/ディレクトリの設計思想を紹介します。
AIに毎回同じ指示を繰り返すより、スキルファイルとして手順を定義しておく方が作業品質が安定します。このサイトで実際に作ったSKILL.mdの設計と、その効果を整理します。
AIへの実装依頼の前に仕様書を書くことで、意図と異なる実装や繰り返し修正が減ります。Spec Firstという考え方と、仕様書の書き方を説明します。
コードを変更するたびに手動で公開作業をしていたサイトを、Vercelのデプロイ自動化機能を使って自動更新できるように設定した体験記録です。AIと一緒に設定を進めた手順と、発生した問題への対処を整理します。
Vibe Codingを始めたときに経験した3つの具体的な問題(曖昧な指示、意図と異なるデザイン生成、文脈の途切れ)とその対処法を整理します。
AIと協働してゼロからWebサイトを構築した体験を工程順に記録します。何をAIに任せ、何を自分で判断したかを具体的に説明します。
Vibe Codingの概念を整理します。プログラミングの知識がなくてもAIへの指示でサイトや機能を作れる開発スタイルとはどういうものか、何ができて何ができないかを具体的に説明します。
Vibe Codingでサイトを作った後、維持・運用のフェーズに入って初めて必要になったハーネス・テスト・バリデーションの実例を記録します。
AIへの入力情報を削減してコストを下げようとしたところ、出力品質が下がった実例と、何を削ると問題になるかの判断基準を記録します。
AIに毎回同じ質問をしても答えが変わる、前回の作業を覚えていない——そうした課題への対処として「ハーネスエンジニアリング」という設計手法を整理します。