agentleFS
aToy0m0aToy0m0/skills/system-design/SKILL.md

system-design

Skill2 starsChanged 2 months agoMITView on GitHub

システム、アプリケーション、インフラの設計・実装・レビュー時に設計規約を適用する。AWSではCloudWatch Logs保持期間を明示し、CDKまたはCloudFormationでは専用設計スキルも参照する。

64 other projects use a version of this.

Adopted by

Most recently taken up by

Used with

Projects with it also use data-pipelines, data-engineering and 10 more.

Other files people use alongside this one.

Files found in the same public projects as a version of this one, more often than they turn up anywhere else. Each project counts once, large collections count for less, and this file's own repository is left out.
  • YepAPISkill

    data-pipelines

    ETL patterns, cron scheduling, queue-based processing, and batch jobs with Inngest/BullMQ.

    Also in 3 projects that use this

  • travisjneumanSkill

    data-engineering

    ETL/ELT pipelines, data warehousing (BigQuery, Snowflake, Redshift), stream processing (Kafka, Spark Streaming), orchestration (Airflow, Dagster, Prefect), dbt transformations, and data lake architecture. Use when building data pipelines, designing warehouse schemas, or implementing real-time data processing.

    Also in 4 projects that use this

  • wpankSkill

    caching

    Caching strategies, invalidation, eviction policies, HTTP caching, distributed caching, and anti-patterns. Use when designing cache layers, choosing eviction policies, debugging stale data, or optimizing read-heavy workloads.

    Also in 3 projects that use this

  • OpenAISkill

    observability

    Vercel Observability expert guidance — Drains (logs, traces, speed insights, web analytics), Web Analytics, Speed Insights, runtime logs, custom events, OpenTelemetry integration, and monitoring dashboards. Use when instrumenting, debugging, or optimizing application performance and user experience on Vercel.

    Also in 12 projects that use this

  • mmondoraSkill

    infrastructure-as-code

    Infrastructure as Code with Terraform and Pulumi. State management, modularity, drift detection, secrets handling. Use when provisioning cloud resources, writing Terraform/Pulumi modules, or managing infrastructure configuration.

    Also in 3 projects that use this

  • ayudaySkill

    autoplan

    Auto-review pipeline — reads the full CEO, design, and eng review skills from disk and runs them sequentially with auto-decisions using 6 decision principles. Surfaces taste decisions (close approaches, borderline scope, codex disagreements) at a final approval gate. One command, fully reviewed plan out. Use when asked to "auto review", "autoplan", "run all reviews", "review this plan automatically", or "make the decisions for me". Proactively suggest when the user has a plan file and wants to run the full review gauntlet without answering 15-30 intermediate questions.

    Also in 3 projects that use this

The file

Files
SKILL.md

System Design

対象にAWS CDKまたはCloudFormationが含まれる場合は、AWS CDK / CloudFormation Designを最後まで読み、必要な参照資料を適用する。

規約の正本を分ける。CloudWatch Logs保持日数はこのスキルが管理し、CDK / CloudFormationの設定境界、固定セキュリティ基準、命名、更新・削除安全性はaws-cdk-cloudformation-designが管理する。同じ規約を両方へ複製しない。

設計・実装・レビューの対象にAWSへのデプロイが含まれる場合、CloudWatch Logsを作成するすべてのリソースについて保持期間を確認する。AWS以外ではこの規約を適用しない。

  • 新しく作成するロググループは、IaCで保持期間を明示的に180日に設定する。AWSの無期限保持へ依存しない。
  • Lambdaなどが暗黙に作成するロググループも対象に含め、使用するIaCの合成結果または同等の出力で設定を確認する。
  • 法令、監査、障害調査、環境特性などにより180日以外が必要な場合は推測で変更せず、理由と候補期間を示してユーザーへ確認する。
  • 既存ロググループへの保持期間設定は古いログを期限切れにするため、新規設計の依頼だけを根拠に変更しない。対象と影響を示してユーザーへ確認する。
  • デプロイが依頼範囲に含まれる場合は、デプロイ後に実際のロググループの保持期間が180日またはユーザー指定値であることを確認する。

AWSフロントエンドでのAmplify採用判断

AWS上のWebフロントエンドを設計するときは、「Amplify」を一括りにせず、次を分けて採否を判断する。

  • Amplify Hosting
  • Amplify Backend / Gen 2
  • aws-amplifyなどのフロントエンドライブラリ

静的SPAを作り込み、CDKやCloudFormationでインフラを管理し、配信・キャッシュ・オリジン・WAF・認証先への経路を明示的に制御する場合は、S3とCloudFrontを第一候補にする。Amplify Hostingは、ブランチ連携、プレビュー環境、ビルド・デプロイの一体運用といった管理機能に価値がある場合に採用する。単に静的ファイルを配信するためだけには追加しない。

Amplify Hostingを採用しない判断から、フロントエンドライブラリまで自動的に排除しない。CognitoのSRP、トークン更新、認証状態管理などを安全に実装するためにaws-amplify/authだけを使う構成は独立に評価する。反対に「Amplify不採用」が製品・依存ライブラリを含む要件なら、ライブラリも含めて除外し、代替手段と自前実装範囲を明示する。

設計書では少なくとも、Hosting、Backend、フロントエンドライブラリの採否を個別に記載し、「Amplifyを使う/使わない」だけで済ませない。

このスキルに別の設計規約を推測で追加しない。

Download now (ZIP)

Does it work?

Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.

Reviews can't be read right now.

Your trail

Files you open will collect here, so you can find them again.

Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.

Now do this for your own.

Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.