mandu-lint

Files (1)

• SKILL.md

SKILL.md (first lines)

# Mandu Lint

Mandu 의 lint 레이어는 **guard (아키텍처) + typecheck (타입) + lint (코드 품질)**
3축 가드레일 중 하나. oxlint (Rust-based, ESLint 대비 50–100× 빠름) 를 기본으로.

## 가드레일 체계 (꼭 기억할 것)

| 레이어 | 도구 | 무엇을 잡나 | 비용 |
|--------|------|-----------|------|
| **guard** | `mandu guard` / `mandu_guard_check` | 아키텍처 / 레이어 / import 규칙 | ~1s |
| **typecheck** | `mandu check` / `tsgo` | 타입 에러 | ~7s |
| **lint** | `oxlint` / `mandu.lint` | 코드 품질 (`no-explicit-any`, `no-unused-vars`, 등) | ~500ms |
| **lint --type-aware** | `oxlint --type-aware` / `mandu guard --type-aware` | 타입 의존 lint (`no-floating-promises`) | ~3s |

세 개 모두 녹색이 된 후에만 commit / push. `mandu check` 는 이 모두를 종합 실행.

## Trigger

- 파일 편집 후 (특히 대량 수정 / 리팩터)
- "lint 해줘", "코드 스타일 체크", "warning 줄여줘"
- lint 에러가 CI 에서 발견된 경우
- 신규 프로젝트 셋업 / 기존 프로젝트에 lint 미설치 상태

## MCP 도구

| 도구 | 용도 | side effect |
|------|------|------------|
| `mandu.lint` | 린트 실행 + 에러/경고 카운트 | 없음 (읽기 전용) |
| `mandu.lint.setup` | oxlint 설치 + `.oxlintrc.json` 스캐폴드 + scripts 배선 | 파일 수정 (destructive) |

## 표준 흐름

### 1. 신규 프로젝트
`mandu init` 은 `.oxlintrc.json` + `oxlint` devDep + `lint` 스크립트 + `lefthook.yml` (pre-push lint + typecheck) 를 기본 포함. 추가 작업 불필요.

### 2. 기존 프로젝트에 lint 가 없는 경우
```
mandu.lint.setup({ dryRun: true })   ← 먼저 계획 보기
  → mandu.lint.setup({})              ← 적용
  → mandu.lint({})                    ← 베이스라인 확인
```

또는 shell:
```bash
mandu lint --setup
mandu lint
```

### 3. 편집 후 검증
`mandu-mcp-verify` fast path 에 이미 포함됨:
```
mandu.ate.auto_pipeline   ← parallel
mandu.guard.check         ← parallel
mandu.lint                ← parallel (신규)
mandu.doctor              ← parallel
```

### 4. 자동 수정
**절대 `oxlint --fix .` 를 무차별 실행하지 말 것.** 과거에 `.toSorted()` 변환으로 ES 타겟이 깨진 전례 있음 (`docs/tooling/oxc-lint-roadmap.md` §"1차 --fix 대참사").

안전한 자동 수정 절차:
1. 한 룰만 활성화한 임시 config 작성:
   ```bash
   cat > .oxlintrc.fix-type-imports.json <<'EOF'
   {
     "categories": { "correctness": "off" },
     "rules": { "typescript/consistent-type-imports": "warn" }
   }
   EOF
   ```
2. 해당 룰만 --fix:
   ```bash
   oxlint --config .oxlintrc.fix-type-imports.json --fix .
   ```
3. 즉시 typecheck + 테스트 검증
4. 커밋
5. 임시 config 삭제

### 5. Type-aware (선택)
```bash
bun add -D oxlint-tsgolint
bun x oxlint --type-aware .
# 또는
mandu guard --type-aware
```

Type-aware 룰이 잡는 것:
- `typescript/no-floating-promises` — await 누락
- `typescript/no-misused-promises` — Promise 를 boolean 자리에
- `typescript/strict-boolean-expressions` — nullish 체크 누락
- `typescript/preserve-caught-error` — `throw new Error("...", { cause })` 누락

## 표준 `.oxlintrc.json` (Mandu 템플릿 기준)

```json
{
  "categories": {
    "correctness": "error",
    "suspicious": "warn",
    "pedantic": "off",
    "style": "off",
    "perf": "off",
    "restriction": "off",
    "nursery": "off"
  },
  "rules": {
    "typescript/no-explicit-any": "error",
    "typescript/consistent-type-imports": "warn",
    "typescript/no-unused-vars": ["warn", { "argsIgnorePattern": "^_", "varsIgnorePattern": "^_" }],
    "no-debugger": "error"
  },
  "ignorePatterns": ["**/node_modules/**", "**/dist/**", "**/.mandu/**", "**/generated/**"],
  "overrides": [
    {
      "files": ["**/*.test.ts", "**/*.test.tsx", "**/*.spec.ts", "**/tests/**"],
      "rules": {
        "typescript/no-explicit-any": "off",
        "typescript/no-unused-vars": "off"
      }

From konamgil/mandu, MPL-2.0.

More from konamgil/mandu