find-rules

Files (1)

• SKILL.md

SKILL.md (first lines)

# Find Rules

This skill helps you discover and understand the specific rules, conventions, and guidelines that apply to your current task. It systematically explores project documentation to ensure compliance with project standards.

## Instructions

Follow this workflow to identify applicable rules:

### 1. Understand Context

First, analyze the task to determine:

- **Task Type**: PRD creation, Technical Spec, Feature Implementation, Refactoring, Bugfix, etc.
- **Technologies**: React, Elysia, Tailwind, Drizzle, etc.
- **Aspects**: Architecture, Testing, Styling, Naming, etc.

### 2. Pattern-Based Discovery

**REQUIRED:** Use `Glob` and `Grep` tools for local code discovery to find relevant rule files and guidelines.

**EXECUTION STRATEGY:** Execute 3+ tools simultaneously in the FIRST action for efficiency. Never execute tools sequentially when they can run in parallel.

**MANDATORY STEPS:**

1.  **Find Rule Files (run in parallel)**: Use multiple `Glob` patterns simultaneously.

    ```
    # Primary rules
    Glob pattern=".cursor/rules/*.mdc"
    Glob pattern="**/CLAUDE.md"
    Glob pattern="**/AGENTS.md"

    # Secondary rules
    Glob pattern="**/CONTRIBUTING.md"
    Glob pattern="**/ARCHITECTURE.md"
    Glob pattern="**/STYLEGUIDE.md"

    # Alternative AI tool locations
    Glob pattern=".windsurf/rules/*"
    Glob pattern=".cursorrules"
    Glob pattern=".copilot/*"

    # Configuration files
    Glob pattern="**/.eslintrc*"
    Glob pattern="**/tsconfig.json"
    Glob pattern="**/biome.json"
    ```

2.  **Search by Content**: Use `Grep` to find rules mentioning specific technologies or concepts.

    ```
    Grep pattern="react" path=".cursor/rules"
    Grep pattern="CRITICAL|MANDATORY" path=".cursor/rules" output_mode="content"
    Grep pattern="testing" glob="*.md"
    Grep pattern="must|should|never" glob="*.mdc" -i=true
    ```

3.  **Search Locations Priority**:
    - `.cursor/rules/*.mdc` - Technology-specific rules (highest priority)
    - `CLAUDE.md` - General project guidelines
    - `AGENTS.md` - Agent-specific instructions
    - `.windsurf/rules/`, `.cursorrules` - Alternative AI tool rules
    - `docs/` - Documentation directory
    - Configuration files - Implicit rules from tooling

### 3. Extract and Categorize Rules

Once you identify the relevant files:

1.  **Read**: Use the `Read` tool to examine the full content of the identified rule files (e.g., `.cursor/rules/react.mdc`).

2.  **Categorize Each Rule**:
    For each rule found, determine:
    - **Category**: Domain area (e.g., Authentication, Testing, Security, Performance, Styling, Architecture)
    - **Content**: The actual rule or guideline text
    - **Source File**: File path where the rule was found
    - **Enforcement Level**: CRITICAL, MANDATORY, RECOMMENDED, or SUGGESTED

3.  **Analyze**:
    - Look for **CRITICAL** or **MANDATORY** requirements first
    - Identify naming conventions, file structures, and required patterns
    - Note any conflicts or specific instructions for the technologies involved
    - Check for keywords: "must", "should", "never", "always", "required", "forbidden"

### 4. Present Findings

Summarize the rules you found in a clear, actionable format:

- **Rule/Guideline**: The specific standard.
- **Source**: File path and section where it is defined.
- **Enforcement Level**: CRITICAL, MANDATORY, RECOMMENDED.
- **Applicability**: Why it applies to this task.

## Documentation Sources

### Primary Rule Locations

- **.cursor/rules/\*.mdc**: Technology-specific rules (React, Backend, Tailwind, etc.)
- **CLAUDE.md**: General AI assistant guidelines and project context
- **AGENTS.md**: Agent-specific instructions and workflows

### Secondary Rule Locations

- **CONTRIBUTING.md**: Contribution guidelines and processes
- **CODE_OF_CONDUCT.md**: Community and code standards
- **ARCHITECTURE.md**: Architectural decisions and patterns
- **STYLEGUIDE.md**: Code style conventions
- **CODING_STANDARDS.md**: Programming standards

### Alternative AI Tool Locations

- **.windsurf/rules/**: Windsurf-specific rules
- **.cursorrules**: Cursor rules file
- **.copilot/**: GitHub Copilot configuration
- **.codeium/**: Codeium configuration

### Configuration Files (Implicit Rules)

- **.eslintrc.\*, .eslintrc.json**: Linting rules

From marcioaltoe/skills, MIT.

More from marcioaltoe/skills