claude-hook-sdlc
Files
SKILL.mdagentsreferences
Install
Install the containing plugin
/plugin install shared-skills@llm-skills
Invoke this skill after installation
/shared-skills:claude-hook-sdlc
This skill is bundled inside shared-skills. Install the plugin once, then Claude Code can use any of its included skills. Browse the full plugin repository at github.com/alisonaquinas/llm-shared-skills.
SKILL.md
name: claude-hook-sdlc description: > Orchestrate the full end-to-end SDLC for hook automation rule development. Use when building a new hook automation rule from scratch, following a complete development pipeline, managing iteration across planning, design, creation, testing, verification, integration, validation, and live scenario testing, or recovering from a failed gate without restarting the whole effort.
Hook SDLC
End-to-end SDLC orchestrator for building, validating, and shipping hook automation rules.
Intent Router
Load reference files on demand only when the corresponding phase is active:
references/phase-planning.md— Phase 1: planning guidance, deliverables, and gate criteriareferences/phase-design.md— Phase 2: design guidance, deliverables, and gate criteriareferences/phase-creation.md— Phase 3: creation guidance, deliverables, and gate criteriareferences/phase-testing.md— Phase 4: testing guidance, deliverables, and gate criteriareferences/phase-verification.md— Phase 5: verification guidance, deliverables, and gate criteriareferences/phase-integration.md— Phase 6: integration guidance, deliverables, and gate criteriareferences/phase-validation.md— Phase 7: validation guidance, deliverables, and gate criteriareferences/phase-test-drive.md— Phase 8: test drive guidance, deliverables, and gate criteriareferences/iteration-patterns.md— Phase 9: iterative development guidance, deliverables, and gate criteria
Quick Start
| # | Phase | Primary Skill | Gate Criterion | On Failure |
|---|---|---|---|---|
| 1 | Planning | claude-hook-planning | Planning is complete when event scope, matcher inventory, interface summary, and success criteria are all written with no TBD items. | Clarify scope |
| 2 | Design | claude-hook-design | Design is complete when every event, matcher, input, output, and decision path is explicit and no safety rule is left implicit. | Revise contract |
| 3 | Creation | claude-hook-creation | Creation is complete when the target files exist, the rule can be exercised locally, and every declared dependency is resolvable. | Fix implementation |
| 4 | Testing | claude-hook-testing | Testing is complete when the happy path, one variant, one blocked path, and one recovery path all have evidence. | Fix coverage |
| 5 | Verification | claude-hook-verification | Verification is complete when all required checklist items pass and no unresolved mismatch remains between design and implementation. | Fix mismatch |
| 6 | Integration | claude-hook-integration | Integration is complete when discovery succeeds, one live invocation works, and any required local settings are documented. | Fix wiring |
| 7 | Validation | claude-hook-validation | Rubric verdict is APPROVE and H04 Safety passes | Address failed rubric items |
| 8 | Test Drive | claude-hook-test-drive | Test drive is complete when at least five scenarios were attempted, at least three passed, and a friction report was written. | Address friction |
| 9 | Iterative Development | claude-hook-iterative-development | Iteration is complete when the right upstream phase is re-run, the failing gate passes again, and the evidence trail is updated. | Continue fixing |
Iteration Patterns
| Failure Mode | Re-Entry Phase | Phases to Skip |
|---|---|---|
| Scope or audience mistake | Phase 1 | None |
| Interface or safety contract mistake | Phase 2 | 1 |
| Implementation defect | Phase 3 | 1, 2 |
| Coverage gap | Phase 4 | 1-3 |
| Contract mismatch discovered late | Phase 5 | 1-4 |
| Wiring or discovery failure | Phase 6 | 1-5 |
| Rubric failure only | Phase 7 | 1-6 |
| Test-drive friction | Phase 8 | 1-7 |
| Re-entry decision unclear | Phase 9 | 1-8 |
Ship Checklist
[ ] Every phase gate passed or was explicitly re-run after changes
[ ] README entry added for each new skill in the family
[ ] Focused lint and validation runs are green
[ ] Baseline repo gates pass
[ ] Changelog entry is written
Example Handoff
Current phase: testing
Failed gate: blocked-path evidence missing for one matcher variant
Next step: return to claude-hook-testing, add the blocked scenario, then rerun
claude-hook-verification before integration.
Resource Index
| Reference File | Phase | Load When |
|---|---|---|
references/phase-planning.md | Phase 1 | Planning guidance and gate criteria |
references/phase-design.md | Phase 2 | Design guidance and gate criteria |
references/phase-creation.md | Phase 3 | Creation guidance and gate criteria |
references/phase-testing.md | Phase 4 | Testing guidance and gate criteria |
references/phase-verification.md | Phase 5 | Verification guidance and gate criteria |
references/phase-integration.md | Phase 6 | Integration guidance and gate criteria |
references/phase-validation.md | Phase 7 | Validation guidance and gate criteria |
references/phase-test-drive.md | Phase 8 | Test Drive guidance and gate criteria |
references/iteration-patterns.md | Phase 9 | Iterative Development guidance and gate criteria |