docs(framework): write the hook contract in docs/ARCHITECTURE.md
メンテナーはふだん 1 日以内に返信
まだ誰も着手していません。
評価
- 難易度
- 2/5
- 見積もり時間
- 1〜3時間
- 初心者へのやさしさ
- 78/100
- issue の種類
- ドキュメント
- 明瞭さ
- 明確に書かれている
- 活発さ
- 活発
- 技術スタック
- typescript
調査の方向性
docs/ARCHITECTURE.md のルール 5 と 7 を読み、次に 08-hook-generate の参照箇所と PR #1158 にある以前の hook 契約を探してください。要求された契約セクションを追加し、それに合わせてこれらのルールを調整してください。ツールごとの互換性テーブルは対象外です。3 つの受け入れ条件がすべて満たされたら完了です。
索引モデルが issue の本文から書いたものです。
説明
Problem
Hooks the framework ships must behave the same on every supported tool. The contract lives in PR #1158 and in session notes, not in one place a hook author or the hook generator can follow. Two hooks written without it already disagree (#1190).
Scope
Add a short section to docs/ARCHITECTURE.md:
- A hook is a script: deterministic, no model, no network, 5 s timeout, one purpose.
- Two reactions: inform (
additionalContext) or require (decision: "block"with areason). Say nothing when there is nothing to report. - Shared moments:
SessionStart,PostToolUse,Stop. Optional where the tool has them:PreToolUse,UserPromptSubmit,SubagentStop. - Rules: judge only what changed this turn (sha1 baseline of the relevant files, not a tool-name filter); report only new findings; require nothing that cannot be done yet; require at most once per turn, tracked in the script; neutral message that says what to do; git read-only; no state outside the script's own baseline file.
- Scope statement: hooks a user generates for one tool with
08-hook-generateare not bound by this contract.
Per-tool facts go to COMPATIBILITY.md (#978), not here.
Acceptance criteria
- The section exists in
docs/ARCHITECTURE.md. -
08-hook-generatereferences it. - Rules 5 and 7 of
ARCHITECTURE.mdare consistent with it.
Prior art in this repo
- #1158 (one hook contract), #1146 (git allowed read-only), #1190 (plan check false positives), #978 (verified compatibility).
Out of scope
The per-tool table (#978). Bridge fixes (#1191, #1193, #1194).
- 主要言語
- TypeScript
- スター
- 481
- フォーク
- 45
- 平均マージ
- 1日 13時間
- マージ済み PR(30日)
- 91
環境構築
はじめの一歩
- issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
- 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
- リポジトリをフォークし、ブランチを切って変更します。
- issue 番号を参照したプルリクエストを送ります。
ai-driven-dev/framework のほかの issue
-
難易度 2/5 1〜3時間 初心者へのやさしさ 86/100
ai-driven-dev/framework#1311 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 79/100
ai-driven-dev/framework#1244 ·
メンテナーはふだん 1 日以内に返信
-
refactor(aidd-context): apply the new skill template to learn対応中かも @blafourcade が 2 日前に担当しました。 オープン
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
ai-driven-dev/framework#1186 · 担当者 1 名 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 83/100
ai-driven-dev/framework#1163 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
ai-driven-dev/framework#1162 ·
メンテナーはふだん 1 日以内に返信
ai-driven-dev/framework の issue をすべて見る
似ている issue
-
bug impact:low Team: SecuritySolution Team:Defend Workflows v9.6.0
難易度 2/5 1〜3時間 初心者へのやさしさ 72/100
elastic/kibana#306401 · コメント 3 件 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 68/100
agentes-chat/agentes-chat#927 ·
メンテナーはふだん 1 日以内に返信
-
comp/desktop P2 type/bug
難易度 2/5 1〜3時間 初心者へのやさしさ 78/100
NousResearch/hermes-agent#157702 ·
メンテナーはふだん 1 日以内に返信
-
難易度 2/5 1〜3時間 初心者へのやさしさ 76/100
メンテナーはふだん 1 日以内に返信
-
e2e-failure ready-to-code
難易度 1/5 1時間未満 初心者へのやさしさ 72/100
redhat-developer/rhdh-plugin-export-overlays#4794 · コメント 1 件 ·
メンテナーはふだん 1 日以内に返信