Communityライティング&編集github.com

peterruiter/claude-build-framework

フレームワークのテンプレートから、1つの作業(機能追加、修正、調整、翻訳、アクセシビリティ、セキュリティ)に対する完全なエージェント指示書を作成します。

claude-build-framework とは?

このスキルは、Claude Code用のエージェント指示書(ブリーフ)を、事前定義されたテンプレートとフレームワークに基づいて自動生成します。ユーザーが「指示書を書いて」「エージェントに指示して」「これを委任して」などと発言した場合や、plan-waveスキルから要求された場合に使用します。 指示書には、コンテキスト、スコープ、予約済みマイグレーションスロット、スクラッチデータベース、ポート、ファイル所有権、すべての設定言語(複数形ルールを含む)、WCAG 2.2 AA、ライト/ダークモード、プライバシー、データレジデンシー、What's new、AI帰属表示禁止などの常設ルール、ゲート条件、レポート形式が含まれます。 このスキルは、開発者がAIエージェントに作業を委任する際の曖昧さを排除し、一貫性のある品質保証を実現します。特に複数言語対応やアクセシビリティ要件が厳しいプロジェクトで効果を発揮します。

対応✓Claude Code~Codex CLI~Cursor
npx skills add https://github.com/peterruiter/claude-build-framework/tree/HEAD/skills/agent-brief

Installed? Explore more ライティング&編集 skills: steipete/notion, langchain-ai/langchain, bytedance/podcast-generation · View all 6 →

お気に入りのAIに質問する

このエージェントスキルを事前に読み込んだ状態で新しいチャットを開きます。

ドキュメント

エージェント指示書を作成する

テンプレート: ${CLAUDE_PLUGIN_ROOT}/templates/agent-brief.md。背景: ${CLAUDE_PLUGIN_ROOT}/docs/waves-and-agents.md。

手順

  1. 事実を収集する(推測しない):
    • リポジトリパス、ブランチ、スタック概要(CLAUDE.md)、ゲートコマンド(CLAUDE.mdまたはプロファイル);
    • 言語: build/contracts/locales.json を読み、数、ソース言語、最も長い言語(通常はドイツ語またはフィンランド語)、および複数形が多い言語(Intl.PluralRules が few/many を必要とするもの)(設定されていればスクリーンショット用);
    • データレジデンシー(CLAUDE.md);
    • 文字列フォルダ、用語集、変更ログ(最大ID: 「あなたが書いた時点で次に空いている番号」と記載);
    • 予約済みマイグレーションスロット、スクラッチDB、ポート、スクラッチフォルダ(ウェーブプランから、または空いているものを選んで記録);
    • 最初に調査すべきファイルと、エージェントが所有するファイル。
  2. ユーザー観点でのゴールを書き、次に具体的なスコープの箇条書きとスコープ外の内容を書く。
  3. テンプレートのすべてのプレースホルダを埋める。本当に該当しないセクション(例:バックエンドのみのアイテムのスクリーンショット)は削除し、その理由を1行で説明する。
  4. テンプレートから常設ルールをそのまま維持する: すべての設定言語(複数形を含む)、WCAG 2.2 AA、ライト/ダーク、プライバシーバイデザイン、データレジデンシー、What's newエントリ1つ、STATE.mdセクション、小さく的を絞った編集、commit/push/deploy/cloud禁止、シークレット禁止、エージェントが書くものへのAI帰属表示禁止。
  5. 数字によるチェックと最後にレポート形式。
  6. アイテムがセキュリティに敏感な領域(サインイン、トークン、リンク、webhook、エクスポート、テナント境界)に触れる場合は、${CLAUDE_PLUGIN_ROOT}/docs/security-review.md の関連行をテスト付きの明示的な受け入れ基準として追加する。
  7. 指示書を1つのブロックとして出力し、エージェントのプロンプトとして渡せる状態にする。

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

peterruiter/claude-build-framework

Full accessibility pass to WCAG 2.2 AA - axe-core through Playwright over every main page in light and dark at 1440/390 (and 320 for reflow), probes for skip link, one h1, lang, visible and unobscured focus, 24px targets and sideways scrolling, a keyboard script for dialogs/drawers/tabs, manual checks (text spacing, zoom, dragging alternatives, accessible authentication), contract tests for shared components and theme contrast, fixes, known limitations with reasons and an accessibility statement page. Use when the user asks for an "accessibility pass", "WCAG", "a11y audit", "screen reader", or before the first public release.

peterruiter/claude-build-framework

Check that every tool a profile needs is installed and recent enough (git, GitHub CLI, Node.js, npm, plus the profile's own - e.g. .NET SDK, PowerShell 7, Azure CLI, Power Platform CLI, LocalDB, k6) and give the exact install command per OS for anything missing. Runs automatically at the start of new-project and quality-gate. Use when the user says "check my tools", "what do I need to install", "is my machine ready", or when a command fails with "not recognized" / "command not found".

peterruiter/claude-build-framework

Build a sync from a SaaS product to customers' Dynamics 365 / Dataverse environments and Customer Insights - Journeys (multi-tenant app with admin consent and an application user, Web API upserts, contact matching, leads, timeline notes, custom triggers, marketing lists, deep links), tested against a stand-in and a marked sandbox. Use when the owner asks for a Dynamics 365, Dataverse, Power Platform or Customer Insights - Journeys integration.

peterruiter/claude-build-framework

Apply, switch or regenerate a project's design system (the one source of colours, fonts, logos, chart, email, document and video styles for every output), check its contrast in light and dark, and add a new design system to the framework from a Claude Design System artifact. Uses scripts/design-system.mjs to generate tokens.css, tokens.ts, a Fluent UI theme, a model-driven app theme, email and chart palettes, the video-tour brand block and an Office theme mapping. Use when the user says "design system", "apply the brand", "use our house style", "switch theme", "rebrand", "regenerate the tokens", "check contrast", or "add a design system".

関連スキル