공학 철학
현재 작업에 필요한 분야를 선택하세요. 이 스킬은 라우팅 가이드이며, 모든 항목을 체크하는 목록이 아닙니다. 여러 분야가 함께 적용되더라도 책임은 분리하여 유지하세요.
권한과 범위
활성 에이전트와 작업이 권한, 범위, Git 정책, 위임 및 출력 형식을 정의합니다. 이 스킬이나 이 스킬이 참조하는 문서는 그 권한을 확장하지 않습니다.
구현 안내를 읽는다고 해서 편집, 테스트, 커밋 또는 게시가 허가되는 것은 아닙니다. 읽기 전용 리뷰는 읽기 전용 상태를 유지합니다. 리서치나 문서 작성 작업이 구현 작업으로 바뀌지 않습니다. 스타일 기본값보다 프로젝트 계약을 먼저 적용하세요. 이 원칙들은 관련 없는 작업을 허가하지 않습니다.
참조 문서 선택 및 읽기
- 현재 활동과 영향을 받는 동작을 식별하세요.
- 활성 에이전트가 명시적으로 요구하는 참조 문서를 포함하세요.
- 아래 표의 조건이 적용되는 경우 추가 참조 문서를 선택하세요.
- 해당 작업을 수행하기 전에 선택한 각 참조 문서를 읽으세요. 단순히 로드되었다고 이름만 언급하지 마세요.
- 작업이 변경되면 선택을 재고하세요. 이미 읽은 참조 문서의 내용이 변경되지 않았다면 재사용하세요.
아래 모든 경로는 engineering-philosophy 스킬 디렉터리를 기준으로 한 상대 경로입니다.
생성된 지침 복사본은 해당 기본 디렉터리를 변경하지 않습니다.
이것들은 참조 파일이며, 독립적으로 로드 가능한 스킬이 아닙니다.
필요에 따라 여러 참조 문서를 로드하되, 일곱 개 모두를 자동으로 로드하지 마세요. 참조 문서는 다른 분야로 연결될 수 있지만, 모든 작업에 해당 분야가 필요한 것은 아닙니다. 링크가 존재한다는 이유만으로 해당 지침이 필요하지는 않으며, 필요할 때만 연결된 참조 문서를 읽으세요.
작업 수행 방법
| 분야 | 언제 읽을 것인가 | 참조 문서 |
|---|---|---|
| 구현(Implementation) | 소프트웨어 변경(설정 및 에이전트 지침 포함)을 구현하거나 검증할 때 | Implementation |
| 리뷰(Review) | 코드, 패치, 파일 또는 이전 결과를 리뷰할 때 | Review |
| 리서치(Research) | 외부 사실, API 동작, 호환성 또는 기술 선택 사항을 해결할 때 | Research |
| 문서 작성(Writing) | 지속적인 기술 산문 또는 에이전트 대상 지침을 작성하거나 수정할 때 | Writing |
결과가 충족해야 할 사항
| 분야 | 언제 읽을 것인가 | 참조 문서 |
|---|---|---|
| 코드(Code) | 로직, 변환, 유효성 검사, 상태 전이 또는 오류 경로를 구현하거나 검사할 때 | Code |
| 아키텍처(Architecture) | 경계, 소유권, 의존성, 인터페이스 또는 컴포넌트 간 영향을 설계하거나 검사할 때 | Architecture |
| 프론트엔드(Frontend) | UI, 스타일링, 접근성, 상호작용 또는 반응형 동작을 설계하거나 검사할 때 | Frontend |
활동 분야와 결과 분야는 결합됩니다. 예를 들어, UI 구현은 구현(Implementation), 코드(Code), 프론트엔드(Frontend)가 필요할 수 있습니다. 코드 리뷰는 리뷰(Review)와 관련 결과 분야를 사용하되, 구현 책임을 상속하지 않습니다. 문서 전용 작업은 문서 작성(Writing)만 사용하고 코드(Code)나 프론트엔드(Frontend)는 로드하지 않을 수 있습니다.
소유권 및 보고
각 참조 문서는 해당 분야를 단독으로 소유합니다. 이 진입점이나 에이전트 정의에 그 규칙을 중복해서 작성하지 마세요.
code-review는 리뷰 절차, 심각도 임계값, 평결 및 보고서 형식을 별도로 소유합니다.
asd-ste100은 별도로 유지되며, 해당 통제 언어 규칙을 소유합니다.
실제로 읽은 참조 문서의 원칙만 사용하세요. 기본적으로 일곱 분야 전체 규정 준수 보고서를 생성하지 마세요. 활성 에이전트의 보고서 형식을 따르세요. 관찰된 증거, 제공된 결과, 검증되지 않은 가정을 구분하세요. 필요한 참조 문서를 사용할 수 없는 경우, 해당 문서의 이름을 명시하고 결과적인 제한 사항을 설명하세요. 읽지 않은 지침을 적용했다고 주장하지 마세요.