docs: add agent hooks documentation to authoring and audit skills #148
Conversation
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Document the new agent hooks feature that allows hooks to be defined in agent YAML frontmatter for lifecycle events scoped to that agent. Changes: - Add hooks field to frontmatter-requirements.md subagent spec - Add Agent-Level Hooks section to hook-events.md reference - Add Agent Hooks section to agent-authoring skill - Add hooks examples to design-patterns.md templates - Add hooks validation to agent-audit checklist and workflow - Add Hooks Security Considerations to tool-restrictions.md - Update markdown.md rule (paths frontmatter, markdownlint command) - Various format improvements to rules and map-codebase templates Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
Contributor
There was a problem hiding this comment.
Pull request overview
This pull request documents the new agent hooks feature that enables lifecycle hooks to be defined in agent YAML frontmatter, scoped to specific agents. The PR adds comprehensive documentation across authoring guides, reference materials, and audit workflows, along with minor formatting improvements to existing templates and rules.
Changes:
- Added agent hooks specification to frontmatter requirements and reference documentation
- Integrated hooks guidance into agent authoring and audit skills with security considerations
- Added hooks examples to agent design patterns
- Minor formatting improvements across map-codebase templates, command-audit index, and rules files
Reviewed changes
Copilot reviewed 13 out of 15 changed files in this pull request and generated 1 comment.
Show a summary per file
| File | Description |
|---|---|
| references/frontmatter-requirements.md | Added hooks field specification to subagent frontmatter |
| references/hook-events.md | Added Agent-Level Hooks section documenting supported events and configuration |
| skills/agent-authoring/SKILL.md | Added Agent Hooks section explaining when and how to use hooks |
| skills/agent-authoring/design-patterns.md | Added optional hooks examples for validation and auto-formatting patterns |
| skills/agent-audit/SKILL.md | Added hooks validation checklist and workflow step |
| skills/agent-audit/tool-restrictions.md | Added Hooks Security Considerations section with security checklist and examples |
| rules/markdown.md | Updated markdownlint command from markdownlint-cli2 to markdownlint |
| rules/typescript.md | Minor formatting change to test file pattern |
| rules/python.md | Added blank lines around code block for formatting |
| skills/map-codebase/templates/*.md | Added blank lines before "What does NOT belong" sections |
| skills/map-codebase/SKILL.md | Added blank lines in Reference Files section |
| skills/command-audit/INDEX.md | Realigned table columns for better formatting |
| skills/hook-audit/comparison-with-official.md | Aligned table spacing |
💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.
| - Use `bunx` for external tools, `bun run` for scripts, `bun install` for dependencies—never npm/yarn | ||
| - Target Bun as the runtime; use Bun's native APIs where applicable (file I/O, testing, bundling) | ||
| - Use Bun's native test runner with `bun test` for all test files (_.test.ts, _.spec.ts) | ||
| - Use Bun's native test runner with `bun test` for all test files (_.test.ts,_.spec.ts) |
There was a problem hiding this comment.
Missing space after comma in test file pattern. Should be (*.test.ts, *.spec.ts) with a space after the comma for consistency.
Suggested change
| - Use Bun's native test runner with `bun test` for all test files (_.test.ts,_.spec.ts) | |
| - Use Bun's native test runner with `bun test` for all test files (_.test.ts, *.spec.ts) |
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.
This suggestion is invalid because no changes were made to the code.
Suggestions cannot be applied while the pull request is closed.
Suggestions cannot be applied while viewing a subset of changes.
Only one suggestion per line can be applied in a batch.
Add this suggestion to a batch that can be applied as a single commit.
Applying suggestions on deleted lines is not supported.
You must change the existing code in this line in order to create a valid suggestion.
Outdated suggestions cannot be applied.
This suggestion has been applied or marked resolved.
Suggestions cannot be applied from pending reviews.
Suggestions cannot be applied on multi-line comments.
Suggestions cannot be applied while the pull request is queued to merge.
Suggestion cannot be applied right now. Please check back later.
Document the new agent hooks feature that allows hooks to be defined in agent YAML frontmatter for lifecycle events scoped to that agent.
Changes: