코딩 에이전트용 TypeScript 하네스 설계

코딩 에이전트 성능은 모델보다 하네스 설계에 좌우된다고 강조했다.

코드베이스를 에이전트용 실행 환경으로 보고, 빠른 검증과 좁은 영향 범위, 커밋 전 가드레일이 있어야 Claude Code나 Cursor가 유지보수 가능한 코드를 만든다고 본다.

pnpm 기반 monorepo로 apps/, packages/, docs/를 나누고, eslint-config, typescript-config, shared-utils, shared-types를 공통 패키지로 둔다.
각 앱은 공유 ESLint 설정을 import해 동일한 규칙을 적용한다.
.agents/skills에 공통 스킬을 두고 .codex, .claude는 symlink로 연결해 여러 에이전트가 같은 베스트 프랙티스를 쓰게 한다.
CLAUDE.md에는 아키텍처, Notion 문서 갱신 규칙, AI 코딩 규칙을 넣어 코드와 문서를 함께 관리한다.
nestjs-best-practices, typescript-advanced-types 같은 스킬을 참고해 팀 공용 규칙을 캡슐화하고, No casting, No narration comments, No single-use abstractions, No speculative error handling 같은 금지 규칙으로 슬롭을 줄인다.
24시간마다 GitHub Actions가 Claude Code를 돌려 dead code와 오래된 문서를 정리하고, CLAUDE.md도 최신 상태로 유지한다.