[mnriem]

Description

Separates extension runtime events from Spec Kit command hooks in the README capability table. Adds a focused runtime-events reference that documents the canonical lifecycle events and clarifies how they differ from command hooks.

Testing

Documentation-only change. git diff --check passed.

• Tested locally with uv run specify --help
• Ran existing tests with uv sync && uv run pytest
• Tested with a sample project (if applicable)

AI Disclosure

• I did not use AI assistance for this contribution
• I did use AI assistance (fill in the disclosure below)

AI disclosure: GitHub Copilot using GPT-5.6 Sol in autonomous mode identified the terminology mismatch, updated the README table, and authored the related extension-reference documentation. The contribution is documentation-only.

[Copilot]

🟡 Changes recommended

The runtime-events reference needs accuracy corrections before publication.

3 open issues

• Use case-sensitive Edit|Write matcher for Claude Code · New
• Clarify event registration covers all installed integrations · New
• Document required scripts for runtime event execution · New

What changed in this PR

Clarifies the distinction between extension runtime events and Spec Kit command hooks.

Changes:

• Separates events and hooks in the README capability table.
• Adds a runtime-events reference with canonical event names and an example.

AI review for the requester: GitHub Copilot (model unavailable; autonomous); documentation review and suggested fixes.

File	Description
README.md	Separates event and hook capabilities and links.
docs/​reference/​extensions.md	Documents runtime events and contrasts them with hooks.

_{Review effort: Max}

[mnriem]

Addressed the runtime-events review in commit 6a4a8538:

• Kept the extension manifest example integration-agnostic by removing the Claude-specific matcher.
• Clarified that every installed event-capable integration translates canonical event declarations into its agent-native configuration.
• Documented that runtime events execute the referenced command template's scripts entry directly and require a runnable script.

git diff --check passed. No executable tests were run because the changes are documentation-only.

AI disclosure: Posted for mnriem by GitHub Copilot using GPT-5.6 Sol in autonomous mode; documentation edits and review-round summary.

[Copilot]

🟢 Approval recommended

The documentation matches the extension design, addresses prior feedback, and has no unresolved issues.

No open issues 🎉

3 resolved since last review

• Document required scripts for runtime event execution
• Clarify event registration covers all installed integrations
• Use case-sensitive Edit|Write matcher for Claude Code

_{Review effort: Max}