> ## Documentation Index
> Fetch the complete documentation index at: https://docs.enagrams.com/llms.txt
> Use this file to discover all available pages before exploring further.

# convention_propose

> Record a team convention, optionally as a hard edit gate

## Overview

Conventions are team rules with enforcement tiers:

| Tier     | Behavior                                                                                                                           |
| -------- | ---------------------------------------------------------------------------------------------------------------------------------- |
| `must`   | Hard gate on PreToolUse — edits to files matching `affected_files` are blocked until the convention is superseded or marked stale. |
| `should` | Surfaced as advisory context in `sync`.                                                                                            |
| `may`    | Recorded for awareness; no enforcement.                                                                                            |

Keep `affected_files` narrow — broad `must`-tier conventions create false blocks.

## Parameters

| Parameter        | Type      | Required | Description                                   |
| ---------------- | --------- | -------- | --------------------------------------------- |
| `title`          | string    | Yes      | Short convention title                        |
| `rationale`      | string    | No       | Why the team adopted it                       |
| `tier`           | string    | No       | `must`, `should`, or `may` (default `should`) |
| `affected_files` | string\[] | No       | File paths the convention applies to          |
| `affected_areas` | string\[] | No       | Logical areas (e.g. `auth`, `billing`)        |
| `session_id`     | string    | No       | Your session id                               |

## Example

```json theme={null}
{
  "tool": "convention_propose",
  "arguments": {
    "title": "Use zod for all request body validation",
    "rationale": "Single source of truth for schemas; prevents the joi/yup/zod triad we ended up with last quarter.",
    "tier": "must",
    "affected_files": ["src/routes/**/*.ts"]
  }
}
```