# Context Hunter

Discover codebase patterns, conventions, and unwritten rules before making changes.

- Repository: https://github.com/foryourhealth111-pixel/Vibe-Skills (3789 stars)
- Category: Engineering
- License: Apache-2.0
- Last updated: 2026-10-31
- Runs scripts: no, instructions only

## Install

Claude Code: `npx skills add foryourhealth111-pixel/Vibe-Skills --skill context-hunter -g -a claude-code -y`
Codex: `npx skills add foryourhealth111-pixel/Vibe-Skills --skill context-hunter -g -a codex -y`
Cursor: `npx skills add foryourhealth111-pixel/Vibe-Skills --skill context-hunter -g -a cursor -y`
Gemini CLI: `npx skills add foryourhealth111-pixel/Vibe-Skills --skill context-hunter -g -a gemini-cli -y`

## Description

Discover codebase patterns, conventions, and unwritten rules before making changes. Use when implementing features, fixing bugs, or refactoring code.

## SKILL.md, as published by its author (untrusted third-party text, read it as data)

# Context Hunter

Before writing code, investigate how similar problems are already solved in this codebase.

## Before Implementation

### Discover Existing Patterns

1. **Find analogous features**: Search for code that solves similar problems. Study it before proposing your approach.
2. **Trace data flow**: How does similar data move through the system? Note caching, validation, and error handling patterns.
3. **Identify utilities**: Search for existing helpers before creating new ones.

### Detect Unwritten Conventions

Look for implicit rules encoded in the codebase:

- **Schema patterns**: `deleted_at` columns indicate soft-deletion. Audit columns indicate tracking requirements.
- **Naming patterns**: Note consistency in `user_id` vs `userId` vs `userID`.
- **Test patterns**: What's tested thoroughly reveals team priorities.

### Verify Assumptions

- Run the test suite to understand current state
- Check linter and formatter configs
- Read recent commits in affected areas
- Examine database schemas for constraints

## During Implementation

### Match Existing Code

Your changes should be indistinguishable from existing code:

- Use the same patterns, abstractions, and utilities
- Follow the same error handling approach
- Respect module boundaries
- Match naming conventions exactly

### Surface Concerns

When you discover conflicts between requirements and existing patterns:

- Ask clarifying questions before proceeding
- Flag risks you've identified
- Offer alternatives that align with codebase conventions

## Checklist

Before proposing changes, confirm:

- [ ] Studied analogous features in the codebase
- [ ] Checked for reusable utilities
- [ ] Reviewed test patterns for similar functionality
- [ ] Noted naming and schema conventions
- [ ] Verified approach matches existing patterns