claude-config / conventions

# conventions/

Universal conventions for agents and skills.

## Files

| File                | What                                     | When to read                                            |
| ------------------- | ---------------------------------------- | ------------------------------------------------------- |
| `documentation.md`  | CLAUDE.md/README.md format specification | Writing CLAUDE.md, creating README.md, doc-sync skill   |
| `intent-markers.md` | :PERF:/:UNSAFE:/:SCHEMA: marker spec     | Adding intent markers, QR validation of markers         |
| `severity.md`       | MUST/SHOULD/COULD severity definitions   | Understanding QR severity, writing QR scripts           |
| `structural.md`     | Code quality conventions, testing rules  | QR code review, planner decision audit                  |
| `temporal.md`       | Timeless present rule for comments       | TW/QR temporal contamination checks, writing comments   |
| `diff-format.md`    | Unified diff spec for code changes       | Writing code diffs, Developer/QR diff validation        |

## Subdirectories

| Directory       | What                                   | When to read                                                       |
| --------------- | -------------------------------------- | ------------------------------------------------------------------ |
| `code-quality/` | Baseline/split/drift quality checks    | Design, code review, refactoring, planning-time quality validation |