Skip to main content
CORE:C:0012 mechanical high coherence core

Coding Conventions

The instruction file must specify coding conventions — formatting tools, linting rules, and style preferences. Without these, the agent produces code that doesn't match the project's standards.

Antipatterns

  • Describing coding style in prose without a heading containing "Conventions", "Formatting", "Style", or "Lint". The check looks for a matching heading, not convention-related content in other sections.
  • Using a heading like "## Rules" or "## Standards" that does not contain any of the matched keywords. Close synonyms do not satisfy the heading check.
  • Placing conventions only in a linter config file (.eslintrc, ruff.toml) without documenting them in the instruction file. The check targets instruction file headings, not config files.

Pass / Fail

Pass

# MyProject

## Conventions

Use `ruff` for formatting.
Prefer `dataclasses` over plain dicts.

Fail

# MyProject

## Architecture

src/ contains domain logic.
tests/ contains pytest suites.

Limitations

Checks for a heading containing "Conventions", "Formatting", "Style", or "Lint". Does not verify the section specifies actionable rules.