少人数の開発チームで、AIに「READMEの手順を直して、PRの下書きを作って」と頼む場面を考えます。READMEは編集してよく、リリース設定の変更はチームで判断します。チャットにそう書いた後、もう一歩だけ進めます。READMEだけを更新できる経路を作り、リリース設定への操作が拒否されたら、実際に設定が変わっていないことまで確かめます。
1件だけ選び、許可する操作を決める
練習用の作業場に README.md と release.yml を用意します。これは架空の作業例です。実案件で試す場合も、最初は本番の資格情報を持たない隔離環境を使います。依頼の中には、作業ID、編集を許可するファイル、確認済みの基準版、下書きとして止める条件を入れます。チームがPR作成まで任せたい場合は、許可する操作にそれを明記し、マージやデプロイの権限を分けます。
- 対象： 練習用リポジトリの README.md
- 許可操作： 承認済み版のREADMEを編集し、差分を示す
- 実行境界： 実行時に対象と許可範囲を照合する
- 成功： READMEの予定した変更があり、リリース設定は基準版と同じ
- 結果不明： 書き込みを再送する前に、作業IDと保存先の状態を読む
差分から確認する人には、可能なら実行者と別の読み取り権限を持たせます。AIが作った説明文と、読み取り側が取得したファイルやPRの実体を分けて残すためです。
正常と拒否を試す
最初の操作は、READMEの見出しを一つ直すことです。実行の応答を記録したら、別の読み取り経路から変更ファイルを列挙し、READMEの内容とリリース設定の基準版を照合します。Gitで確認するなら、書き込みを許可する前に対象ファイルのハッシュを残し、確認側で変更ファイルの一覧と保護対象の実バイトを確認できます。コミット済みの差分だけを読む場合は、作業ツリーに残る変更や新規ファイルを確認対象に加えます。
次は、操作案の書き込み先だけを release.yml に変えます。許可外の入力を明示的に作るのは、モデルの出力を繰り返して偶然を待つ手間を省くためです。操作を受け付ける仕組みが拒否し、確認側の観測でも保護対象の内容が同じであれば、この経路の拒否を確認できます。拒否の表示が出ても差分があれば、操作の前後関係を調べます。先に書き込んでからエラーを返す処理もあるためです。
最後は書き込み後に応答だけが失われる場面です。「失敗」として同じ依頼をやり直す前に、元の作業IDで対象を調べます。既存のPR下書きが見つかればそれを使い、確認先へつながらなければ該当操作を保留します。レビューコメントを書くなど、独立した作業は続けられます。
模擬試験の確認結果
ARCの隔離したSQLite模擬試験で、draft をREADME、protected をリリース設定に見立てて結果を読みます。許可した更新では下書きに1件、保護対象への差し替えと古い承認版では変更0件でした。応答を失っても別接続から1件を確認でき、照会不能を模擬した場合は処理を保留しました。練習用の比較対照で書き込み直前の照合を外すと、同じ下書き用の宣言でも保護対象が変更されました。SQLiteでの試験結果です。Gitや公開サービスで使う場合は、そのサービスの権限と確認先で同じ観点を試します。
最初の一件では、許可対象、拒否を観測した場所、実際の差分、結果不明時の次の行動を作業記録に残せば、次の人が同じ条件で試せます。使う環境を変えたら、書き込みが実際に起こる入口と、結果を読む経路をもう一度確認します。
再現用コードと期待結果はARCのSQLite模擬試験で確認できます。この試験は架空データの単一プロセス内で実行しており、Gitや公開サービスの操作結果、権限分離、クラッシュ復旧の確認を含みません。
関連記事
AIの支払案を資金が動く前に検査する｜ARCのオンチェーン金融デモを架空データで実行した記録
Agent Role Contractsのfinance・Safeデモと追加の宣言検査を、架空データで実行した記録を読みます。想定した拒否、元に戻すとPASSに戻る動き、手元で再現する手順、検査していないことまで分けて示します。
「試したこと」をコードで外へ返す。Agent Role ContractsをOSSとして公開しました
Agent Role Contracts 0.5.0をnpm latestの安定版として公開しました。役割・権限・レビュー分離・作業範囲・引き継ぎの宣言を、実行前にどう検査するかを最小の例で紹介します。
AIエージェントのLTで「動いた」をどう証明するか｜公開デモのPASS→FAIL→PASSを1枚にする
AIエージェント実践LT会の開催記録を起点に、Agent Role Contractsの公開デモの入力・期待結果・過去CIを使い、再現可能な発表の証拠の残し方を整理。
🏷️このカテゴリ：コミュニティ運営
カテゴリ一覧もくもく会・勉強会・交流会の運営ノウハウとケース。
英語ページがあっても言語対応は片方向だった｜日本語3ページを直し、日英6ページで確かめた記録
「みやこでIT」のサイトで、日本語3ページが対になる英語ページへのhreflangを出していませんでした。原因、共通関数への置き換え、実ページを読む回帰テスト、本番6URLの確認と、まだ測っていない効果を記録します。
AIの支払案を資金が動く前に検査する｜ARCのオンチェーン金融デモを架空データで実行した記録
Agent Role Contractsのfinance・Safeデモと追加の宣言検査を、架空データで実行した記録を読みます。想定した拒否、元に戻すとPASSに戻る動き、手元で再現する手順、検査していないことまで分けて示します。
AIにWebサイト改善を任せてわかった、テストが通っても残る問題
みやこでITのサイト改善で見つかった、料金条件の取りこぼし、HTML読み取り、日本語の改行。修正と反例テスト、本番確認までの実例を紹介します。
大阪から京都のもくもく会へ。一人で参加する休日の組み立て方
大阪から京都のもくもく会へ一人で参加する準備を、実際の開催案内を例に整理。会場までの経路、参加枠ごとの料金、作業の準備、帰宅までを考えます。
京都で、誰かと、何かをつくる。みやこでITが育てたい「出会いのその先」
京都のITコミュニティ「みやこでIT」が大切にする、人との出会いから生まれる学び、仲間、小さな挑戦。2019年から活動を続けてきた主宰が、これから育てたいコミュニティの価値を語ります。
AIエージェントのLTで「動いた」をどう証明するか｜公開デモのPASS→FAIL→PASSを1枚にする
AIエージェント実践LT会の開催記録を起点に、Agent Role Contractsの公開デモの入力・期待結果・過去CIを使い、再現可能な発表の証拠の残し方を整理。
大光寺のもくもく会をヒントに、初対面の人へ「詰まり」を伝える4行メモ
大光寺のもくもく会#62を起点に、初対面の相手へ短時間で相談内容を伝える4行メモを提案。実際の活動記録と架空の練習例、未検証の効果を区別します。
「試したこと」をコードで外へ返す。Agent Role ContractsをOSSとして公開しました
Agent Role Contracts 0.5.0をnpm latestの安定版として公開しました。役割・権限・レビュー分離・作業範囲・引き継ぎの宣言を、実行前にどう検査するかを最小の例で紹介します。
✍️この著者：みやこでIT編集部
著者ページ京都のITコミュニティ「みやこでIT」運営チームによる共同執筆・運営記事。
英語ページがあっても言語対応は片方向だった｜日本語3ページを直し、日英6ページで確かめた記録
「みやこでIT」のサイトで、日本語3ページが対になる英語ページへのhreflangを出していませんでした。原因、共通関数への置き換え、実ページを読む回帰テスト、本番6URLの確認と、まだ測っていない効果を記録します。
AIの支払案を資金が動く前に検査する｜ARCのオンチェーン金融デモを架空データで実行した記録
Agent Role Contractsのfinance・Safeデモと追加の宣言検査を、架空データで実行した記録を読みます。想定した拒否、元に戻すとPASSに戻る動き、手元で再現する手順、検査していないことまで分けて示します。
AIにWebサイト改善を任せてわかった、テストが通っても残る問題
みやこでITのサイト改善で見つかった、料金条件の取りこぼし、HTML読み取り、日本語の改行。修正と反例テスト、本番確認までの実例を紹介します。
大阪から京都のもくもく会へ。一人で参加する休日の組み立て方
大阪から京都のもくもく会へ一人で参加する準備を、実際の開催案内を例に整理。会場までの経路、参加枠ごとの料金、作業の準備、帰宅までを考えます。
AIエージェントのLTで「動いた」をどう証明するか｜公開デモのPASS→FAIL→PASSを1枚にする
AIエージェント実践LT会の開催記録を起点に、Agent Role Contractsの公開デモの入力・期待結果・過去CIを使い、再現可能な発表の証拠の残し方を整理。
大光寺のもくもく会をヒントに、初対面の人へ「詰まり」を伝える4行メモ
大光寺のもくもく会#62を起点に、初対面の相手へ短時間で相談内容を伝える4行メモを提案。実際の活動記録と架空の練習例、未検証の効果を区別します。
元お茶屋「たか橋」でもくもく会#63｜約100年の町家でPCを開く
2026年9月20日10:30〜13:30の、みやこもくもく会#63 @たか橋。約100年前に建てられたと考えられる元お茶屋の二階建て町家で、畳の座敷にPCを広げる回です。建物の来歴と、会場となる部屋の特徴も紹介します。
クラフトビールを片手に12人で「信頼」を考える｜第一原理酒場 #1 開催レポート
2026年9月18日、京都市北区の夏屋で「第一原理酒場 #1」を開催しました。運営を含め12名が集まり、信頼と信用の定義、何のために何をどう信頼するのか、アナログなコミュニティの価値、第一原理思考について、クラフトビールと料理を囲みながら話し合いました。
コミュニティに参加する
京都でITエンジニア仲間を見つけたい方へ
「みやこでIT」では、京都のお寺・町家・大学などで、もくもく会や勉強会を毎月開催しています。
📊 Source data
本記事に登場する「7年・167回・651名」「お寺/町家会場での開催」等の数値は、 「みやこでIT」年次統計レポート(/community-stats) の一次データに基づきます。年別開催数・会場分布・イベント種別構成の集計を公開しています。
LM-4無料配布資料
京都のお寺でコードを書く — 「みやこでIT」参加ガイドブック2026
7年167回運営の実績から整理した、初参加を成功させる実践ガイド
対象：京都のITエンジニア・転職検討者・勉強会初参加の個人
この記事に関連する募集中イベント
申込受付中