Detect conflicts between code-convention.yaml and adr.yaml files.
npx skills add https://github.com/KangJiSseok/ACODIAN --skill code-review-docs
Please help me install this Agent Skill. Skill: code-review-docs Source: https://github.com/KangJiSseok/ACODIAN/tree/main/.codex/skills/code-review-docs Command: npx skills add https://github.com/KangJiSseok/ACODIAN --skill code-review-docs
Consistency drift between ADR decisions and coding-convention docs across modules can cause conflicting guidance and brittle change workflows.
To begin, specify the module and the target update (convention, adr, or both) to generate change proposals.
High-intent search queries and answers about installing and using this skill.
To detect conflicts between ADRs and coding conventions, specify a target module like api or web to compare docs/{module}/code-convention.yaml against docs/{module}/adr.yaml. The analysis identifies consistency drift and generates structured proposals detailing required and recommended changes.
Consistency drift occurs when ADR decisions and coding-convention docs provide conflicting guidance across modules. This misalignment causes brittle change workflows and conflicting development instructions, requiring targeted reconciliations and chained edits to maintain alignment.
Generate change proposals by specifying the module and the target update, choosing either convention, adr, or both. The process outputs a structured proposal set detailing MUST and RECOMMENDED changes, including rationale and impact for both YAML files.
Yes, batch analysis is supported for multiple modules including api, web, infra, and ai. The process provides prioritized change proposals to maintain alignment across ADRs and conventions for all specified modules.
Conflicting guidance arises when ADR decisions and code convention YAML files are not synchronized during updates. Identifying these conflicts requires comparing both files per module to propose targeted reconciliations and chained edits.
The best way to maintain alignment is to perform automated conflict detection between ADR and convention YAML files, then apply prioritized change proposals with structured rationale to ensure both documents remain synchronized across modules.
mattjeffersonInitialize a repository with Harness Engineering directory structure and baseline documentation files.
jerelvelardeUpdate documentation files in .chalk/docs and confirm the revised file path.
softmgOrchestrate symbol-aware refactors with linter and test verification.
JsplixUpdate module-specific code convention and ADR YAML files with conflict analysis.
