開発

Claudeと一緒に製品や社内システムを作る従業員に向けて、作り始める前から公開後までの流れをまとめています。各段階で伝える前提、決めること、確かめる結果を扱います。設定やコードの書き方を調べるときは、開発者向けの製品、プログラミング、React、設計へ進みます。

作る前に事故を避ける

秘密が漏れる、リポジトリが公開される、データが消える、想定外の課金が続く。これらは実装の出来とは別に起き、後から戻せないことがあります。トークン・APIキーとリポジトリの公開範囲で情報が外へ出る経路を、Claudeへの権限で任せる操作の境界を扱います。データの事故とお金の事故は起きた後の影響を、個人情報・認証・決済は一人で進めず専門家と確認する領域を説明します。

Claudeと作り始める

事故を避ける境界が決まったら、Claudeと作業を進めます。新しく作るでは、製品の目的、利用者、規模、運用期間を伝えます。要件が固まっていなくても、分かっていることから話し、Claudeの質問に答えながら整理できます。推奨する技術スタックは、技術選定の共通の出発点です。すでに動いている製品には利用者やデータとの約束があるため、既存の製品を修正するでは影響範囲を確認してから変更します。

仕組みを理解する

作業中は、Claudeの説明や提案に技術用語が出てきます。用語の地図で話題の領域をつかみ、必要になったところからWebの構造、環境の分離、モック、バージョン管理、依存関係へ進むと、変更の影響や問題の原因を理解しやすくなります。

品質と構造を整える

作るものの規模と目的に合わせて、確認する範囲を決めます。品質の観点は動作をどう確かめるか、UIの観点は画面をどう揃えて使いやすくするか、構造の観点は処理やデータがどこにあるかを扱います。モジュール設計では変更がどこまで広がるかを確かめ、同じ形を繰り返す段階になったら構造を規約にすることで、次の追加でも同じ作り方を使える状態にします。

Claudeは依頼に関係する部分へ絞って作業するため、変更を重ねると全体の一貫性が崩れることがあります。個々の開発と全体を確認する横断点検は分け、見つかった課題は範囲を決め直して修正します。この分け方は開発・点検・保守を分けるで扱います。

公開後も育てる

公開後も、製品の判断と外部環境は変わります。仕様書に目的や判断を残し、公開範囲や本番運用の状態など、CLAUDE.mdに残した前提も更新します。日常点検では、依存の脆弱性や外部サービスの変更など、コードを変えていなくても起きる問題を確認します。開発者が行う環境設定や検証、チームでの運用は、製品のセクションで扱います。