개인 프로젝트를 진행하다 보면 코드를 작성하는 시간만큼 “어떤 커밋이 추가됐는지 확인하고 변경사항을 다시 읽는 시간”도 많이 듭니다. GitHub의 diff를 복사해 AI에게 질문하는 방법도 있지만, 저장소를 열고 커밋을 찾고 내용을 전달하는 작업을 매번 반복해야 했습니다.이 과정을 자동화하기 위해 ASP.NET Core 10과 Blazor로 **BranchReview**를 만들었습니다. BranchReview는 사용자가 지정한 GitHub 브랜치의 새 커밋을 확인하고, Gemini 또는 OpenAI로 변경사항을 검토한 뒤 커밋별 리포트로 저장하는 개인용 AI 코드 리뷰 에이전트입니다.전체 동작 흐름사용자는 먼저 GitHub 저장소와 관리할 브랜치를 등록합니다. 서버는 기본적으로 5분마다 브랜치의 최신 ..

오늘은 새로운 개념을 공부하기보다, AI 코딩 에이전트를 실제 프로젝트에서 오래 사용할 때 필요한 운영 방법에 대해서 정리해보겠습니다.AI가 코드를 잘 작성하는 것도 중요하지만 프로젝트가 커질수록 Context 관리, 검증 방법, 세션 관리와 같이 AI가 일할 환경을 만드는 것도 중요해집니다.AGENTS.md에 모든 내용을 넣으면 안된다이 부분은 전에 공부했던 레포지토리에서 적용하고 있던 내용과 비슷한 것 같습니다.AI를 사용할 때 AGENTS.md에는 프로젝트를 작업하면서 AI가 반드시 알아야 하는 규칙을 작성할 수 있습니다.하지만 모든 설계와 규칙을 AGENTS.md 하나에 계속 추가하면 파일 자체가 너무 커지게 됩니다. 그러므로 각 부분의 세뷰 규칙들은 따로 md 파일을 만들어 정리하고, AGENT..

오늘은 AI 잘 활용하는 프로젝트는 AI를 어떻게 활용하고 있는지에 대해 공부해보겠습니다. 지금까지는 프롬프트와 스킬 사용 위주로 알아보았지만 이번엔 AI가 읽을 문서를 잘 설계한 프로젝트는 어떤 구조인지 알아보겠습니다.참고해볼 프로젝트는 학교 선배님이 만드신 프로젝트인 https://github.com/nyxways/mediaway 입니다.AGENTS.mdMediaway의 AGENTS.md는 AI가 항상 지켜야 할 핵심 규칙과 세부 문서의 위치를 안내하는 기준 문서로 구성되어 있었습니다. 내용은 크게 다음 순서로 정리되어 있습니다.프로젝트 환경과 핵심 설계 방향사용자 대화와 저장소 문서의 언어 규칙작업 전에 읽어야 할 Wiki와 문서 순서라이선스·보안·코드 안전에 관한 절대 규칙프로젝트 구조와 API..

오늘은 AI가 단순히 답변만 생성하는 것이 아니라, 외부 함수나 도구를 직접 사용할 수 있게 해주는 Tool Calling에 대해서 공부해보겠습니다. 지금까지는 Prompt, Context, RAG처럼 AI에게 어떤 정보를 주고 어떤 방식으로 작업하게 할지에 대해 공부했습니다.Tool Calling은 여기서 한 단계 더 나아가서, AI가 실제 프로그램의 기능을 사용할 수 있게 만들어주는 방식입니다.Tool Calling이란?Tool Calling은 AI가 사용자의 요청을 보고 필요한 경우 미리 등록된 함수나 도구를 선택해서 호출하는 방식입니다.예를 들어 사용자가오늘 서울 날씨 알려줘라고 물어봤다고 하겠습니다. LLM 자체는 실시간 날씨 정보를 가지고 있지 않을 수 있습니다. 이때 날씨를 조회하는 Tool..

오늘은 AI 모델 하나가 모든 작업을 처리하는 방식이 아니라, 여러 AI 모델에 역할을 나눠서 사용하는 방식에 대해서 알아보았습니다.찾아보다가 Astra가 전체적인 계획과 검토를 맡고, Luna가 실제 코드 작성이나 테스트를 맡는 구조를 보게 되었는데 꽤 흥미로웠습니다.Planner / Executor 구조이 방식은 간단히 말하면 생각하는 역할과 실행하는 역할을 나누는 구조입니다.예를 들어Astra에게 전체 작업에 대한 계획을 맡기고Luna가 코드 탐색, 작성, 테스트를 하며Astra가 결과를 검토하고 최종 판단을 하는 구조 처럼 사용할수 있습니다. Astra는 단순히 생각만 하는 것이 아니라 작업을 분해하고, 서브 에이전트들에게 일을 맡기고, 마지막 결과를 다시 검토하는 역할에 가깝습니다.왜 역할을 ..

오늘은 AI를 사용할때 필요한 정보를 자동으로 찾아서 넣어주는 RAG에 대해서 공부해보겠습니다.이전에 Context에 대해서 공부하면서 AI에게 어떤 정보를 주는지가 중요하다고 했습니다.하지만 프로젝트가 커지면 매번 관련된 파일이나 문서를 직접 찾아서 AI에게 넣어주는 것도 일이 됩니다.이런 문제를 해결하기 위해 사용하는 방식 중 하나가 RAG입니다.RAGRAG는 Retrieval-Augmented Generation의 약자로, 한국어로는 검색 증강 생성이라고 부릅니다.쉽게 말하면 AI가 답변하기 전에 질문과 관련된 정보를 먼저 검색하고, 그 내용을 Context에 넣어서 답변을 생성하는 방식입니다.일반적으로 AI에게 질문하면 아래와 같은 흐름으로 답변을 만듭니다.사용자 질문 ↓LLM ↓답변R..

오늘은 어제 공부한 Skills를 졸업작품 프로젝트에서 실제로 어떻게 활용했는지 정리해보겠습니다.Sequence.md, Context.md먼저 프로젝트의 Context를 AI가 계속 이해할 수 있도록 문서를 분리해서 관리하고 있습니다.Context.md에는 프로젝트에서 사용하는 주요 시스템이나 용어, 구조처럼 AI가 프로젝트를 이해하기 위해 필요한 정보를 정리했습니다.반대로 Sequence.md에는 AI가 작업하면서 변경한 내용을 계속 기록하도록 했습니다.대략 역할을 나누면Context.md→ 프로젝트가 어떤 구조인지 설명Sequence.md→ 지금까지 어떤 작업과 변경이 있었는지 기록AGENTS.md→ AI가 작업할 때 지켜야 하는 규칙Prompt→ 이번에 해야 할 작업위와 같은 구조가 됩니다.이에 따..

오늘은 선생님이 Skills에 관심이 있다면 꼭 한번 참고해 보라고 보내주신 레포지토리를 정리해보겠습니다.이번에 살펴본 것은 Matt Pocock이 만든 Skills라는 Repository입니다.이름 그대로 AI Agent가 사용할 수 있는 여러 Skill들을 모아놓은 Repository입니다. README에는 첫 문장부터Skills For Real Engineers라고 적혀있습니다.단순히 AI에게 모든 코드를 맡기는 방식보다는 실제 개발 과정에서 AI를 어떻게 활용할 것인지에 초점을 맞추고 있습니다.Skill먼저 Skill이 무엇인지 알아보겠습니다.Skill은 AI에게 특정 작업을 어떻게 수행해야 하는지 알려주는 지침이라고 볼 수 있습니다.예를 들어버그를 수정할 때는 먼저 재현 방법을 만들어라.기능을 ..