# E Xode Vue Ssr Vue Ssr Hooks

> Vue SSR Hooks (Validation System)

- Skill: `tomevault-io/e-xode-vue-ssr-vue-ssr-hooks` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/e-xode-vue-ssr-vue-ssr-hooks`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/e-xode-vue-ssr-vue-ssr-hooks/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Web & Frontend
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/e-xode-vue-ssr-vue-ssr-hooks

---


# Vue SSR Hooks (Validation System)

> Owns the post-task validation pipeline: format → lint → test.

## Validation battery

Commands run in order (stop at first failure):

```bash
npx prettier --write .        # format
npm run lint                   # eslint fix
npm run test:run               # vitest single run
```

## Short-circuit table

| Files modified              | format      | lint | test    |
| --------------------------- | ----------- | ---- | ------- |
| `.vue`, `.js`               | ✅          | ✅   | ✅      |
| `.scss`, `.css` only        | ✅          | ✅   | ❌ skip |
| `.md`, `.json`, config only | ❌ skip all | ❌   | ❌      |

## Hook scripts

All scripts live in `.claude/hooks/`:

| Script                          | Purpose                                        |
| ------------------------------- | ---------------------------------------------- |
| `logs/logs.sh`                  | Logging infrastructure (timestamped entries)   |
| `guards/changes/changes.sh`     | Git digest sentinel (skip if no changes)       |
| `guards/subagents/subagents.sh` | Block validation commands in sub-agent prompts |
| `scripts/lint/lint.sh`          | Run eslint, report pass/fail                   |
| `scripts/test/test.sh`          | Run vitest, report pass/fail                   |
| `scripts/format/format.sh`      | Run prettier, report pass/fail                 |

## Settings

`.claude/settings._json` contains the hook configuration (disabled via `._json` extension). When activated, move content to `.claude/settings.json`.

## Architecture decision: why hooks are disabled

The shell hooks (settings.\_json) are disabled due to a known Copilot bug that causes unreliable hook execution. The workaround is the `hooks` agent — the orchestrator delegates validation to it manually per the Task completion protocol in CLAUDE.md.

**Do NOT re-enable** by renaming to `settings.json` until the Copilot bug is confirmed fixed.

Two-path architecture:

- **Current (active)**: Orchestrator → delegates to `hooks` agent → agent runs format/lint/test
- **Future (when bug fixed)**: Stop event → shell scripts run automatically → no agent needed

## The `hooks` agent

The `hooks` agent (model: haiku, tools: Bash) is the sole validation executor. The orchestrator delegates to it per the Task completion protocol in CLAUDE.md.

## Guard: subagents

The `subagents.sh` guard blocks sub-agent prompts containing forbidden validation commands (`npm test`, `npm run lint`, `npm run build`). This enforces the centralized-validation rule.

## Change detection

`changes.sh` computes a git digest (status + diff + untracked files → SHA). If the digest matches the last run's sentinel, validation is skipped (idempotent).

---
> Source: [e-xode/vue-ssr](https://github.com/e-xode/vue-ssr) — distributed by [TomeVault](https://tomevault.io).
<!-- tomevault:4.0:skill_md:2026-05-24 -->