Projectsへ戻る

webapp-blueprint

Coding AgentとWebアプリを開発するときの規約、検査、初期化手順をまとめたプロジェクトテンプレートです。

View on GitHub

Overview

webapp-blueprintは、Coding Agentと一緒にWebアプリを作り始めるためのプロジェクトテンプレートです。完成済みの技術構成をそのまま複製するのではなく、作るものを確認し、調査と技術的な議論を済ませてから、選んだ構成だけを初期化します。

リポジトリには実装の雛形だけでなく、原則、ツール別のレシピ、検査スクリプト、Coding Agent向けのskillsを含めています。規約をプロンプトだけに頼らず、可能な範囲でlintやテストとして検査できる状態から開発を始めるための土台です。

What I Built

  • 対話による初期化

    作りたいものと技術上の選択を確認してから、必要な構成だけをプロジェクトへ反映します。

  • 規約の三層構造

    長く残す原則、交換可能なレシピ、現在の設定やスクリプトを分けて管理します。

  • 機械的な検査

    lint、型検査、テスト、依存関係やアーキテクチャの検査を、一つの実行経路へまとめています。

  • Coding Agent向けの文脈

    AGENTS.md、skills、検索可能な設計資料によって、実装時に必要な判断材料を渡します。

Problems

  • プロジェクト固有の設計判断を、テンプレートの暗黙の既定値で決めないこと。
  • 規約を文章だけに置かず、静的に検査できるものはツールで強制すること。
  • 原則と特定ツールの設定が混ざり、更新しづらくなるのを防ぐこと。

Results

  • clone後にCoding Agentとの対話からプロジェクトを初期化できる形にしました。
  • 設計資料、実装規約、検査コマンドを同じリポジトリで参照できるようにしました。
  • シークレットを実値ではなく1Passwordの参照として扱う運用を組み込みました。