codebase-conformity

Enforce existing codebase patterns before writing new code.

Updated Aug 20, 2025
One-click install
npx skills add https://github.com/BRANDNEWSHVT/mercora --skill codebase-conformity-brandnewshvt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: codebase-conformity
Source: https://github.com/BRANDNEWSHVT/mercora/tree/main/storefront-nuxt/.agents/skills/codebase-conformity
Command: npx skills add https://github.com/BRANDNEWSHVT/mercora --skill codebase-conformity-brandnewshvt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Enforces pattern uniformity when adding new code, ensuring teams observe existing conventions before writing to a codebase.

Core Features & Use Cases

  • Read-before-write discipline: require surveying at least 3 existing sibling files before introducing new code.
  • Pattern documentation: capture and apply canonical naming, structure, error handling, and data flow conventions.
  • Double verification: compare against a canonical sibling file and perform a second pass to confirm conformity.
  • Cross-domain applicability: applies to frontend, backend, routes, services, and utilities across commits and PRs.
  • Non-intrusive enforcement: guides reviews and CI checks without altering production code.

Quick Start

Read at least three sibling files to identify the current pattern, then implement the change strictly to that pattern and perform a second verification against a different reference file.

Frequently Asked Questions about codebase-conformity

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I enforce codebase conformity when adding new code to an existing project?

To enforce codebase conformity, read at least three existing sibling files to identify canonical patterns for naming, structure, and error handling before writing new code. Document these conventions, implement your change strictly following them, and perform a second verification pass against a different reference file.

Why does new code break existing codebase patterns and how can I prevent it?

New code breaks codebase patterns when developers skip surveying existing sibling files before writing. Prevent this by requiring a read-before-write discipline: analyze at least three sibling files to capture canonical naming, structure, and data flow conventions, then apply them strictly during implementation.

What's the best way to maintain pattern consistency across frontend and backend commits?

The best way to maintain pattern consistency across frontend and backend commits is to automate pattern conformity checks. Apply read-before-write discipline across routes, services, and utilities, documenting canonical patterns for error handling and data flow to ensure uniformity across all feature branches and PRs.

Does this codebase conformity approach work for both frontend and backend code reviews?

Yes, this codebase conformity approach works for both frontend and backend code reviews. It applies cross-domain to routes, services, utilities, styling, and error handling across commits and PRs, guiding reviews and CI checks non-intrusively without altering production code.

How do I verify naming and structure conventions before submitting a PR?

To verify naming and structure conventions before submitting a PR, implement your change strictly following the patterns identified from reading three sibling files, then perform a double verification by comparing your code against a second canonical reference file to confirm conformity.

Can I use pattern conformity checks without altering my production code?

Yes, you can use pattern conformity checks without altering production code. This approach provides non-intrusive enforcement that guides reviews and CI checks, ensuring teams observe existing conventions for naming, structure, and data flow without modifying the actual production codebase.