Communitygithub.com

JahacksV1/day-one-agent-kit

아키텍처를 변경하지 않고 리포지토리를 이해합니다. 익숙하지 않은 리포지토리에서 작업을 시작하거나, 클라이언트 코드베이스를 온보딩하거나, 스택/프로필 기준선을 만들 때 사용하세요.

day-one-agent-kit란 무엇인가요?

이 스킬은 개발자가 익숙하지 않은 리포지토리를 빠르게 파악하고 분석할 수 있도록 도와줍니다. 코드 구조를 변경하거나 수정하지 않고, 프로젝트의 프레임워크, 언어, 패키지 관리자, 배포 대상을 감지합니다. 또한 프런트엔드, 백엔드, 데이터베이스, 인증, AI, 배포 영역을 매핑하고, 환경 변수 사용 패턴과 현재 아키텍처 패턴을 파악합니다. 최종적으로 `.ai/PROJECT_PROFILE.md` 파일을 생성하여 발견된 스택, 스크립트, 주요 영역, 패턴, 위험 요소 등 실행 가능한 리포지토리 프로필을 제공합니다. 이 스킬은 Claude Code, Cursor, Codex와 같은 AI 에이전트 플랫폼에서 사용할 수 있으며, 새로운 리포지토리에 투입되거나 클라이언트 코드를 검토할 때 생산성을 크게 향상시킵니다.

지원 대상~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/JahacksV1/day-one-agent-kit/tree/HEAD/skills/intake-repo

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

리포지토리 파악 (Intake Repo)

이 워크플로우를 사용하여 구현 전에 리포지토리를 빠르게 이해하세요.

목표

위험 요소와 다음 단계를 포함한 짧고 증거 기반의 리포지토리 프로필을 생성합니다.

결과물

  • templates/PROJECT_PROFILE.md를 사용하여 .ai/PROJECT_PROFILE.md 파일 생성.

규칙

  • 제품 코드를 편집하지 마십시오.
  • 아키텍처를 다시 작성하지 마십시오.
  • 가정보다는 관찰된 코드 패턴을 선호하십시오.
  • 프로필은 간결하고 실행 가능하도록 유지하십시오.
  • "해당 없음"은 주요 영역에 대한 유효하고 예상되는 답변입니다. 백엔드가 없는 정적/포트폴리오 사이트에는 인증, 데이터베이스 또는 AI 로직 항목이 없습니다. 내용을 지어내거나 미래의 필요를 추측하거나 비어 있거나 모호하게 남겨두지 말고 "해당 없음"으로 표시하십시오.

단계

  1. 프레임워크, 언어, 패키지 관리자 및 배포 대상을 감지합니다.
  2. 패키지/잠금/설정 파일 및 주요 진입점을 읽습니다.
  3. 사용 가능한 스크립트(dev, typecheck, lint, test, build)를 식별합니다.
  4. 프런트엔드, 백엔드, 데이터베이스, 인증, AI, 배포 영역을 매핑합니다.
  5. 환경 변수 사용 패턴을 식별합니다.
  6. 코드에서 사용되는 현재 아키텍처 패턴을 캡처합니다.
  7. 누락된 프로덕션 기본 사항 및 주요 위험 요소를 나열합니다.
  8. .ai/PROJECT_PROFILE.md를 생성하거나 업데이트합니다.

최소 증거

각 발견 사항에 대해 구체적인 파일을 인용하십시오. 예시 범주:

  • 스크립트 소스 (package.json, pyproject.toml 등)
  • 배포 소스 (vercel.json, Docker, CI 워크플로우)
  • env 사용 소스 (process.env, NEXT_PUBLIC_ 등)
  • 인증/데이터 경계 (미들웨어, 라우트 핸들러, 정책 파일)

완료 확인

  • 프로필에는 감지된 스택, 스크립트, 주요 영역, 패턴, 위험 요소가 포함되어야 합니다.
  • 출력물은 일반적인 코딩 작업 중에 유용할 수 있을 만큼 짧아야 합니다.

관련 스킬