활성화 계약
터미널 인터페이스(패널, 레일, 상태 표시줄, 카드, 프롬프트), 특히 Gentle Shell을 디자인, 검토 또는 개선할 때 사용합니다. 목표 느낌은 터미널 안의 IDE: 밀도 높고, 차분하며, 개발자 중심이고, 레트로 TUI 껍질이 아닙니다. 웹 페이지에는 사용하지 마십시오 (gentle-design 사용).
엄격한 규칙
- 코드나 기억만으로 터미널 UI를 판단하지 마십시오. 캡처하여(
references/visual-loop.md) 변경 전후에 PNG를 확인하십시오. - UI를 편집하기 전에 반드시
references/terminal-craft.md를 읽으십시오. 이는 제안이 아닌 기준입니다. - 작동 모드: 친숙함이 표현보다 우선합니다. IDE 용어(창, 트리, 탭, 상태 표시줄, 명령 팔레트)를 사용하십시오. 브랜드는 팔레트, 밀도, 하나의 시그니처 동작에 담깁니다.
- 모든 행은 비용이 듭니다. 계층은 색상 역할, 굵기 및 정렬에서 비롯되며, 빈 행이나 중첩된 상자에서 비롯되지 않습니다.
- 한 화면에 각 사실을 한 번만 말하십시오. 헤더에 표시된 데이터는 패널에서 반복되지 않습니다.
- 하나의 명령, 하나의 대상. 개선은 시스템을 보존하고, 재설계는 시스템을 대체합니다. 버려질 모양을 다듬지 마십시오.
- 렌더링은 가벼워야 합니다. 렌더링 경로에 I/O나 재계산이 없어야 하며, 출력(스타일, 너비, 테마)을 변경하는 모든 것에 키가 지정된 캐시를 사용하십시오.
- 목업(
gentle-design사용)은 터미널에서 표현 가능해야 합니다.ch단위의 모노스페이스 셀 그리드, 전경/배경 색상만 사용, 굵게/희미하게/기울임/밑줄/취소선, 상자 그리기 및 글리프.
결정 게이트
| 질문 | 명령어 | 로드 |
|---|---|---|
| 아직 제품/디자인 맥락 없음 | document | references/design-doc.md |
| 새 표면 또는 재설계 | shape, 그 다음 목업, 그 다음 구현 | references/commands.md |
| "어떻게 보이나요 / 무엇이 잘못되었나요" | critique | references/critique.md |
| 너무 복잡함, 공간 낭비, 중복 | distill / layout / quieter | references/commands.md |
| 평평함, 계층 없음, 읽기 어려움 | typeset / colorize / bolder | references/commands.md |
| 엣지 케이스, 좁은 터미널, 긴 텍스트 | harden / adapt | references/commands.md |
| 커밋 전 최종 점검 | polish | references/commands.md |
실행 단계
- 프로젝트에
DESIGN.md가 있으면 로드하고, 없으면 먼저document를 제안합니다. - 출하된 크기(넓음 180x50, 중단점 140, 좁음 80x24)에서 비주얼 루프로 현재 상태를 캡처합니다.
- 선택한 명령을 하나의 명명된 대상에 대해 실행합니다. 코드를 변경하기 전에 결과를 기록합니다.
- 변경, 재캡처, 이전 PNG 및 브리핑과 비교합니다. 최대 3회 반복한 후 보고합니다.
- 모든 개선 명령을
polish검사와 저장소의 집중 테스트(렌더링 횟수, 오버플로)로 끝냅니다.
출력 계약
반환: 대상, 실행된 명령, 이전/이후 PNG 경로, P0-P3 태그로 수정된 발견 사항, 열린 상태로 남은 발견 사항, 실행된 검사.
참조
references/terminal-craft.md: 기본 규칙 및 터미널 안티 패턴.references/commands.md: 터미널에 맞게 조정된 명령 플레이북.references/critique.md: 점수 매겨진 비평 및 심각성 루브릭.references/design-doc.md: 터미널 제품에 대한DESIGN.md템플릿.references/visual-loop.md: 스크린샷 도구 및 비교 루프.NOTICE.md: 귀속 정보.