
geekfujiwara/codeappsdevelopmentstandard
Developer toolsPower Platform & Azure で業務システムを開発する際に利用できるAIファースト開発標準。クイックスタートを見て利用してください。
概要
Power Apps Code Apps, モデル駆動型アプリ, Generative page, Dataverse, Power Automate, Power Pages, Copilot Studio, Azure サービス、Cowork プラグインを で開発するための、実践的な AI ファースト開発標準リポジトリです。 実装標準は (Code Apps)を前提にしています。 VS Code + GitHub Copilot が使える状態(統合プロンプトで一気に準備するを参照)であれば、次のコマンドと 1 依頼だけで開発を始められます。 続けて GitHub Copilot / Claude Code のチャットから を呼び出し、作りたいテーマを伝えてください。architecture スキルがヒアリングを経て Code Apps を選定した場合にのみ、code-apps スキルが .github/skills/code-apps/references/template-snapshot/ の package.json / package-lock.json をコピーして npm install を実行します(Code Apps 以外のソリューションでは node_modules は生成されません)。 .gitignore がないと node_modules/・dist/・.power/・.env 等がコミット対象になります。必ずコピーしてください。 チーム開発でリモートリポジトリを最初から使いたい場合は チーム開発向けの手順 を、既存仕様書がある場合は /spec-build の運用へ進んでください。 GitHub Copilot だけでなく からも同じ開発標準をそのまま利用できます。手順は次の 3 ステップです。 プロジェクトのルートで以下を実行し、.github/(エージェント・スキル)と .gitignore を配置します。 .github/agents/ と .github/skills/ を配置したフォルダーで Claude Code を起動します。Claude Code はカスタムエージェント定義(.claude/agents/)とスキル群(.github/skills/)を参照して開発タスクを進めます。
README
AI-First Development Standard
This repository provides skills, agents, and references for building business systems on Power Platform and Azure with VS Code + GitHub Copilot / Claude Code. It supports Power Apps Code Apps, Dataverse, Power Automate, Power Pages, Copilot Studio, Cowork, and more. The Code Apps implementation standard is TypeScript + React + Tailwind CSS.
Watch the introduction video on YouTube
Get started by role
| For | Start with | Topics |
|---|---|---|
| Business app developers | Developer guide | Tool setup, authentication, environment checks, and working with agents |
| Tenant and environment administrators | Administrator guide | Licensing, dedicated environments, developer roles, Credits, DLP / ACP |
| Owners of company development standards | Company standard adoption and operations guide | Creating internal/private repositories, initial setup, company policies, update notifications, issue handling, and team rollout |
| Claude Code users | Claude Code quickstart | Getting and referencing the standard files and starting development |
Quickstart
Open the local folder where you want to build your app in VS Code. In GitHub Copilot Chat’s Agent mode, copy and submit the following prompt. You can start with just the repository URL and “Quickstart.” If you have specifications or other materials, leave them in that folder.
https://github.com/geekfujiwara/CodeAppsDevelopmentStandard Quickstart
Following the quickstart procedure, Copilot does not stop after placing .github/agents, .github/skills, and the template .gitignore; it proceeds through the following steps.
| Step | What it does |
|---|---|
| 0 | Places or updates the development standard, prepares the shared auth_helper.py, .env, and interactive sign-in authentication cache, and verifies cache reuse. After authentication, it pauses to ask about your needs and scope with AskUserQuestion and waits for your response. If materials are present, it offers choices such as continuing through development, deployment, and testing based on those materials; otherwise it presents several concrete app ideas based on the folder name. |
| 1 | After you choose to continue, safely moves and organizes business materials from the root into spec/input/, then uses spec-builder to create specifications. architecture proposes business improvements, recommended AI features, and a suitable existing template, and outputs business workflow and architecture diagrams in Mermaid both in chat and in Markdown. Diagrams are not placed inside question pop-ups. |
| 2 | Uses the authentication cache to inspect Power Platform environments and Dataverse tables, publishers, and solutions. When needed, it also inspects Azure subscriptions, resource groups, AI models, and regions, then finalizes the configuration with rationale. |
| 3 | Implements the full configuration based on the materials and template, runs quality tests and pre-deployment checks, deploys to the development environment, and verifies actual operation. It shares the actual architecture diagram, URLs, and test results, and updates documentation and implementation status. It reports “all complete” only when every required item has been verified. |
The one-time requirements check after authentication is retained. After you respond, Copilot investigates what it can determine on its own and does not keep asking about known details or routine implementation decisions. If there are no materials, it develops the selected idea with its assumptions stated. Requests limited to proposals or preparation are respected.
Environment scanning gathers information such as connection targets. It does not normally perform advance checks for DLP, ACP, or Code Apps permissions. Existing files and company standards are protected. Copilot waits for your response only when your judgment is needed for authentication, environment selection, or similar actions, then continues. Observed facts are distinguished from proposed assumptions. The development scope approved during the requirements check is carried forward, while out-of-scope decisions such as production, external publication, destructive changes, real-data migration, additional costs, or permission grants require separate confirmation.
For a more detailed prompt, copy the following (after setup, you can also run it from Copilot using /Quickstart).
https://github.com/geekfujiwara/CodeAppsDevelopmentStandard Quickstart.
Do not stop after placing .github/agents, .github/skills, and the template .gitignore.
Scan candidate environments, prepare auth_helper.py and .env, and set up an authentication cache using interactive sign-in.
Pause here, ask about my needs with AskUserQuestion, and wait for my response.
If materials are present, offer choices to continue based on those materials, change the scope, or stop after preparation.
If there are no materials, first suggest multiple app ideas based on the folder name and let me choose.
For the continue option, state that it covers development, deployment, and testing in the development environment based on the materials and template.
After I choose to continue, safely move and organize business materials from the root into spec/input/ and run spec-builder.
If there are no materials, flesh out the selected idea. Then investigate what you can determine on your own and do not ask me again about known details.
Do not ask me to define business requirements from scratch. As a professional consultant, use industry knowledge and best practices to fill gaps,
and propose business improvements, recommended AI features, architecture, and a suitable existing template in this repository.
Output Mermaid diagrams for the business workflow and architecture both in chat and Markdown.
Do not put diagrams inside question pop-ups. Present recommended proposals in chat and distinguish facts from assumptions.
Use the authentication cache to inspect existing Power Platform environments and inspect Azure only when needed, then finalize the configuration.
Within the approved development scope, implement the full configuration, run quality tests, deploy, and verify actual operation.
Finally, share the actual architecture diagram, URLs, and verification results, and update the documentation.
Ask additional questions only for unresolved matters that require my judgment or actions outside the approved scope.
When proceeding with implementation, select GeekPowerCode in Copilot. If your company has its own standard, use its approved version and company-specific agent. For local tool details, see the developer guide.
- After design and approval, proceed directly to implementation and prioritize the initial Code Apps deployment. Check environments or DLP only when explicitly requested or when troubleshooting an issue.
- Unless direct connection or continued use is explicitly requested, treat SharePoint URLs as migration sources, move the data to Dataverse, and build Code Apps.
- The relevant skill installs dependencies only when Code Apps is selected.
- Check
.gitignoreto ensure.env, credentials, and generated files are not committed. - To start from existing specifications, use spec-builder.
- To produce a verified screen-first demo from actual recordings or the shared VS Code browser, use video-creator. It includes three common-scaffold templates; silent, subtitle-free output is the default.
- For Claude Code setup, see the dedicated guide.
For developers
Developer guide covers local tool setup, Python packages, first sign-in, environment checks when explicitly requested, and troubleshooting. Routine development does not include advance diagnostics through administration APIs.
For one-step setup, select Setup Development Environment from the / menu in Copilot Chat. If an operation requires administrator permissions that are not available, it stops and reports what to ask an administrator to do.
For tenant and environment administrators
Administrator guide covers licensing, dedicated environments, security roles, Copilot Credits, ACP, enabling Code Apps, and the required administrator roles.
Do not develop in the Default environment. Limit configuration to the target environment and apply only the minimum required permissions and policies. Review impact and dry-run results, and obtain explicit approval before changing settings.
For company standard owners
Company standard adoption and operations guide covers creating a repository in an Organization through the REST API and the work to do after copying the standard.
- Use Create Company Standard Repository to confirm the Organization and visibility, then create an independent repository.
- Set up Actions to notify your team of upstream updates through issues, along with an issue-response workflow for internal users.
- Rename GeekPowerCode to your company name and incorporate internal policies.
- Roll out the approved standard to your team, and bring in upstream changes through PRs while protecting company changes.
The guide includes prompts and recommended supporting materials for each task. Public repository forks cannot be made private, so create an independent copy for an internal/private standard.
Find skills and related resources
- Skills catalog and sample implementations
- Repository structure and placement policy
- Key documents
- Using Claude Code
License
MIT License. See LICENSE for details.
Feedback
日本語
AI ファースト開発標準
Power Platform / Azure の業務システムを VS Code + GitHub Copilot / Claude Code で開発するための、スキル・エージェント・リファレンスを提供するリポジトリです。Power Apps Code Apps、Dataverse、Power Automate、Power Pages、Copilot Studio、Cowork等に対応します。Code Appsの実装標準は TypeScript + React + Tailwind CSS です。
対象者別の入口
| 対象者 | 最初に読むガイド | 主な内容 |
|---|---|---|
| 業務アプリを開発する人 | 開発者向けガイド | ツール導入、認証、環境チェック、エージェントへの依頼 |
| テナント・環境を準備する人 | 管理者向けガイド | ライセンス、専用環境、開発者ロール、Credits、DLP / ACP |
| 自社標準を導入・管理する人 | 自社標準の導入・運用ガイド | internal/private作成、初期設定、社内規程、更新通知、Issue対応、チーム展開 |
| Claude Codeを使う人 | Claude Codeクイックスタート | 標準ファイルの取得・参照と開発の開始 |
クイックスタート
アプリを作りたいローカルのフォルダーを VS Code で開き、GitHub Copilot Chat の Agent モードに、次をそのままコピーして依頼してください。 リポジトリのURLと「クイックスタートして」だけで開始できます。仕様書などの資料があれば、そのフォルダーに置いたままで構いません。
https://github.com/geekfujiwara/CodeAppsDevelopmentStandard クイックスタートして
Copilotはクイックスタート実行手順に沿って、
.github/agents・.github/skills・テンプレートの.gitignoreを配置するだけでは止まらず、次まで一気通貫で進めます。
| Step | 実行する内容 |
|---|---|
| 0 | GitHubの標準を配置・更新し、共通auth_helper.py・.env・インタラクティブサインインの認証キャッシュと再利用検証を準備。認証後はAskUserQuestionで要望と実施範囲を確認して一旦停止し、回答を待ちます。 資料があればその資料に基づく開発デプロイ・テストまでの継続等を、なければフォルダー名から複数の具体的なアプリ案を選べる形にします。 |
| 1 | 継続回答後、ルートの業務資料をspec/input/へ安全に移動・整理し、spec-builderで仕様を作成。architectureで業務改善・推奨AI機能・適切な既存テンプレートを提案し、業務フロー図とアーキテクチャ図をMermaidでチャットとMarkdownの両方に出力します。図は質問ポップアップ内には入れません。 |
| 2 | 認証キャッシュでPower Platform環境、Dataverseテーブル、パブリッシャー・ソリューション、必要時だけAzureサブスクリプション・リソースグループ・AIモデル・リージョンを調査し、理由付きで構成を確定します。 |
| 3 | 資料・テンプレートに基づくフル構成を実装・品質テスト・プレデプロイ・開発デプロイ・実動作検証。実際の構成図と各URL・テスト結果を共有し、ドキュメント・実装ステータスを更新します。全必須項目が検証済みの場合だけ「全て完了」と報告します。 |
認証後の一度の要望確認は維持し、その回答後は自分で分かることを調べ、既知事項や通常の実装判断では質問を繰り返しません。 資料なしなら選ばれた案を仮説付きで具体化します。提案だけ・準備までという指定は尊重します。
環境スキャンは接続先などを埋めるための情報取得です。通常はDLP・ACP・Code Apps許可の事前診断をしません。 既存ファイル・社内標準は保護し、認証操作や環境選択など本人の判断が必要なときだけ回答を待ち、回答後は続行します。 取得できた事実と提案上の仮説は区別します。要望確認で承認された開発範囲は引き継ぎますが、 本番・外部公開・破壊的変更・実データ移行・追加費用・権限付与など、範囲外の判断は別途確認します。
詳細な指示も含めたい場合は、次をコピーできます(配置後はCopilotの /Quickstart からも実行可能です)。
https://github.com/geekfujiwara/CodeAppsDevelopmentStandard クイックスタートして。
.github/agents・.github/skills・テンプレートの.gitignoreを配置しただけで止めず、
環境候補のスキャン、auth_helper.py・.envとインタラクティブサインインの認証キャッシュを準備して。
ここで一旦停止し、AskUserQuestionで要望を確認して回答を待って。
資料があれば対象資料からの継続・対象変更・準備までを選べる形にし、
なければフォルダー名から複数のアプリ案を先に提案して選択肢を与えて。
継続の選択肢には、資料・テンプレートに基づく開発環境へのデプロイ・テストまでの範囲を明記して。
継続回答後、ルートの業務資料をspec/inputへ安全に移動・整理してspec-builderを実行し、
なければ選ばれた案を具体化して。その後は自分で分かることを調べ、既知事項を質問し直さないで。
業務要件を一から質問せず、プロのコンサルタントとして業界知識とベストプラクティスから補完し、
業務改善・推奨AI機能・architecture・既存リポ内の適切なテンプレートを提案して。
業務フローとアーキテクチャのMermaid図をチャットとMarkdownの両方に出し、
図は質問ポップアップ内に入れず、事実・仮説を区別した推奨案をチャットに提示して。
認証キャッシュで既存のPower Platform環境と必要時だけAzureを調べて構成を確定し、
承認済みの開発範囲でフル構成を品質テスト・デプロイ・実動作検証まで進めて。
最後に実際の構成図・各URL・検証結果を共有し、ドキュメントを更新して。
本人の判断が不可欠な未解決事項・承認範囲外の操作だけ追加確認して。
実装へ進む際はCopilotで GeekPowerCode を選択します。自社標準がある場合は、その承認済み版と自社名のエージェントを使ってください。ローカルツールの詳細は開発者向けガイドを参照してください。
- 設計・承認後はすぐに実装し、Code Appsの初回デプロイを優先します。環境・DLPチェックは明示依頼時または障害時だけ行います。
- SharePoint URLは、直接接続・継続利用の明示がなければ移行元として扱い、Dataverseに移行してCode Appsを開発します。
- Code Appsが選定された場合だけ、そのスキルが依存関係を配置・インストールします。
.env・認証情報・生成物をコミットしないよう、.gitignoreを確認してください。- 既存の仕様書から始める場合は spec-builder を利用します。
- 実録画・VS Code統合ブラウザーから検証済みの画面中心デモ動画を制作する場合は video-creator を利用します。共通Scaffolder用3雛形を同梱し、既定は無音・字幕なしです。
- Claude Codeの開始手順は 専用ガイド を参照してください。
開発者向け
開発者向けガイドに、ローカルツールの準備、Pythonパッケージ、初回サインイン、明示依頼時の環境チェックと障害時の復旧をまとめています。通常開発では管理APIによる事前診断を挟みません。
一括準備は Setup Development Environment をCopilot Chatの / から選択できます。管理者権限が不足する工程では停止し、管理者へ依頼する内容を報告します。
テナント・環境管理者向け
管理者向けガイドに、ライセンス、専用環境、セキュリティロール、Copilot Credits、ACP、Code Apps有効化と必要な管理者ロールをまとめています。
Default環境では開発せず、対象環境を限定して必要最小限の権限・ポリシーを設定します。設定変更は影響とdry-runを確認し、明示承認後に行ってください。
自社標準の管理者向け
自社標準の導入・運用ガイドに、OrganizationへのREST API作成と、コピー後の作業をまとめています。
- Create Company Standard Repository でOrganizationと可視性を確認し、独立したリポジトリを作成する。
- 上流更新をIssueで通知するActionsと、社内向けのIssue回答フローを整備する。
- GeekPowerCodeを自社名に変更し、社内ルールを反映する。
- 承認済み標準をチームへ展開し、上流変更は自社変更を保護してPRで取り込む。
各作業の依頼プロンプトと推奨添付資料はガイド内にあります。公開リポジトリのforkは非公開化できないため、internal/privateの標準は独立コピーで作成します。
スキル・関連資料を探す
ライセンス
MIT License。詳細は LICENSE を参照してください。
フィードバック
推奨ツール
別のキーワードを試すか、フィルタを外してください。
インストール
npx skillfish add geekfujiwara/codeappsdevelopmentstandard