liveBook · Manning

Lint-as-architecture

As explained in Vibe Engineering

Lint-as-architecture is the practice of expressing architectural knowledge as executable checks that fail when prohibited structures or dependencies appear.

An architectural rule known only to a team can be missed by a coding agent—or a new teammate. Lint-as-architecture turns that implicit knowledge into executable checks that fail the build when prohibited structures or dependencies appear. section 10.5.1

Turn recurring violations into guardrails:

  • Fix the immediate problem in the pull request. section 10.5.1
  • Codify the architectural rule behind the correction. section 10.5.1
  • Add a lint rule or architectural check to prevent the violation from recurring. section 10.5.1

A database boundary

If API-layer code calls the database directly, correct the call in review. When the violation recurs, add a check that fails the build on the prohibited dependency. The rule preserves a convention that previously depended on onboarding and review feedback. section 10.5.1

Checks can reduce repeated convention reviews, but they do not settle every merge decision. Policy-based triage accounts for context such as module criticality, ownership, and downstream consumers; human judgment remains necessary for architecture and tradeoffs. section 10.5.2 section 10.9

How Vibe Engineering covers it

How deep it goes
Describes a fix, codify, and lint pipeline, without specifying an implementation for an individual rule.
Examples
Uses direct database calls from an API layer, missing authentication checks, and service-to-service HTTP calls as violations to codify.
What you can do after
Apply it by converting recurring architectural violations into checks that prevent their repetition.
How it connects
Connects architectural constraints with code review, linting, and policy-based triage.

Related concepts

This explainer was generated by Manning's knowledge graph from the text of Vibe Engineering. The section links point to the parts of the book it draws on.