本文へ移動
cccskills
無料GitHub で公開

infra-design

Use for the infrastructure design phase between domain exploration and Lean formalization — deriving non-functional requirements from the Lean model, deciding environments (test/local/prod), identity provider, the relational database's product, version and configuration (the storage kind is fixed to relational), ID representation, and the list of things NOT to build. Produces documents/infra-design with INFRA-D/A/Q entries.

インストール方法を見る

含まれるファイル(1)

  • SKILL.md3.0 KB

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

インフラ設計フェーズ

入力は lean/ の実行可能仕様と documents/ddd/ の正式ドキュメントだけ。open の UX / MQ は根拠にしない。 成果物は documents/infra-design/(README + 01_model-to-infra + 02_local + 03_production + 04_operations)。実装(infra/)はインフラ実装フェーズ(infra-implement スキル。バックエンド追随の後)。 保存先は関係データベース(Cradle の前提。backend の規約・生成器・ktlint ルールがこれに依る)。インフラ設計で決めるのは製品・版・構成。

手順

  1. cradle status と cradle spec-query meta で、モデルにある集約・コマンド・内部入力(通知・契機)・外部能力の Port・画面・境界入力(名義・時計)を把握する。
  2. 01_model-to-infra.md の問いに答える: 入口、直列化点(横断不変条件をどこで守るか)、時計、名義(誰が確定するか)、同一性の表現(連番か UUID か — NFR を根拠に)、作らないもの(モデルに裏付けの無いインフラの一覧)。
  3. 環境を 3 つ決める(test = 外部依存なし、local = 本番同等のコンテナ + モック発行者、prod)。検証を飛ばすプロファイルは作らない。
  4. 決定を INFRA-D-xxx として根拠(モデルの定理名・HS)付きで表に書く。裏付けの無い仮定は INFRA-A-xxx(サイジングにだけ使う)。ユーザーの判断が要るものは INFRA-Q-xxx として問いの形で残し、暫定を書く。決着・却下は状況列に書き、行は消さない(書き方は documents 規約)。
  5. 決定のうちモデルへ反映すべきもの(ID の表現など)は lean-domain-model に渡す(ゆえに順序はインフラ設計 → Lean 化)。
  6. 運用(デプロイ手順・監視・障害時・スキーマの当て方)を 04 に書く。CI で本番イメージを焼く前提にする。

決めごと

  • 設計に日付付きの進捗チェックリストを残さない。状態は cradle status と git が持つ。投入表(README)だけは投入した事実として日付を持つ。
  • 実装が入って前提が変わったら設計を直す(README の「実装後の見直し」に事実だけ)。
  • 秘密・平文・fail-open な既定値を設計段階で潰す(証明書未設定で平文に倒れる既定を置かない)。
  • 「性能ではなく設計判断」を含む未決は勝手に決めず INFRA-Q に。選択肢 A / B と効くところ・引っかかるところを表にする。

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Use when adding or changing REST endpoints or the OpenAPI contract — deriving endpoints from the Lean commands and views, writing documents/codebase/openapi.yaml first, then regenerating the backend controller interfaces and the frontend client.

日本語の概要は準備中です。原文の説明を表示しています。

asuka1975/cradle42026年10月1日 更新

Use after a backend build succeeds or whenever authentication, authorization, actor/identity handling, external service calls (IdP, JWKS, DB, clock), logging, observability, configuration or error contracts are in play — delegates to the backend-design-reviewer agent for a design-quality review of the current branch.

日本語の概要は準備中です。原文の説明を表示しています。

asuka1975/cradle42026年10月1日 更新

Use when it is time to make the backend follow the Lean model — regenerate Kotlin from Lean, implement the generated interfaces (UseCase, QueryService, Repository, Entity), wire every generated contract test, make the build green, then run the design and SQL reviews. Backend comes after the human confirmed the screens.

日本語の概要は準備中です。原文の説明を表示しています。

asuka1975/cradle42026年10月1日 更新

cradle

無料

Use when you need the current position in the Lean spec-driven pipeline, or any deterministic check of a Cradle project — status, golden regression, Lean layer walls, regeneration impact, unslop lint, ddd cleanup. Runs the scripts under scripts/ and reports their output verbatim.

日本語の概要は準備中です。原文の説明を表示しています。

asuka1975/cradle42026年10月1日 更新

Use to start a new product on Cradle or to add the Cradle skeleton to an existing repository — writes cradle.json, the project-facts instruction (.apm/instructions/project.instructions.md), documents/{ddd,ai-notes,infra-design,codebase} templates, CI, and a compiling Lean executable-spec scaffold with a minimal example domain, mockup and CLI.

日本語の概要は準備中です。原文の説明を表示しています。

asuka1975/cradle42026年10月1日 更新

Use when the product owner asks where the project stands, what to do next, or which phase of the Lean spec-driven pipeline is current — runs cradle status and proposes exactly one next step.

日本語の概要は準備中です。原文の説明を表示しています。

asuka1975/cradle42026年10月1日 更新

asuka1975 のスキルをすべて見る

このスキルの問題を報告する