/dcm:quality — 코드 건강검진·자동수리#

한마디로#

코드를 건강검진하고 간단한 문제는 자동으로 고쳐주는 도구입니다. 자동차 정비소처럼, 어디가 문제인지 점검하고(분석) 손볼 수 있는 건 그 자리에서 수리(자동수정)해 줍니다.

누가·언제 쓰나요#

• 코드 품질을 한번 점검하고 싶을 때
• 안 쓰는 코드나 파일이 쌓여 있는지 확인하고 정리하고 싶을 때
• 코드 규칙(린트) 위반이나 복잡도 같은 지표를 살펴보고 싶을 때
• 고칠 수 있는 문제를 자동으로 정리하고 싶을 때

무엇을 해주나요#

• 코드 전체를 점검해 문제를 파일별·심각도별로 정리한 리포트를 보여줍니다.
• 자동으로 고칠 수 있는 문제는 그 자리에서 수정합니다.
• 안 쓰는 코드·안 쓰는 파일·중복 코드·복잡도 지표를 찾아냅니다.
• 한 번에 기준선을 잡는 작업(baseline)을 하면 dcm_baseline.json 파일이 만들어집니다 — 지금까지의 문제는 "이미 알고 있는 것"으로 묶어두고, 앞으로 새로 생기는 문제만 골라서 관리할 수 있습니다.

어떻게 쓰나요#

# 기본 점검 (대상 생략 시 lib 폴더)
/dcm:quality

# 특정 폴더만 점검
/dcm:quality lib/src/feature

# 전체 점검 후 자동수정까지 한 번에
/dcm:quality --mode=full

# 빠른 단일 점검 — 린트 / 안 쓰는 코드 / 지표
/dcm:quality --mode=analyze
/dcm:quality --mode=unused
/dcm:quality --mode=metrics

# 자동수정 (위험한 수정까지 포함하려면 --unsafe)
/dcm:quality --mode=fix
/dcm:quality --mode=fix --unsafe

# 기준선(baseline) 잡기
/dcm:quality --baseline

• --mode는 점검 방식입니다: full(전체), analyze(린트만), fix(자동수정), unused(안 쓰는 코드), metrics(지표), duplication(중복).
• --reporter로 결과 형식을 바꿀 수 있습니다: console(기본, 화면 출력), json(파일·도구 연동용).
• --unsafe는 자동수정 시 다소 위험할 수 있는 수정까지 포함합니다.

안에서 무슨 일이 벌어지나요#

선택한 방식에 따라 점검과 수정을 차례로 진행합니다.

1. 전체 점검(full) — 모든 검사를 한 번에 돌리고, 결과를 파일·심각도별로 묶어 보여줍니다. 그다음 자동수정을 하고, 다시 점검해서 "자동으로 해결된 것"과 "사람이 직접 손봐야 하는 것"을 구분해 알려줍니다.
2. 빠른 점검(analyze/unused/metrics) — 필요한 검사 하나만 골라 돌리고 결과를 보고합니다.
3. 자동수정(fix) — 고칠 수 있는 문제를 정리하고, 안 쓰는 코드도 정리한 뒤, 다시 점검해서 제대로 고쳐졌는지 확인합니다.
4. 기준선 잡기(baseline) — 먼저 진행 계획을 보여주고, 확인을 받은 뒤 단계별로 실행해 dcm_baseline.json을 만들고 커밋까지 안내합니다.

/dcm:quality {target} [--options]

/dcm:quality --mode=full

/dcm:quality --mode=analyze
/dcm:quality --mode=unused
/dcm:quality --mode=metrics

/dcm:quality --mode=fix
/dcm:quality --mode=fix --unsafe

/dcm:quality --baseline