r3xsean/design-process

디자인 프로세스

사용자가 방향성과 취향을 결정합니다. 모델은 실행을 평가합니다: 작업 수행 가능 여부, 숫자의 정확성, 어떤 것이 깨지거나 숨겨지거나 오도되는지 여부를 판단합니다. 점수, 위원회 또는 모델 합의는 방향 간 선택, 병합, 또는 기록된 결정을 무효화하지 않습니다.

프로젝트에 자체 디자인 스킬이 있다면 이를 따르세요. 특정 단계에서 다시 이곳으로 안내할 수 있습니다.

프로젝트 파일

docs/design/ 디렉토리에 위치하며, 프로젝트의 AGENTS.md에서 다른 위치를 명시하지 않은 경우 다음 파일들을 포함합니다:

• product-brief.md: 제품의 진실. 사용자, 각 화면이 사용자에게 허용해야 하는 기능(주요 질문 및 모드: 운영, 읽기 또는 설득), 데이터 및 상태, 카피, 신뢰 경계. 프로젝트에 이미 PRODUCT.md가 있다면, 이 문서는 반복하지 않고 링크로 연결합니다.
• DESIGN.md: 사용자의 결정, 예외, 승인된 참조 화면 및 반응 로그. 기록된 결정은 사용자의 선호를 우선시합니다. 기록이 없으면 디자인은 열려 있습니다. 현재 UI는 증거일 뿐 결정이 아닙니다.
• harness.md: 화면과 프로토타입이 실행되고 캡처되는 방법: 명령어, 시나리오, 뷰포트, 경쟁 앱, 캡처 저장 위치.
• runs/<YYYY-MM-DD-name>/run.md: 각 실행의 질문, 고정 및 미해결 사항, 알려진 제한 사항, 위원회 구성원 및 대상, 입장 키, 결과.

네 파일의 템플릿은 templates/ 디렉토리에 있습니다. 처음 세 파일 중 하나라도 누락된 경우 먼저 부트스트랩(bootstrap)하세요. 부트스트랩을 건너뛰는 실행을 포함하여 모든 실행은 자체 run.md를 시작합니다. 캡처, 매니페스트, 발견 사항 원장 및 변형 시트는 harness.md에서 지정한 gitignored 폴더에 저장됩니다. 위원회 패키지는 저장소 외부, 세션의 스크래치패드 또는 임시 폴더에 보관합니다.

프로젝트 자체 규칙이 이 스킬보다 우선합니다: AGENTS.md의 종속성, 개발 서버 및 커밋 대상에 관한 규칙을 따르세요. 실행 시 이러한 규칙이 금지하거나 논의를 위해 보류한 사항이 필요하면 사용자에게 먼저 문의하세요.

흐름

• 새로운 UI: 부트스트랩 → 탐색 → 사용자 선택 → 개선 → 위원회 → 참조 승인 → 홀드아웃 → 프로젝트 롤아웃 경로를 통해 출시.
• 기존 UI: 부트스트랩 → 위원회 → 승인 → 출시. 사용자가 먼저 가시적 변경을 원하는 경우, 위원회 전에 개선 단계를 진행합니다.

요청된 단계에서 진입합니다. 사소한 조정은 개선 단계에서 진입합니다.

단계	먼저 읽을 문서
부트스트랩	references/bootstrap.md, 그 다음 실행에 필요한 각 기능에 대해 references/harness-contract.md
탐색	references/explore.md
개선	references/refine.md, 그리고 첫 UI 편집 전에 references/craft.md
위원회	references/council.md
다른 디자인 스킬 사용	references/integrations.md, 호출 전에

위원회 구성원. 실행이 위원회 단계에 도달할 경우, 시작 시 사용자에게 구성원(각 구성원의 모델 및 추론 노력)을 묻습니다. 단, 사용자가 이미 지정하지 않은 경우에 한합니다. 서로 다른 제공업체의 구성원을 제안하세요. 구성원을 run.md에 기록하고 전체 실행 동안 정확히 그 구성원을 사용하세요. 구성원을 사용할 수 없는 경우 그렇게 알리고 대체하지 마세요.

참조 승인. 오직 사용자의 말만이 화면을 승인합니다. 점수는 절대 승인을 대체할 수 없습니다. 캡처를 docs/design/references/로 복사하고 DESIGN.md의 참조 화면 아래에 나열하여 각각이 무엇에 대한 참조인지 명시하세요.

홀드아웃. 첫 번째 승인된 참조 이후, 새로운 에이전트가 아직 디자인되지 않은 화면을 이 스킬, 프로젝트 파일 및 harness만을 사용하여 디자인하고 추측해야 했던 모든 지점을 나열합니다. 결과를 사용자에게 보여줍니다. 각 추측 사항을 답변해야 하는 파일에 수정하거나 run.md에 미해결로 기록하세요. 사용자가 반응하고 모든 추측이 수정되거나 기록될 때까지 완료되지 않습니다.

반응 기록

사용자가 어떤 단계에서든 디자인에 반응할 때마다:

1. DESIGN.md의 반응 로그에 반응당 한 행을 추가합니다: 날짜(UTC), 화면 및 뷰포트, 디자인 및 캡처 실행, 사용자의 말을 정확히 인용, 유형, 범위, 상태 observed.
   • 유형: like(유지), dislike(변경) 또는 defect(작업 실패 또는 무언가 고장; 발견 사항 원장에도 추가). 하나의 반응이 한 부분을 좋아하고 다른 부분을 싫어할 수 있습니다. 각 부분을 지정하세요. 아직 구축되지 않은 기능은 반응이 아닙니다. run.md의 알려진 제한 사항 아래에 나열하세요.
   • 범위는 사용자가 명시한 것: 이 요소, 이 화면 유형 또는 사이트 전체. 명시하지 않은 경우 요소로 간주합니다. 스스로 범위를 확장하지 마세요.
   • 응답으로 변경한 내용은 발견 사항 원장에 기록하고 행에는 기록하지 않습니다.
2. 사용자가 일반적으로 명시할 때 행을 결정(Decisions)으로 승격합니다. 동일한 반응이 두 번째 화면에서 재발생하면 일반적으로 적용되는지 묻고 '예'일 때만 승격합니다. 행에 promoted로 표시하고 링크를 추가합니다.
3. 반응이 결정과 모순될 때 어느 것이 승리하는지 묻고, 이전 결정을 편집하거나 제거하고 패배한 행에 superseded로 표시합니다.

모든 반응에 행이 있고 모든 승격이 사용자의 일반적인 진술 또는 '예'를 인용할 때까지 완료되지 않습니다.

개인정보 보호

캡처는 픽스처 데이터, 시드 데이터 또는 데모 계정을 사용하며, 사용자의 실제 계정이나 실제 인물의 기록은 절대 사용하지 않습니다. 개인 데이터나 성인 콘텐츠를 표시하는 것은 위원회 패키지, 참조 캡처 또는 커밋에 포함되지 않습니다.