Skip to content

Latest commit

 

History

History
34 lines (25 loc) · 6.72 KB

agent.md

File metadata and controls

34 lines (25 loc) · 6.72 KB

한모 에이전트 운영 규칙

설계 문서 및 작업 방식

  • docs/architecture.md는 항상 현행 제품·기술 설계의 기준 문서입니다. 오래된 설계, 회의 기록, 커밋 이력을 누적하지 않고 관련 조항·구성도·완료 게이트를 한 번에 교체해 일관성을 유지합니다.
  • 확정된 설계 문서 변경은 별도 문서 PR 없이 main의 docs/architecture.md에 직접 커밋합니다. 단, 이 원칙은 기능 코드의 PR·리뷰·권한·원개발자 승인 절차를 우회하지 않습니다.
  • 아직 결정되지 않은 부분은 docs/architecture.md 하단 미결 사항에 현재 상태와 관련 GitHub Issue를 연결합니다. 세부 논의·검증 과제·완료 조건은 작은 단위의 Issue에 적습니다. 결정되면 현재 설계 본문을 수정하고 미결 목록을 정리합니다.
  • README.md는 짧은 소개·단계·책임·설계 링크로, AGENTS.md는 이 규칙으로 진입시키는 안내로 유지합니다. 서로 다른 개발 단계·언어·운영 책임을 설명하지 않도록 동기화합니다.

GitHub 이슈 작성과 분류

  • 생성 전에 열린 이슈와 현행 설계를 확인합니다. 설계 결정을 기록하는 이슈, 기능을 구현하는 이슈, 검증을 실행하는 이슈는 목적과 완료 조건을 구분합니다. 관련 작업이 이미 있으면 해당 이슈를 보완합니다.
  • 제목은 [설계|구현|검증][차수][P0|P1|P2][담당 영역(선택)] 작업 요약 형식으로 씁니다. 예를 들어 [구현][1차][P0][NLP] 한국어 FAQ 검색 연결입니다. 차수는 1차부터 4차 또는 공통을 사용하며 여러 차수에 걸치면 [1·2차]처럼 적습니다.
  • P0는 해당 차수의 필수 기능·병합·인수를 막는 작업, P1은 해당 차수의 기능 완성·품질 확보에 필요한 작업, P2는 선택 확장이나 후속 차수에서 처리할 작업입니다. 후속 차수라도 그 차수의 진행을 실제로 막으면 P0로 분류합니다.
  • 본문에는 목적과 범위, 설계 조항·관련 이슈, 선행 작업과 착수 조건, 검증할 수 있는 완료 조건, 실무 담당자를 적습니다. 배정 가능한 경우 GitHub 담당자 필드에도 등록하고, 초대 대기 등으로 등록할 수 없으면 본문에 계정을 남깁니다.
  • Issue labels 워크플로가 이슈 생성·재개·제목 수정 시 차수:*, 우선순위:*, 유형:*를 제목에 맞춥니다. 분류를 바꾸려면 제목의 태그를 수정합니다. 태그가 없거나 우선순위·유형이 충돌하면 해당 분류를 유지합니다. 전체 열린 이슈는 Actions에서 워크플로를 수동 실행해 동기화할 수 있습니다.
  • enhancement는 기능 개선 요청을 구별할 때만 사용합니다. 설계 이슈, 구현 작업, 검증 이슈에는 제목과 자동 유형 라벨을 기본으로 사용합니다. bug, documentation, accessibility 등은 내용에 해당할 때 별도로 붙입니다.

제품 개발의 네 단계

  1. 1단계 (통합 학업 플랫폼): js/academic/에 TypeScript 계산 코어, html/에 정적 학업 화면, css/에 스타일을 둡니다. TypeScript는 배포 시 JavaScript로 빌드합니다. 원본 한국외대 수강신청 모방 화면 html/practice.html, html/selectZone.html과 원래 동작·PC-only/CNAME을 보호합니다. 학생용 화면과 홈은 승인된 변경 범위 안에서 수정할 수 있습니다.
  2. 2단계 (기존 모의수강신청 시나리오): 원개발자가 원본 모방 화면을 직접 제작했으며, 필요한 selectZone 확장은 가능하다는 답변을 사용자로부터 전달받았습니다. 다만 기본 SELECT 버튼의 대기 번호 창과 Enter 연타 시 기존 ‘수강신청하시겠습니까?’ 안내 반복 및 BASIC/TIME/SELECT 조작을 원본 대비 회귀 검사합니다. 현행 필수 범위는 가상 신청 실패 후 상태 확인과 가상 404·재접속 복귀입니다. 실제 대체과목 검색·추천·시간 충돌 검증은 자료 접근·사용권·검수·기기 QA 확보까지 보류하며, 현행 합성 데모의 존재가 개발 완료 또는 운영 공개를 뜻하지 않습니다. 기존 JavaScript·HTML/CSS와 기본 OFF 흐름을 보존합니다.
  3. 3단계 (Supabase): 원개발자가 Supabase 사용을 허용한다고 답변한 사실을 사용자로부터 전달받았습니다. 그러나 이는 계정·비밀키·실제 데이터 사용권·운영 배포 권한의 자동 위임이 아닙니다. 1차 TypeScript와 2차 JavaScript를 병행하고, 우리 팀은 DB·수집/갱신·독립 검수·API·보안·운영 설계와 인계를 담당합니다. Supabase Free($0) 실제 프로젝트의 소유·비용·관리 및 실연동은 임창용 님과 협의한 승인 운영 책임자가 수행합니다. DB/API 실연동·보안·브라우저 인수 없이 4단계에 진입하지 않습니다.
  4. 4단계 (JavaScript 소스 통일): 3단계 Supabase 실연동과 전체 제품 안정화가 확인된 뒤 1단계 TypeScript 원본 및 테스트를 JavaScript + JSDoc/checkJs 등 정적 검사로 점진 전환합니다. 이전 TypeScript 코어와 계산 결과·예외·출처 상태를 비교 검증하며 기존 JavaScript와 Supabase 데이터 계약을 유지합니다. 생성된 JavaScript 번들 파일을 직접 수정하지 않습니다.

1·2단계는 외부 DB 없이 실행·검증 가능해야 합니다. 고용·취업·진로·채용·NCS는 범위에서 제외합니다.

신뢰·권리·검증·배포 경계

  • 기능 명세/소스 보존/계산 코어/시제품/공식 자료 검수/운영 배포 완료는 구별합니다. 미확정 학칙·강의·공지와 사용자의 자체 SOURCE_REVIEWED 선언을 운영 승인으로 간주하지 않습니다.
  • 합성 수강신청 결과를 실제 학점·신청 이력에 합치지 않습니다. 브라우저에 저장된 학생 성적이나 식별정보를 공개 저장소·원격 서비스에 무단 전송하지 않습니다.
  • 원본 한모 GPL-3.0과 이식 소스의 재배포 권리 및 학사자료 이용 권한을 공개 병합·배포 전에 확인합니다. React/Fastify 참조 소스와 불필요한 아카이브를 운영 번들로 자동 포함하지 않습니다.
  • PR 생성은 병합 승인이 아닙니다. 원개발자와 협의되지 않은 기존 한모 파일 수정, 운영 도메인 배포, Supabase 프로젝트 개설·운영을 임의로 하지 않습니다.
  • 1단계 TS 타입 검사·정적 빌드·학사 계산/브라우저 QA, 2단계 순수 JS 동작·기존 BASIC/TIME/SELECT 회귀, 3단계 권한/데이터/장애 대체 실연동, 4단계 TS↔JS 동등성 검사를 각각의 승인 게이트로 둡니다.