831223 · AI 개발 노트

회사에서도 MCP를 쓰고 있습니다. 문서 작업에는 파워포인트 MCP, 브라우저 조작에는 Playwright MCP 같은 서버를 붙여 씁니다.목차한눈에 보기MCP가 뭔가이 블로그 작업에서 실제로 쓴 MCP 도구MCP가 아닌 방법도 있다쓸 때 주의할 점처음 시작하는 방법직접 해보니마무리자주 묻는 질문 (FAQ)이렇게 써 보면 AI 코딩 에이전트가 할 수 있는 일은 결국 손에 쥔 도구에 달려 있다는 것을 느낍니다. 파일을 읽고 고치고, 명령을 실행하고, 웹 페이지를 가져오는 능력이 모두 도구입니다. 이 블로그를 정비하고 글쓰기 도구를 만드는 동안 AI가 쓴 도구는 거의 전부 MCP로 연결된 것이었습니다. MCP가 무엇인지, 실제로 어떤 도구를 썼는지, 그리고 MCP 대신 다른 방법을 쓴 경우까지 정리합니다.한..

회사에서도 AI 코딩 에이전트용 규칙 파일을 쓰고 있습니다. 거창한 원칙보다는 AI가 자꾸 잊어버리는 규칙을 적어 둡니다.목차한눈에 보기AGENTS.md와 CLAUDE.md의 차이실제 AGENTS.md 해부규칙이 실제로 작동한 장면좋은 규칙의 조건 4가지규칙과 기억은 따로 둔다처음 쓰는 사람을 위한 템플릿직접 해보니마무리자주 묻는 질문 (FAQ)AI 코딩 에이전트는 대화를 새로 시작할 때마다 프로젝트의 사정을 모릅니다. 매번 같은 설명을 반복하지 않으려면 "이 저장소에서는 이렇게 일한다"는 규칙을 파일로 적어 두고 에이전트가 읽게 해야 합니다. 그 파일이 AGENTS.md와 CLAUDE.md입니다. 제 블로그 도구 저장소에 실제로 둔 규칙 파일을 예로 들어, 무엇을 어떻게 적었고 실제로 어떻게 작동했는지..

요즘 회사에서 개발하는 방식이 많이 바뀌었습니다. 설계는 제가 하고, 구현은 AI에게 맡깁니다. AI가 테스트까지 마치면 코드 검토는 제가 하고, 고칠 점을 다시 AI에게 넘겨 수정하는 식으로 일합니다.목차한눈에 보기작업 명세에 꼭 넣는 5가지실제로 겪은 일 4가지검증 루틴직접 해보니마무리자주 묻는 질문 (FAQ)이번에 제 블로그 글쓰기 도구를 만들면서 그 방식을 개인 프로젝트에도 그대로 적용해 봤습니다. 구조는 단순합니다. OpenCode에서 도는 AI가 오케스트레이터 역할을 맡아 작업 명세를 쓰고, 그 명세를 작업자 AI인 Claude Code에게 넘깁니다. 작업자가 결과를 보고하면 오케스트레이터가 다시 검증합니다. 저는 방향을 정하고 최종 결과를 확인합니다. 이 과정에서 명세를 어떻게 써야 하는지,..