Borrowing it
Nothing to install: this file belongs to yoshimi-I/ai-engineer-teams. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/yoshimi-I/ai-engineer-teams/main/.kiro/skills/quality-guidelines/SKILL.mdgit clone --depth 1 https://github.com/yoshimi-I/ai-engineer-teamsWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/skills/yoshimi-i/ai-engineer-teams/quality-guidelines)<a href="https://agentmods.dev/skills/yoshimi-i/ai-engineer-teams/quality-guidelines"><img src="https://agentmods.dev/badge/skills/yoshimi-i/ai-engineer-teams/quality-guidelines/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/skills/yoshimi-i/ai-engineer-teams/quality-guidelines"><img src="https://agentmods.dev/badge/skills/yoshimi-i/ai-engineer-teams/quality-guidelines.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.00113 | $0.01225 |
| Opus 5 | $0.00056 | $0.00613 |
| Sonnet 5 | $0.00023 | $0.00245 |
| Haiku 4.5 | $0.00011 | $0.00122 |
Grade A, and why
quality-guidelines scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 9d ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
What it actually says
品質ガイドライン
TDD（テスト駆動開発）
- Red: 失敗するテストを先に書く
- Green: テストを通す最小限のコードを書く
- Refactor: クリーンアップ（テストは引き続きパス）
ルール:
- テストなしの実装コード禁止
- バグ修正は再現テストから始める
- 実装の内部ではなく振る舞いをテスト
テスト戦略（3層）
ユニットテスト
- 全ビジネスロジックとユーティリティ関数に必須
- 外部依存はモック/スタブで分離
- 関数ごとに最低: ハッピーパス1 + エラー1 + エッジケース1
- フロントエンド: コンポーネントの振る舞い（レンダー、イベント、状態）
- バックエンド: ドメインロジック、サービス、バリデーション
統合テスト
- 全APIエンドポイントに必須
- バックエンド: リクエスト → レスポンスの完全フロー（DB含む）
- フロントエンド: API呼び出し → UI更新フロー
- WebSocket: 接続 → 送受信 → 切断
- DB: マイグレーション → CRUD → ロールバック
E2Eテスト（Playwright）
- 全主要ユーザーフローに必須
- ページナビゲーション、フォーム送信、認証フロー
- レスポンシブ: デスクトップ + モバイル（375px）
- エラー状態: 404、ネットワークエラー、バリデーションエラー
- 全テストでスクリーンショット + コンソールエラー収集
PRマージゲート
PRは以下を全て満たすこと:
- 新コードに対応するユニットテストがある
- API変更に更新された統合テストがある
- UI変更に更新されたE2Eテストがある
- CIで全テストがパス
エラー処理
- 例外をサイレントにキャッチしない — ログまたはユーザーに通知
- ユーザー向けエラーは具体的でアクション可能（「エラーが発生しました」禁止）
- APIエラー: 統一フォーマット（ステータスコード + エラーコード + メッセージ）
- リソースクリーンアップ: DB接続、ファイルハンドル、WebSocket
- ネットワークエラー: リトライ + フォールバックを検討
- フロントエンド: クラッシュ防止のためError Boundary
- バックエンド: 未処理エラー用のグローバル例外ハンドラー
API設計
- フロントエンド↔バックエンドの型定義は常に同期
- API変更は両側を同時に更新
- WebSocketメッセージ型は両端で一致
- RESTful: 適切なHTTPメソッド + ステータスコード
- リクエスト/レスポンスの両端でバリデーション
- 破壊的変更にはバージョニングが必要
ドキュメント
- パブリックAPIはドキュメント化必須
- コメントは「なぜ」を説明、コードは「何を」を説明
- README、API仕様、アーキテクチャドキュメントは実装と同期
- 複雑なビジネスロジックにはインラインコメント
- 全設定値と環境変数を
.env.exampleに記載
パフォーマンス
- N+1クエリ禁止 — 必要なデータを1クエリで取得
- ループ内のAPI呼び出しやDBクエリ禁止
- フロントエンド: 不要な再レンダリング防止（memo, useMemo, useCallback）
- 画像/アセット: 適切なサイズとフォーマット
- バンドルサイズ意識 — 不要な依存関係禁止
監査ログ
全設計決定を aidlc-docs/audit.md に記録:
- 追記のみ、上書き禁止
- ISO 8601タイムスタンプ
- ユーザーの承認、却下、issue作成イベントを記録
ドキュメント構成
aidlc-docs/
├── aidlc-state.md
├── audit.md
└── inception/
├── requirements/
├── user-stories/
└── architecture/
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 9d ago First seen · 106 lines · 113 tokens per session scan A 705c4affad1c
quality-guidelines is a skill published in the GitHub repository yoshimi-I/ai-engineer-teams (2 stars, last pushed 2mo ago), licensed MIT. It adds 113 tokens to every session and 1,225 once invoked, about $0.0006 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
Other skills, from other repositories
backend-development
Backend API design, database architecture, microservices patterns, and test-driven development. Use for designing APIs, database schemas, or backend system architecture.
server-side-calls
Call tRPC procedures directly from server code using t.createCallerFactory() and router.createCaller(context) for integration testing, internal server logic, and custom API endpoints. Catch TRPCError and extract HTTP status with getHTTPStatusCodeFromError(). Error handling via onError option.
behavior-contract
Bug condition/postcondition formalization as testable Behavior Contracts. Defines invariants that must be preserved across fixes.
nw-fp-domain-modeling
Domain modeling with algebraic data types, smart constructors, and type-level error handling.
nw-fp-hexagonal-architecture
Hexagonal architecture patterns with pure core and side-effect shell for functional codebases.
strict-tdd
Strict RED->GREEN->REFACTOR test-driven development with enforcement. Never write production code before a failing test. Atomic commits per TDD cycle.