MY-CODEX-OS-SPRING

Spring Boot를 위한 개인용 Codex 기반 AI 개발 운영체제입니다. AI에게 "코드만" 시키는 것이 아니라, 계획/검증/리뷰까지 포함한 작업 흐름을 강제해 일관된 품질과 추적 가능한 의사결정을 만드는 것이 목표입니다.

구조

• agents/: 계획, 코드리뷰, 보안리뷰 역할
• rules/: 코딩 스타일, 테스트, 보안, 아키텍처 규칙
• commands/: 계획, 구현, 검증, 코드리뷰 명령
• contexts/: 개발, 리뷰, 보안 모드 컨텍스트
• CODEX.md: 헌법(최상위 규칙)과 기본 워크플로우

기본 워크플로우

/plan -> /implement -> /verify -> /code-review

사용 방법

기본 흐름

1. /plan으로 요구사항 정리 및 계획 수립 (코드 변경 금지)
2. 승인 후 /implement로 코드 작성
3. /verify로 빌드/테스트 확인
4. /code-review로 품질/보안 리뷰

세부 규칙은 rules/, 명령 템플릿과 절차는 commands/를 참고한다. 중요 결정 기록은 docs/decisions/, CS 지식 요약은 docs/cs-notes/에 둔다.

입력 템플릿

/plan

요구사항:
배경:
제약:
완료 조건:
범위 제외:
결정 필요:

• 요구사항: 구현하려는 기능 1줄 요약
• 배경: 왜 필요한지, 현재 문제/배경
• 제약: 반드시 지켜야 할 제약 (기술, 정책, 성능 등)
• 완료 조건: 완료 조건을 구체적 체크리스트로
• 범위 제외: 이번 작업에서 하지 않을 것
• 결정 필요: 결정이 필요한 항목

/implement

기본 사용: /implement만 입력해도 된다. 이 경우 최근 승인 plan을 기준으로 진행한다.

계획 참조:
범위:
변경 파일:
추가/수정 테스트:
리스크:

• 범위: 이번 구현 범위와 제외 범위
• 변경 파일: 변경 예정 파일(가능하면 경로)
• 추가/수정 테스트: 추가/수정할 테스트(단위/슬라이스/통합)
• 리스크: 예상 리스크 또는 회귀 가능성
• 필요 시 핵심 CS/기술 개념을 간단 문서로 요약한다.

/verify

기본 사용: /verify만 입력해도 된다. 이 경우 quick 기준으로 현재 변경 범위를 검증한다.

빌드 도구: [gradle|maven|unknown]
검증 깊이: [quick|full]
메모:

• 빌드 도구: 빌드 도구
• 검증 깊이: 빠른 검증인지 전체 검증인지
• 메모: 특이사항 또는 확인 포인트

/code-review

기본 사용: /code-review만 입력해도 된다. 이 경우 현재 변경된 파일 기준으로 리뷰한다.

변경 요약:
변경 파일:
테스트 수행:
리스크 영역:

• 변경 요약: 변경 요약
• 변경 파일: 실제 변경 파일
• 테스트 수행: 실행한 테스트/커맨드
• 리스크 영역: 리뷰가 필요한 위험 지점

입력 예시

/plan 예시

요구사항: 도서 검색 결과에 페이지네이션 추가
배경: 검색 결과가 많아 스크롤이 길어짐
제약: 기존 검색 API 유지, UI는 Thymeleaf
완료 조건:
  - 페이지 번호 1~10 표시
  - 이전/다음 버튼 제공
  - 결과 0건이면 페이지네이션 미표시
범위 제외:
  - 무한 스크롤
결정 필요:
  - 페이지당 표시 개수 고정(10)?

/implement 예시

계획 참조: 2025-01-24 plan v1
범위: 검색 결과 페이지네이션 UI + 쿼리 파라미터 처리
변경 파일:
  - src/main/resources/templates/results.html
  - src/main/resources/static/css/styles.css
추가/수정 테스트:
  - BookViewControllerTest.search_renders_results_view
리스크:
  - 페이지 이동 시 station 파라미터 누락

/verify 예시

빌드 도구: gradle
검증 깊이: full
메모: UI 변경 반영 확인

/code-review 예시

변경 요약: 검색 결과 페이지네이션 추가
변경 파일:
  - src/main/resources/templates/results.html
  - src/main/resources/static/css/styles.css
테스트 수행:
  - ./gradlew test
리스크 영역:
  - 페이지 이동 시 station 파라미터 유지 여부