30 lines
3.9 KiB
Markdown
30 lines
3.9 KiB
Markdown
# 에이전트 가이드 통합 정리 계획
|
|
|
|
## 목표
|
|
- 기존 `AGENTS.md`의 유용한 규칙을 유지하면서 `oh-my-openagent`, `superpowers`, `andrej-karpathy-skills`가 충돌 없이 함께 동작하도록 우선순위와 실행 정책을 정리한다.
|
|
- `andrej-karpathy-skills` 원문은 공식 저장소의 `CLAUDE.md`에서 가져와 영어 원문을 유지한다.
|
|
- 핵심 내용만 `AGENTS.md`에 남기고 상세 규칙은 `docs/agent-guides/` 문서로 분리한다.
|
|
|
|
## 작업 항목
|
|
- [x] 기존 `AGENTS.md` 구조와 중복 가능성 분석
|
|
- [x] `andrej-karpathy-skills` 공식 원문 확인 및 반영
|
|
- [x] 지시 우선순위, 충돌 해결, 실행 모드 정책 정리
|
|
- [x] `oh-my-openagent` 및 `superpowers` 사용 정책 추가
|
|
- [x] 상세 가이드를 `docs/agent-guides/` 문서로 분리
|
|
- [x] 변경 내용 검증 및 검증 기록 누적
|
|
- [x] 빌드/테스트/검증 문서와 코드 스타일 가이드 문서 분리
|
|
- [x] `AGENTS.md`의 문서 관련 규칙을 별도 문서로 분리
|
|
- [x] 후속 분리 변경 내용 검증 및 검증 기록 누적
|
|
|
|
## 검증 기록
|
|
- 2026-05-15: `https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md`를 `webfetch`로 확인해 `CORE EXECUTION PRINCIPLES (andrej-karpathy-skills)` 섹션에 영어 원문을 반영했다.
|
|
- 2026-05-15: `git diff -- AGENTS.md docs/agent-guides/agent-execution-policy.md docs/agent-guides/sodalive-ios-development.md docs/plan-task/20260515_에이전트가이드통합정리.md`로 변경 범위를 확인했다.
|
|
- 2026-05-15: `rg -n "CORE EXECUTION PRINCIPLES|oh-my-openagent|superpowers|andrej-karpathy-skills|docs/agent-guides" AGENTS.md docs/agent-guides docs/plan-task/20260515_에이전트가이드통합정리.md`로 필수 정책 문구와 참조 경로가 포함되어 있는지 확인했다.
|
|
- 2026-05-15: `git diff --check -- AGENTS.md docs/agent-guides/agent-execution-policy.md docs/agent-guides/sodalive-ios-development.md docs/plan-task/20260515_에이전트가이드통합정리.md` 실행 결과 출력 없이 종료되어 공백 오류가 없음을 확인했다.
|
|
- 2026-05-15: `lsp_diagnostics`로 `AGENTS.md`, `docs/agent-guides/agent-execution-policy.md`, `docs/agent-guides/sodalive-ios-development.md`, `docs/plan-task/20260515_에이전트가이드통합정리.md`를 확인했고 진단 결과는 모두 `No diagnostics found`였다.
|
|
- 2026-05-15: `sodalive-ios-development.md`에서 빌드/테스트/검증과 코드 스타일 내용을 분리해 각각 `docs/agent-guides/build-test-verification.md`, `docs/agent-guides/code-style.md`로 이동하고, 기존 문서는 색인과 Cursor/Copilot 규칙 중심으로 축소했다.
|
|
- 2026-05-15: `AGENTS.md`의 작업 계획 문서 규칙과 문서 유지보수 규칙을 `docs/agent-guides/documentation-policy.md`로 분리하고, `AGENTS.md`에는 참조 경로만 남겼다.
|
|
- 2026-05-15: `git diff --check -- AGENTS.md docs/agent-guides/agent-execution-policy.md docs/agent-guides/sodalive-ios-development.md docs/agent-guides/build-test-verification.md docs/agent-guides/code-style.md docs/agent-guides/documentation-policy.md docs/plan-task/20260515_에이전트가이드통합정리.md` 실행 결과 출력 없이 종료되어 공백 오류가 없음을 확인했다.
|
|
- 2026-05-15: `rg -n "build-test-verification|code-style|documentation-policy|sodalive-ios-development|\[ \]" AGENTS.md docs/agent-guides docs/plan-task/20260515_에이전트가이드통합정리.md`로 새 참조 경로와 체크리스트 상태를 확인했다.
|
|
- 2026-05-15: `lsp_diagnostics`로 `AGENTS.md`, `docs/agent-guides/agent-execution-policy.md`, `docs/agent-guides/sodalive-ios-development.md`, `docs/agent-guides/build-test-verification.md`, `docs/agent-guides/code-style.md`, `docs/agent-guides/documentation-policy.md`, `docs/plan-task/20260515_에이전트가이드통합정리.md`를 확인했고 진단 결과는 모두 `No diagnostics found`였다.
|