sodalive-android/docs/plan-task/20260429_AGENTS정리.md

20260429 AGENTS 정리

개요

• AGENTS.md를 정비한 전체 작업 이력을 하나로 합친 문서다.
• 작업 범위는 다음 3단계였다.
  • oh-my-openagent, superpowers, andrej-karpathy-skills 통합
  • 우선순위 기준 재배치 및 중복 정리
  • 핵심 규칙 중심 경량화 및 세부 문서 분리
• 현재 기준의 관련 세부 문서는 아래와 같다.
  • docs/agent-guides/build-test-style.md
  • docs/agent-guides/workflow-docs-commits.md
  • docs/agent-guides/safety-repo-rules.md

작업 체크리스트

• 기존 AGENTS.md 구조와 중복 규칙을 분석한다.
• 공식 andrej-karpathy-skills 원문 CLAUDE.md를 확인하고 통합한다.
• 우선순위/충돌 해결/실행 모드 정책을 추가한다.
• 우선순위 기준으로 섹션을 재배치하고 중복 표현을 줄인다.
• AGENTS.md에는 핵심 규칙만 남기고 세부 규칙은 참조 문서로 분리한다.
• 관련 작업 문서를 하나로 통합하고 중복 문서를 정리한다.

결과 요약

1) 통합

• AGENTS.md에 CORE EXECUTION PRINCIPLES (andrej-karpathy-skills)를 공식 원문 그대로 포함했다.
• oh-my-openagent, superpowers, 프로젝트 지침 사이의 우선순위와 충돌 해결 규칙을 추가했다.

2) 재배치

• 우선순위가 높은 정책을 상단으로 이동했다.
• 충돌 해결 규칙은 실행 우선순위 및 통합 정책에 통합했다.
• 실행 모드/실행 계층/에이전트 동작 규칙은 하나의 묶음으로 정리했다.

3) 경량화

• AGENTS.md에는 핵심 원칙, 저장소 요약, 참조 문서 링크, 핵심 금지사항만 남겼다.
• 빌드/테스트/스타일, 작업 절차/커밋, 보안/저장소 세부 규칙은 docs/agent-guides/ 아래 별도 문서로 분리했다.

검증 기록

• 2026-04-29

  • 무엇/왜/어떻게: 기존 AGENTS.md의 구조와 중복 규칙을 먼저 확인한 뒤, 공식 andrej-karpathy-skills 원문을 raw URL에서 검증하고, 기존 유용한 규칙은 유지한 채 상단에 우선순위/통합 정책 섹션을 추가했다.
  • 실행 명령/도구:
    • read(AGENTS.md)
    • grep("oh-my-openagent|openagent|superpowers|andrej|karpathy|plugin|workflow|우선순위|priority", include="AGENTS.md")
    • webfetch("https://raw.githubusercontent.com/forrestchang/andrej-karpathy-skills/main/CLAUDE.md")
    • task(subagent_type="explore", run_in_background=true)
    • task(subagent_type="librarian", run_in_background=true)
    • apply_patch
  • 결과:
    • 기존 AGENTS.md에는 oh-my-openagent, superpowers, andrej-karpathy-skills 관련 명시 섹션이 없음을 확인했다.
    • 공식 raw CLAUDE.md 원문을 확인했고, 영문 본문은 변경 없이 CORE EXECUTION PRINCIPLES (andrej-karpathy-skills) 섹션에 삽입했다.
    • 우선순위 체계, oh-my-openagent 정책, superpowers 정책, 충돌 해결 규칙, 실행 모드를 한국어로 추가했다.

• 2026-04-29

  • 무엇/왜/어떻게: AGENTS.md를 읽고 배경 탐색 결과를 합쳐, 우선순위가 높은 정책을 앞에 배치하고 중복되던 충돌 규칙/실행 계층/에이전트 동작 문장을 상위 섹션으로 흡수하는 방향으로 재배치를 수행했다.
  • 실행 명령/도구:
    • read(AGENTS.md)
    • grep("^## |^### |추측하지 말고|요청 범위를 우선|최소 변경|검증 가능한 결과|commit-policy|한국어|oh-my-openagent|superpowers|CORE EXECUTION PRINCIPLES", include="AGENTS.md")
    • task(subagent_type="explore", run_in_background=true) x2
    • apply_patch
    • grep("^## |^### ", include="AGENTS.md")
  • 결과:
    • 실행 우선순위 및 통합 정책을 최상단으로 올리고 충돌 해결 규칙을 해당 섹션에 통합했다.
    • 실행 모드, oh-my-openagent 사용 정책, superpowers 사용 정책, 에이전트 동작 원칙을 실행 원칙 및 계층 사용 정책 아래로 묶었다.
    • 중복되던 문장을 줄이고 운영성 정보의 배치를 정리했다.

• 2026-04-29

  • 무엇/왜/어떻게: AGENTS.md는 핵심 정책만 남기고, 긴 운영 규칙은 별도 문서로 분리하기 위해 본문과 배경 탐색 결과를 합쳐 인라인 유지 항목과 분리 항목을 나눈 뒤, 3개 참조 문서와 링크 구조로 재구성했다.
  • 실행 명령/도구:
    • read(AGENTS.md)
    • grep("^## |^### ", include="AGENTS.md")
    • glob("docs/*.md")
    • task(subagent_type="explore", run_in_background=true) x2
    • apply_patch
    • read(수정된 AGENTS.md 및 분리 문서)
  • 결과:
    • AGENTS.md에는 우선순위, 커뮤니케이션, CORE EXECUTION PRINCIPLES, 실행 계층 정책, 저장소 요약, 참조 문서 링크, 핵심 금지사항만 남겼다.
    • 빌드/린트/테스트/스타일은 docs/agent-guides/build-test-style.md로 분리했다.
    • 작업 절차/docs/커밋 규칙은 docs/agent-guides/workflow-docs-commits.md로 분리했다.
    • 저장소 세부 규칙/보안/Git 안전 수칙은 docs/agent-guides/safety-repo-rules.md로 분리했다.

• 2026-04-29

  • 무엇/왜/어떻게: AGENTS.md 관련 작업 문서가 3개로 쪼개져 있어 관리 비용이 생겨, 같은 날의 연속 작업 이력을 하나의 문서로 합치고 중복 문서를 제거했다.
  • 실행 명령/도구:
    • read(docs/20260429_AGENTS통합정리.md)
    • read(docs/20260429_AGENTS재배치정리.md)
    • read(docs/20260429_AGENTS경량화정리.md)
    • apply_patch
  • 결과:
    • 세 문서의 개요/체크리스트/검증 기록을 하나의 이력 문서로 통합했다.
    • 중복되던 계획 생성 기록은 단일 문서 기준으로 정리했다.