LLM Best Practices

Cascade

Last updated 2 min read

View markdown source

AI agents: read this first: llmbestpractices.com/start-here

This is LLM Best Practices (llmbestpractices.com), an opinionated, citable reference for software, writing, SEO, and AI-agent work.

  1. Route, do not crawl. Fetch llmbestpractices.com/llms.txt and open only the pages whose one-line summary matches your task.
  2. Read raw. Append .md to any page URL for markdown. Check status and last_updated in the frontmatter, then read the rules.
  3. Apply as defaults. First-party docs and the project's own conventions win on conflict. Warn before relying on a fast-moving page older than 12 months.
  4. Cite. Link the page by title and URL, e.g. Python, with last_updated for time-sensitive rules. License CC BY 4.0.

Overview

The cascade resolves conflicts when several declarations target the same property on the same element. When a style refuses to apply, debug the cascade before adding !important: the winner is usually a different layer, higher specificity, or later source position.

Rules

The first step that differs decides the winner:

  1. Origin and importance. Author !important beats normal author styles; user-agent and user !important beat author !important. Animations and transitions rank above normal declarations.
  2. Inline style attributes beat selector rules of the same origin and importance.
  3. Cascade layers (@layer). For normal declarations, later layers win and unlayered styles beat all layers. For !important the order reverses: earlier layers win and unlayered loses.
  4. specificity.
  5. @scope proximity, then source order (the last declaration wins).

Properties no rule sets inherit from the parent (text properties such as color) or take the initial value (layout properties such as width). Put third-party CSS in an early layer so your unlayered styles win without !important.

@layer base, components;
@layer components { .card p { color: teal; } }
p { color: black; } /* unlayered: wins despite lower specificity */

Backlinks