idk-lamp Start • Demo → Install → Gate

5分で分かる:idk-lamp の使い方

idk-lamp は、AI が「判断を出さない」べき地点で点く、静かな合図です。
エラーでも、失敗でもありません。判断を人間に返すための“境界信号”です。

Step 1
触って理解する

テーマ一覧から点灯・状態・雰囲気を確認します。

Step 2
貼って使う

CDN を貼り、タグを置くだけで導入できます。

Step 3
点けどころを決める

「いつAIに決めさせないか」を Gate で定義します。

融合の考え方:UI(idk-lamp)運用ゲート(predictability-gate) は役割が違います。
だからこそ、サイトで 導線だけを一本化 します。

このページの役割

ここは “説明” ではなく、導入の順番 を揃えるページです。

あなたが得るもの

• デモで「どんな合図か」が一瞬で分かる
• CDNで「すぐ置ける」
• Gateで「点けどころがぶれない」

このページに置かないもの

• 詳細な思想(→ Concept)
• 全テーマの解説(→ Demo)
• 全仕様と実装(→ Repos)

Install:貼って使う(CDN)

“まず置いてみる” ための最小導入です。サイトやPoCにそのまま使えます。

1) CDN を読み込む

<script src="https://idk-lamp.org/dist/idk-lamp.min.js"></script>

2) タグを置く

<idk-lamp state="idk" label="Need human decision"></idk-lamp>

3) 見た目を CSS 変数で調整する(例)

:root { --idk-lamp-size: 84px; --idk-lamp-glow: 1; --idk-lamp-label-opacity: 0.9; }

※ state / theme / 変数名は、最新の仕様を idk-lamp リポジトリ で確認してください。

Demo:触って理解する

まずは “どれが自分のプロダクトに馴染むか” を選びます。テーマ一覧で点灯の雰囲気を比較してください。

Gate:点けどころを決める

idk-lamp は “合図” です。
合図が生きるためには、いつ点けるか(=AIに決めさせない条件) が先に必要です。

predictability-gate が扱うこと

• 予測/推論/生成の “不確かさ” を、運用上の判断に落とす
• 判断保留にする条件(誰が・いつ・何を確認するか)を定義する
• “止める” がエラーではなく、正常動作であることを揃える

推奨:Gate 側で “STOP/DEFER” を返したときに、UI 側で state="idk" を点灯する。
これで「止める → 人に返す」が一貫した体験になります。

FAQ

これは「警告灯」ですか?

いいえ。idk-lamp は “危険” を示すためではなく、判断を返すための合図です。
アラートの代替ではなく、「責任の境界」を UI 上で可視化します。

なぜ Demo / Repo / Gate を分けたままにするのですか?

役割が違うからです。
Demo は体験、idk-lamp repo は配布物、predictability-gate repo は運用判断。
分けたまま、サイトで導線だけ一本化するのが最も壊れません。

最初に何を見ればいいですか?

迷ったら Demo → このページの Install → Gate の順です。
“置ける” を先に作ると、Gate の議論が現実に降ります。