Personal Blog Vibe Harness
運用目標
Codexが個人ブログのための忍耐強い実装ハーネスとして動作するように導くこと。エンドユーザーは、Git、Node、Hugo、frontmatter、ビルドログ、デプロイ設定、ビジュアルデザイン用語を理解しなくても、保守可能なサイトを入手できるようにします。
ブログフレームワーク、CMS、ホスティングプラットフォームを再発明しないでください。成熟したツールを組み合わせ、アーキテクチャは地味に保ち、すべての引き継ぎは非開発者が読めるようにします。
新しいブログに黙ってビジュアルスタイルを押し付けないでください。実装前に、簡単な質問、方向性の選択肢、プレビューを通じてユーザーの好みを発見します。
デフォルトスタック
ローカルに別の根拠がない限り、次のルートを優先します。
- Astroスターター:シンプルな個人ブログ、執筆アーカイブ、ニュースレター、軽量ポートフォリオ向け。
- HugoBloxスターター:アカデミック、研究、履歴書、ラボ、技術ポートフォリオ、Markdown中心のプロフェッショナルサイト向け。
- Pages CMS:ブラウザベースのコンテンツ編集が必要で、リポジトリがMarkdown/YAML/JSONコンテンツを保存する場合。
- GitHub Pages:GitHubネイティブの無料デプロイ。または、ユーザーが既にCloudflareを使用しているかカスタムドメインパスを希望する場合はCloudflare Pages。
スタックの選択が実装に影響を与える場合は、references/stack-routes.mdを読んでから選択してください。
ワークフロー
1. タスクの分類
現在のリクエストを次のいずれかに分類します。
new-blog:目標と好みから新しいブログを作成する。repair-blog:生成された、または既存のブログプロジェクトを修正する。migration:既存の文章、ノート、旧サイトのコンテンツを新しいブログに移行する。cms-setup:既存の静的ブログを非開発者が編集できるようにする。deployment:デプロイを公開または修正する。harness-work:このスキル、スクリプト、テンプレート、ワークフローを改善する。
タスクがコード変更ではなく、直接回答できるものであれば、直接回答してください。ファイルが必要な場合は、アドバイスで止まらずにプロジェクトを作成または変更します。
2. 必須の質問のみを行う
非開発者に対しては、最初のビルド概要の前に最大3つの製品質問を行います。リスクのない回答にはデフォルトを優先します。
最低限役立つ質問:
- ブログの目的は何ですか:個人的なエッセイ、技術メモ、研究プロフィール、ポートフォリオ、ニュースレター、またはそれらの混合?
- 既に文章、画像、ドメイン、またはGitHubアカウントを持っていますか?
- 最もシンプルなルートを希望しますか、それともよりカスタマイズ可能なルートを希望しますか?
ユーザーが漠然としたアイデアから始める場合や多くの既存資料がある場合は、references/intake-and-brief.mdを使用します。
3. ビジュアルスタイルの発見
new-blog、migration、およびスタイル重視のrepair-blogタスクでは、ユーザーが既存のデザインを使用することを明示的に指示しない限り、実装前にビジュアルスタイル発見ループを実行します。
references/visual-style-discovery.mdを読み、次の手順を実行します。
- ユーザーが不明確な場合、一度に1つの焦点を絞ったスタイルの質問をする。
- ユーザーに語彙がない場合、2〜3の対照的な方向性カードを提供する。
- 好みだけでなく、嫌いなものも収集する。
- 可能であれば、参考サイト、スクリーンショット、画像、書籍、ニュースレター、ブログ、ブランドを尋ねる。
- あいまいな言葉を具体的なデザインの選択肢に変換する。
スタイル概要を作成し、最初のビジュアルバージョンを構築する前にユーザーに確認または修正を求める。
ユーザーがスピードを重視する場合は、暫定スタイル概要を使用し、暫定とラベル付けし、最初の実装をスタイル変更しやすい状態に保ちます。
4. ビルド概要の作成
サイトを編集する前に、対象プロジェクトまたは会話内に短いビルド概要を記述します。
- 対象者と目的
- 選択したスタックとその理由
- コンテンツモデル
- ビジュアルの方向性
- 確認済みスタイル概要または暫定スタイル概要
- 編集ワークフロー
- デプロイ先
- リスクと前提条件
この概要は実用的に保ちます。戦略メモではなく、作業契約です。
5. 段階的に構築または修正する
プロジェクトが既に存在する場合は、既存のプロジェクトスタイルを使用します。新しいプロジェクトの場合:
- サイトをゼロから書く代わりに、メンテナンスされたスターターからスキャフォールディングする。
- コンテンツはMarkdownまたはMDXで保持する。
- 投稿、ページ、画像、サイト設定用の明確なフォルダを作成する。
- ユーザーに何を置き換えるべきかを教えるスターターコンテンツを追加する。
- コンテンツパスが安定した後にのみCMS設定を追加する。
- 余分なデータベース、認証システム、サーバーランタイム、特注の管理パネルは避ける。
CMS/デプロイの詳細については、references/cms-deployment.mdを読んでください。
6. メンテナンスを明確にする
提供されるすべてのブログには、次のタスクを実行するための明白な方法を含める必要があります。
- 新しい投稿を書く
- ホームページのテキストを編集する
- 画像を追加または置き換える
- ローカルでプレビューするか、デプロイプレビューを通じてプレビューする
- 変更を公開する
- ビルドが失敗した場合の回復方法
references/maintenance-playbooks.mdを使用して、簡潔なユーザー向け指示を生成します。
7. 検証
コードまたは設定変更後、プロジェクトに適したチェックを実行します。
- 依存関係がある場合のパッケージマネージャーのインストール/ビルド
- 静的サイトビルドコマンド(
npm run build、hugo --minifyなど) - ホームページ、投稿、画像、生成されたルートのリンク/パスの健全性チェック
- CMS設定の存在とパスの一貫性
- ワークフローが作成された場合のデプロイワークフローの構文チェック
簡易構造監査には、scripts/audit_blog_project.py <project-root>を使用します。選択したスタックに明らかに無関係でない限り、警告はアクションアイテムとして扱います。
8. 引き継ぎ
次の内容で終了します。
- 作成または変更された内容
- ユーザーがプロジェクトを開くべき場所
- プレビュー方法
- 実装されたスタイルの方向性とその変更方法
- 次の投稿の書き方
- GitHub、Pages CMS、Cloudflare、DNSの接続など、ユーザーによる手動アカウント操作が必要な内容
APIキーをチャットに貼り付けるようユーザーに依頼しないでください。GitHubやホスティング認証については、公式UIまたはローカルCLIフローを通じてサインインするよう依頼してください。
決定ルール
- ユーザーがシンプルなブログ、高速な反復、低い概念負荷、優れたMarkdown/MDX操作性を望む場合はAstroを選択する。
- ユーザーが研究者、学生、コンサルタント、エンジニア、またはクリエイターで、出版物、プロジェクト、履歴書、講演、プロフィールブロックが必要な場合はHugoBloxを選択する。
- ブラウザベースの編集が重要で、リポジトリにMarkdown/YAML/JSONコンテンツが保存されている場合はPages CMSを選択する。
- TinaCMSまたはKeystaticは、プロジェクトが既にそれらを使用している場合、またはユーザーがよりリッチな編集モデルを明示的に希望し、セットアップの複雑さを受け入れる場合にのみ選択する。
- Decap CMSは、プロジェクトが既にそれを使用している場合、またはデプロイの制約によりそれが最もリスクの低いパスである場合にのみ選択する。
- 個人ブログのMVPにはCloudflare VibeSDKを避ける。これはプラットフォーム構築キットであり、最もシンプルなブログハーネスではありません。
バンドルリソース
references/stack-routes.md:スタック選択マトリックスとビルドvsバイの根拠。references/intake-and-brief.md:簡潔なインテークフローとビルド概要テンプレート。references/visual-style-discovery.md:反復的なスタイルインタビュー、方向性カード、スタイル概要形式。references/cms-deployment.md:Pages CMSとデプロイ実装の注意点。references/maintenance-playbooks.md:非開発者向けメンテナンス引き継ぎパターン。scripts/audit_blog_project.py:生成または修正されたブログプロジェクトの構造監査。assets/pages-cms-astro-blog.yml:AstroスタイルMarkdownブログ用スターター.pages.yml。assets/github-pages-astro.yml:GitHub Pages上のAstro用スターターGitHub Actionsワークフロー。assets/content-brief-template.md:再利用可能なユーザー向けビルド概要。assets/first-post-template.md:非開発者向けスターター投稿テンプレート。