규칙 대부분은 Incorrect와 Correct 예제만 보면 뜻이 전해진다.
그런데 산문이 예제가 이미 보여 주는 것을 다시 말하거나, 근거와 주의 사항을 백과사전처럼 늘어놓아 읽는 비용이 컸다.
예제 쪽은 반대로 너무 작거나 세계관에서 벗어나 실제 구현에 그대로 쓰기 어려운 것이 있었다.
그래서 세 가지를 한 번에 봤다.
산문을 예제가 보여 주지 못하는 것만 남기고 덜어낸다.
예제가 실제 구현에 쓸 만한지, 틀린 곳은 없는지, 세계관과 맞는지 본다.
규칙끼리 겹치거나 부딪히는 곳을 찾아 정리하거나 결정 대기로 남긴다.
산문 덜어내기
남기는 것과 지우는 것
남긴다
지운다
규칙 문장 한두 개와 판정 표, 흐름도
흐름도를 다시 말로 풀어 쓴 “차례로 보고 고릅니다” 문장
예제로는 알 수 없는 조건과 예외
왜 그런지 설명하는 근거 문장, 표준과 라이브러리 동작을 길게 옮긴 주의 사항
다른 규칙으로 넘기는 교차 참조 한 줄
“다른 규칙이 정하는 것” 표처럼 참조만 모은 표
두 주제 이상일 때의 ### 제목
주제 하나만 남은 뒤의 제목
문장 자체는 yoonmoon의 교정과 윤문 기준을 같이 적용했다.
합쇼체는 유지하고, 번역투와 피동, 상투어, 기계적인 나열은 고치되 뜻은 바꾸지 않았다.
Figma 스킬은 MCP 호출 순서처럼 코드 예제로 보여 줄 수 없는 절차가 많아 가장 적게 덜어냈다.
결과
스킬
규칙
지운 줄
더한 줄
커밋
typescript
42
283
45
2f7302fc
react
54
410
89
fd99492a
css
34
212
76
afbb4ab9
figma
16
58
33
ee3e198c
줄 수에는 생성물인 RULES_INDEX.md와 contracts/*.md도 들어 있다.
validate가 120칸 폭, 한 문장 문단, 라벨 어미를 그대로 막아 주어 덜어낸 뒤에도 형식은 유지됐다.
예제 점검
예제는 skill/examples.d.ts의 세계관(관리자 콘솔, Product, Order, 상태 draft, active, hidden)과
Correct 예제의 타입 검사, Incorrect 예제의 구문 검사를 기준으로 봤다.
고친 것
스킬
예제
무엇이 문제였나
어떻게 고쳤나
typescript
01-03
JSON.stringify로 만든 장난감 예제
toRoleLabel처럼 세계관의 값을 쓰는 예제로 교체
typescript
04-03, 05-03, 06-02
짝이 되는 Incorrect와 Correct가 서로 다른 필드와 상태를 씀
ownerId, cancelled, row.id로 맞춤
react
01-01 Incorrect 2, 3과 Correct 2, 3
props.children만 그려 레이어 판정의 근거인 “무엇을 아는가”가 코드에 없음
배지는 ProductStatus를 받아 수정자를 정하고, 그래프는 ChartPoint[]와 접근 가능한 이름만 받음
react
03-02
Correct가 03-03의 TableCell 예제와 같은 내용
버튼 래퍼로 바꿔 표시 프롭은 인덱스 접근, 자기 프롭은 직접 선언, 스타일 주입 지점은 닫는 모습을 보임
