hook-development Cursor ruleA

hook-development from vibeeval/vibecosystem is a Cursor rule: instructions the Cursor agent follows in that repo.

mdr add vibeeval/vibecosystem/.cursor/rules/hook-development.mdc@git:20260330.cd5da78

Pins git:20260330.cd5da78 in mdr.lock. Pin the fingerprint instead.

Audit grade

A, 14 of 14 checks passed

Kind

Cursor rule

Repository

vibeeval/vibecosystem

Path

.cursor/rules/hook-development.mdc

Versions recorded

1

Latest version

git:20260330.cd5da78, committed Mar 30, 2026

Size

1,069 bytes

Repository stars

539

License

MIT

Rules for developing vibecosystem TypeScript hooks.

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Hook Development Rules

## Hook Types
- **PreToolUse**: Runs before a tool executes (validation, parameter modification)
- **PostToolUse**: Runs after a tool executes (formatting, checking)
- **Stop**: Runs when session ends (final validation)

## File Structure
```
hooks/
  src/           # TypeScript source files
    shared/      # Shared utilities
  dist/          # Compiled .mjs files (esbuild output)
  package.json
  tsconfig.json
```

## Hook Output Format
```typescript
interface HookResult {
  result: string;           // shown in terminal
  systemMessage?: string;   // injected into AI context
  permissionDecision?: "allow" | "deny";
  reason?: string;          // if denied
}
```

## Rules
- Always handle errors with try/catch
- Return valid JSON to stdout
- Read input from stdin (JSON)
- Use `systemMessage` for AI context injection, not `message`
- Keep hooks fast (< 500ms)
- Build with: `cd hooks && npm run build`

Read the whole file at its exact version.

How to install

mdr add vibeeval/vibecosystem/.cursor/rules/hook-development.mdc@sha256:6a514aac660fddbc

[![mdr](https://markdownregistry.com/badge/art_3z2mgrcbxmafbel6.svg)](https://markdownregistry.com/a/art_3z2mgrcbxmafbel6)

Versions

The registry has recorded 1 version of this file, committed on Mar 30, 2026.

Audit of the latest version

Source

API

GET https://markdownregistry.com/api/v1/artifacts/art_3z2mgrcbxmafbel6
GET https://markdownregistry.com/api/v1/resolve?ref=vibeeval/vibecosystem/.cursor/rules/hook-development.mdc
GET https://markdownregistry.com/api/v1/blob/6a514aac660fddbc69e087ccdec0096376b6ec3d9e82f8ed252e0262f183d1bf

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: Cursor rules vs AGENTS.md · which agent file does what.

More from vibeeval/vibecosystem

Every file in vibeeval/vibecosystem

Other files named hook-development

Browse by kind, by grade A, or by owner.