feat: hook

Author: bgagent

README.md

@@ -106,6 +106,10 @@ The `--plugin-dir` flag tells Claude Code to load the local plugin from the `doc
 | `cdk-expert` | CDK architecture, construct design, handler implementation, stack modifications |
 | `agent-debugger` | Task failure investigation, CloudWatch log analysis, agent runtime debugging |
 
+**Hook** (runs automatically):
+
+A `SessionStart` hook advertises available skills and agents so Claude can proactively suggest them when your request matches.
+
 #### Local plugin development
 
 If you're modifying the plugin itself, here's the file layout:
@@ -124,12 +128,15 @@ docs/abca-plugin/
   agents/
     cdk-expert.md                # CDK infrastructure specialist
     agent-debugger.md            # Task failure debugger
+  hooks/
+    hooks.json                   # SessionStart capability advertisement
 ```
 
 **Key conventions:**
 - The plugin lives under `docs/` to keep documentation and plugin content colocated
 - Skills live in subdirectories with a `SKILL.md` file (not flat `.md` files)
 - Agents are flat `.md` files with YAML frontmatter
+- The hook advertises plugin capabilities only (no project-specific content)
 
 **After editing plugin files**, restart Claude Code with `claude --plugin-dir docs/abca-plugin` to pick up changes.
 

docs/abca-plugin/README.md

@@ -37,6 +37,10 @@ Or add to your project's `.claude/settings.json`:
 | `cdk-expert` | Sonnet | AWS CDK infrastructure expert for construct design, handler implementation, and stack modifications |
 | `agent-debugger` | Sonnet | Read-only debugging specialist for task failures, preflight errors, and CloudWatch log analysis |
 
+### Hook
+
+- **SessionStart** — Advertises available skills and agents so Claude can proactively suggest them when your request matches.
+
 ## Plugin Structure
 
 ```
@@ -45,6 +49,8 @@ docs/abca-plugin/
   agents/
     cdk-expert.md          # CDK infrastructure agent
     agent-debugger.md      # Runtime debugging agent
+  hooks/
+    hooks.json             # SessionStart capability advertisement
   skills/
     setup/SKILL.md         # First-time setup workflow
     deploy/SKILL.md        # CDK deployment management

docs/abca-plugin/hooks/hooks.json

@@ -0,0 +1,10 @@
+{
+  "hooks": {
+    "SessionStart": [
+      {
+        "type": "prompt",
+        "prompt": "The ABCA plugin is active. Available skills:\n- /setup — first-time setup walkthrough\n- /deploy — deploy, diff, or destroy the CDK stack\n- /onboard-repo — add a GitHub repository\n- /submit-task — submit a coding task with prompt coaching\n- /troubleshoot — diagnose deployment, auth, or task issues\n- /abca-status — quick platform health check\n- /abca-submit — shortcut for rapid task submission\n\nAvailable agents: cdk-expert (CDK infrastructure), agent-debugger (task failure investigation).\n\nSuggest relevant skills when the user's request matches."
+      }
+    ]
+  }
+}