convention-audit

Analyze recent commit patterns against frontend and backend convention documents.

8|2|Updated May 3, 2026
One-click install
npx skills add https://github.com/ejoongseok/claude-settings --skill convention-audit-ejoongseok
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: convention-audit
Source: https://github.com/ejoongseok/claude-settings/tree/main/claude-code/skills/convention-audit
Command: npx skills add https://github.com/ejoongseok/claude-settings --skill convention-audit-ejoongseok

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill finds and reports coding-convention drift by comparing recent commit coding patterns against your existing frontend/backend convention documents, helping keep standards consistent over time.

Core Features & Use Cases

  • Convention comparison from recent commits: Collects changed files for a configurable time window and extracts coding patterns to compare against FE/BE convention baselines.
  • Three-tier outputs with justification: Classifies issues into Deviation (이탈), New Pattern (추가 후보), and Convention Drift (수정 후보) with frequency/consistency checks.
  • Approval-based apply workflow: Lets you select approved items and applies them to convention documents without deleting prior content, using explicit tags and changelog updates.

Quick Start

Run the convention-audit to analyze the last two weeks of commits and generate a report comparing FE and BE conventions.

Frequently Asked Questions about convention-audit

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

FAQPage Schema
How do I detect coding convention drift from recent git commits?

You can detect convention drift by analyzing time-windowed git commits, extracting coding patterns from changed files, and comparing them against existing frontend and backend convention baselines to classify deviations.

What is the best way to compare recent code changes against backend and frontend conventions?

Comparing recent code changes against frontend and backend conventions involves running a convention audit that extracts evidence via git log queries and categorizes findings into deviations, new pattern candidates, and modification candidates.

Can I filter convention audit results by specific team members?

Yes, you can filter convention audit results by specific team members. The analysis supports time-windowed and optional team-member-filtered reviews for both frontend JavaScript and backend Java or SQL code changes.

How do I safely update convention documents with new coding patterns?

You can safely update convention documents by selecting approved items from the audit report and applying them to convention files without deleting prior content, ensuring changes are tracked with explicit tags and changelog updates.

Does convention audit work with both Java and JavaScript codebases?

Yes, convention audit works with both Java and JavaScript codebases. It analyzes backend code changes in Java and SQL alongside frontend JavaScript changes to detect convention drift against existing baselines.

What are the limitations of automated convention drift detection?

Automated convention drift detection requires existing convention baselines and relies on frequency thresholds to categorize findings. It only applies approved items back into convention files, meaning unapproved patterns remain unupdated.