aiwg
Version:
Deployment tool and support utility for AI context. Copies agents, skills, commands, rules, and behaviors into the paths each AI platform reads (Claude Code, Codex, Copilot, Cursor, Warp, OpenClaw, and 6 more) so one source of truth works across 10 platfo
136 lines (135 loc) • 4.3 kB
JSON
{
"id": "aiwg-hooks",
"type": "addon",
"name": "AIWG Hooks",
"version": "1.1.0",
"description": "Claude Code hook templates for workflow tracing, permissions, session management, context injection, and quality gates",
"core": false,
"autoInstall": true,
"author": "AIWG Contributors",
"license": "MIT",
"repository": "https://github.com/jmagly/aiwg",
"keywords": [
"aiwg",
"hooks",
"trace",
"permissions",
"session",
"observability",
"context-injection",
"quality-gates",
"pretooluse",
"security"
],
"researchFoundation": {
"REF-001": "BP-6 Observability - Production workflows require trace capture",
"REF-002": "Archetype 4 - Recovery requires execution history",
"REF-071": "METR Reward Hacking - Test deletion prevention",
"REF-072": "Anthropic Misalignment - Sabotage detection",
"REF-013": "MetaGPT Executable Feedback - Tests before return",
"REF-015": "Self-Refine - Quality enforcement in iteration loops"
},
"entry": {
"hooks": "hooks/",
"scripts": "scripts/",
"templates": "templates/"
},
"hooks": [
{
"id": "aiwg-trace",
"type": "executable",
"description": "Workflow trace capture for debugging and reproducibility",
"file": "hooks/aiwg-trace.cjs"
},
{
"id": "aiwg-permissions",
"type": "executable",
"description": "Tool permission validation and enforcement",
"file": "hooks/aiwg-permissions.cjs"
},
{
"id": "aiwg-session",
"type": "executable",
"description": "Session state management and context preservation",
"file": "hooks/aiwg-session.cjs"
},
{
"id": "pretooluse-context",
"type": "documentation",
"description": "PreToolUse hook templates for targeted context injection (Claude Code v2.1.9+)",
"file": "hooks/pretooluse-context.md",
"issues": ["#284"],
"patterns": [
"aiwg-artifact-guard",
"bash-security-guard",
"voice-profile-reminder",
"research-citation-guard"
]
},
{
"id": "quality-gates",
"type": "documentation",
"description": "Quality gate hook templates for comprehensive validation (Claude Code v2.1.3+)",
"file": "hooks/quality-gates.md",
"issues": ["#289", "#264"],
"patterns": [
"pre-commit-tests",
"security-gate",
"pre-push-validation",
"anti-laziness-gate"
]
}
],
"scripts": [
"trace-viewer",
"trace-export"
],
"features": {
"observability": {
"description": "Workflow trace capture and session management",
"hooks": ["aiwg-trace", "aiwg-session"]
},
"security": {
"description": "Tool permissions and security pattern enforcement",
"hooks": ["aiwg-permissions", "bash-security-guard", "security-gate"]
},
"context-injection": {
"description": "Smart context loading at point of tool use",
"hooks": ["pretooluse-context"],
"requires": "Claude Code v2.1.9+"
},
"quality-gates": {
"description": "Pre-commit/pre-push validation and anti-laziness detection",
"hooks": ["quality-gates"],
"requires": "Claude Code v2.1.3+"
}
},
"platformSupport": {
"claude-code": {
"version": "2.1.3+",
"features": ["all"],
"notes": "Full support for PreToolUse, quality gates with 10-minute timeout"
},
"cursor": {
"features": ["observability"],
"notes": "Use .cursor/rules/ for path-scoped context, native git hooks for quality gates"
},
"copilot": {
"features": ["observability"],
"notes": "Use .github/copilot/ for context, GitHub Actions for quality gates"
},
"generic": {
"features": ["observability"],
"notes": "Use CLAUDE.md for context, native git hooks or CI/CD for quality gates"
}
},
"installation": {
"recommended": "Add hook configurations to .claude/settings.json (project or user-wide)",
"alternative": "Use native git hooks (.git/hooks/) for cross-platform compatibility"
},
"documentation": [
"hooks/pretooluse-context.md - PreToolUse context injection patterns",
"hooks/quality-gates.md - Quality gate hook templates",
"README.md - Addon overview and setup"
]
}