Hacktoberfest 2026:メンテナが10月に向けて印を付けた、オープンで初心者向けの issue。 Hacktoberfest の issue を見る

docs(framework): hooks documentation, tool-internal vs pre-commit

オープン
#303 コメント 1 件 リアクション 0 件 担当者 0 名 GitHub で見る

まだ誰も着手していません。

評価

難易度
3/5
見積もり時間
1〜2日
初心者へのやさしさ
68/100
issue の種類
ドキュメント
明瞭さ
明確に書かれている
活発さ
静か
技術スタック
git, javascript
領域
documentation

調査の方向性

Start with the bundled-hooks section in docs/ARCHITECTURE.md, then review docs/CREATE_PLUGIN.md and docs/GLOSSARY.md alongside the documented Context, Telemetry, OpenCode, and Claude Code hook references. Update the three named documents so the authoring contract, lifecycle and host coverage, and agent-hook versus Git pre-commit boundary are explicit, and confirm every acceptance criterion is met.

索引モデルが issue の本文から書いたものです。

説明

Problem

The framework ships bundled hooks, but authors lack one documented, host-aware contract for adding a hook.

Scope

  • Extend the existing bundled-hooks section in docs/ARCHITECTURE.md with the minimal hook contract, supported lifecycle mapping, and the boundary with Git hooks.
  • Link that section from docs/CREATE_PLUGIN.md.
  • Correct docs/GLOSSARY.md: Git pre-commit is not an agent lifecycle event.

Acceptance criteria

  • An author can add a basic hook from ARCHITECTURE.md without reading an existing implementation.
  • Supported lifecycle events and per-host coverage are explicit.
  • The agent-hook versus Git-pre-commit boundary is explicit.
  • CREATE_PLUGIN.md links to the authoritative section.
  • The glossary no longer classifies pre-commit as an agent lifecycle event.

Prior art in this repo

  • ARCHITECTURE.md already inventories Context and Telemetry hooks, but does not define an authoring contract.
  • Context and Telemetry have declarative hooks; OpenCode uses a JavaScript plugin bridge.
  • Claude Code Hooks documents more events than AIDD currently normalizes.

Out of scope

  • Changing or adding a bundled hook.
  • Installing Git pre-commit hooks or adding CI enforcement.
  • Claiming lifecycle parity that a host has not demonstrated.
主要言語
TypeScript
スター
481
フォーク
45
平均マージ
19時間 38分
マージ済み PR(30日)
108

コントリビューションガイド

コントリビューションガイドを開く

はじめの一歩

  1. issue を最後まで読み、次にプロジェクトのコントリビューションガイドを読みます。
  2. 着手することを issue にコメントします — 二人が同じ作業をするのを防げます。
  3. リポジトリをフォークし、ブランチを切って変更します。
  4. issue 番号を参照したプルリクエストを送ります。

ai-driven-dev/framework のほかの issue

ai-driven-dev/framework の issue をすべて見る

似ている issue

TypeScript の issue をもっと見る

新しい issue をメールで受け取る

初心者向けの GitHub issue を短くまとめたダイジェスト。