Skip to content

dx: CROCO_* 진단 코드와 수정 예시를 표준화한다 #871

Description

@kang-heewon

배경

빌드타임 에러가 있어도 메시지가 불안정하거나 원인이 모호하면 사람과 LLM 모두 수정하기 어렵다. Croco에는 안정적인 진단 코드, 원인 설명, 수정 예시가 필요하다.

제안

CROCO_DI_001, CROCO_ROUTE_004 같은 diagnostic code 체계를 정의하고, check/build/runtime error 메시지가 같은 형식을 따르도록 한다.

범위

  • diagnostic code naming convention
  • severity, category, source location 모델
  • short cause와 fix example 템플릿
  • docs link 또는 search keyword 전략

의존성

없음. Doctor, static misuse detector, manifest generation이 이 형식을 소비할 수 있다.

완료 조건

  • 최소 3개 category의 diagnostic code 예시가 정의된다.
  • 메시지가 원인과 복구 액션을 포함한다.
  • 코드가 안정적으로 유지될 수 있도록 변경 정책이 문서화된다.

Metadata

Metadata

Assignees

Labels

P2Priority 2 issuebuild-timeBuild-time validation, linting, and generated checksdeveloper-experienceDeveloper ergonomics and local workflow improvementsenhancementNew feature or requestllm-friendlyArchitecture and diagnostics designed for LLM-assisted development

Type

No type

Projects

No projects

Milestone

No milestone

Relationships

None yet

Development

No branches or pull requests

Issue actions