기본 콘텐츠로 건너뛰기

글

Pinned Post

MoAI-ADK 워크플로우 명령어 사용법: 누가나 이해하는 프로젝트·계획·구현·정리 가이드

AI 개발 도구 · MoAI-ADK 사용 가이드 MoAI-ADK 워크플로우 명령어 익히기: 프로젝트 분석부터 코드 구현까지 AI 코딩 도구를 사용하다 보면 원하는 기능을 설명하고 코드를 만들어 달라고 요청하는 일이 많습니다. 하지만 기존 프로젝트에 새로운 기능을 추가할 때는 코드를 작성하는 것만큼 먼저 구조를 파악하고, 요구사항을 정리하고, 구현 결과를 확인하는 과정도 중요합니다. MoAI-ADK의 워크플로우 명령어를 익혀 두면 이러한 작업을 단계별로 진행할 수 있습니다. 작성 기준일: 2026년 10월 28일 · 공식 문서 기준 먼저 알아둘 네 가지 명령어 처음부터 모든 명령어를 외울 필요는 없습니다. 우선 프로젝트를 이해하고, 계획을 세우고, 코드를 구현한 다음, 결과를 정리하는 흐름부터 익혀 보세요. 01. project 기존 프로젝트 분석 02. plan 요구사항과 작업 계획 정리 03. run 계획에 따른 코드 구현 04. sync 결과 검증과 문서 정리 공식 문서: MoAI-ADK 워크플로우 명령어 1. 학교 프로젝트에 비유하면 이해하기 쉽습니다 친구들과 함께 숙제 관리 웹사이트를 만든다고 생각해 보겠습니다. 학생들이 숙제를 등록하고, 완료한 항목을 표시하고, 남은 숙제를 확인할 수 있는 프로그램입니다. AI에게 "숙제 관리 웹사이트를 만들어 줘"라고 요청하면 곧바로 코드를 작성할 수도 있습니다. 하지만 필요한 기능이 빠지거나, 기존 프로그램의 구조와 맞지 않는 코드가 만들어질 수 있습니다. 나중에 이런 문제를 발견하면 코드를 다시 수정해야 하므로 작업이 더 복잡해집니다. MoAI-ADK의 워크플로우는 작업을 몇 단계로 나누어 진행합니다. 먼저 현재 프로그램을 살펴보고, 무엇을 만들지 정리한 뒤, 계획에 따라 구현하고 결과를 확인하는 방식입니다. ...
최근 글

Aside 브라우저를 Claude Code에 MCP로 연결하기: Windows 설치 및 설정 가이드

Aside 브라우저를 Claude Code에 MCP로 연결하기: Windows 설치 및 설정 가이드 웹 개발을 하다 보면 코드를 작성하는 것만으로는 부족할 때가 있습니다. 실제 브라우저에서 페이지를 열어 보고, 화면이 제대로 표시되는지 확인하고, 웹 애플리케이션의 동작까지 살펴봐야 하죠. Claude Code에서 이런 브라우저 작업을 활용하고 싶다면 Aside와 MCP를 연결하는 방법을 살펴볼 만합니다. 설정 과정은 복잡하지 않습니다. 다만 Aside에서 CLI를 설치하는 것과 Claude Code에 MCP 서버를 등록하는 것은 별개의 작업이므로 순서대로 진행해야 합니다. 이 글에서 다루는 내용 Aside 브라우저와 CLI 설치 Claude Code용 Skill 설정 Aside MCP 서버 활성화 Windows 경로를 사용한 MCP 설정 연결 상태 확인 및 문제 해결 작성 기준일: 2026년 10월 28일 대상 환경: Windows 11, Aside 브라우저, Claude Code CLI 참고: 아래 절차는 제공된 설정 내용을 바탕으로 정리했습니다. 실제 PC에서 설치하거나 연결 테스트를 진행한 결과는 아닙니다. 1. 먼저 준비할 것 시작하기 전에 Aside 브라우저와 Claude Code를 준비합니다. Claude Code는 터미널에서 claude 명령을 실행할 수 있는 상태여야 합니다. Aside 브라우저: 설치 후 실행할 수 있어야 합니다. Aside CLI: 브라우저의 Developers 화면에서 설치합니다. Claude Code CLI: 터미널에서 실행할 수 있도록 설치와 초기 설정을 마칩니다. 2. Aside 브라우저 설치 먼저 Aside 공식 홈페이지 에서 브라우저를 설치한 뒤 실행합니다. 이후 CLI 설치와 MCP 설정은 Aside 앱 안에서 진행합니다. 브라우저를 설치했다고 해서 Claude Code와 자동으로 연결되는 것은 아니므로 다음 단계를 이어서 진행해야 합니...

IIS 서버에 Datadog APM을 붙이며 배운 것들 — 설치부터 서비스 이름 정리까지, 실수를 거쳐 찾은 정답 경로

IIS 서버에 Datadog APM을 붙이며 배운 것들 — 설치부터 서비스 이름 정리까지, 실수를 거쳐 찾은 정답 경로 작성 기준일: 2026년 10월 28일 · 환경: Windows Server와 IIS 10, ASP.NET Core 8과 .NET Framework 앱 혼재, Datadog Agent 7.84.6, .NET Tracer 3.56.0 들어가며 운영 중인 IIS 서버에 Datadog APM을 연동하는 일은 생각보다 간단해 보입니다. 공식 문서를 펼치면 설치 명령 몇 줄과 "코드 수정 없이 자동으로 계측된다"는 설명이 전부이기 때문입니다. 그런데 실제로 해 보니, 설치 자체보다 지금 서버가 어떤 상태인지 모른 채 손을 대는 것 이 훨씬 큰 문제였습니다. 이번 작업은 반나절이 걸렸습니다. 그중 대부분은 기술을 익히는 데가 아니라, 운영 측의 실수와 함께 작업한 AI 어시스턴트(Claude)의 잘못된 안내를 바로잡는 데 쓰였습니다. 이 글은 그 과정을 시간 순서대로 정리한 기록이자, 다음에 같은 작업을 할 사람이 같은 길을 헤매지 않도록 만든 안내서입니다. 처음 Datadog을 접하는 주니어 개발자도 따라올 수 있도록, 용어 설명부터 명령 하나하나의 의미까지 최대한 풀어서 썼습니다. 글 곳곳에는 근거의 종류를 구분하는 표시를 달아 두었습니다. 공식 은 Datadog이나 Microsoft 공식 문서에 나온 내용이고, 실측 은 실제 서버에서 직접 확인한 결과입니다. 의견 은 경험에서 나온 권장 사항이며, 미검증 은 아직 직접 확인하지 못한 내용입니다. 공개 글이므로 서버 이름과 도메인, 서비스 이름은 모두 예시 이름으로 바꿨습니다. 바쁜 분을 위한 세 줄 요약 첫째, 설치하기 전에 반드시 현재 상태부터 진단 합니다. 이미 계측되고 있을 수도 있고, 다른 방식으로 설치되어 있을 수도 있습니다. 둘째, Agent 설치기에는 DD_APM_INSTRUMENTATION_ENABLED=iis 를 꼭 넣고, IIS 전체가 재시작되므로 점...

AI 코딩 에이전트 프롬프트 활용법: GitHub 스킬 6가지로 작업 품질 높이기

AI 코딩 에이전트 프롬프트 활용법: GitHub 스킬 6가지로 작업 품질 높이기 AI에게 코드를 작성해 달라고 요청했는데, 필요하지 않은 파일까지 수정하거나 기존 프로젝트의 규칙을 무시하는 경우가 있습니다. 문서를 작성할 때도 표현이 반복되거나, 이전 작업에서 정한 조건이 다음 요청에 반영되지 않는 일이 생깁니다. 이런 문제를 줄이려면 프롬프트를 길게 작성하는 것보다 무엇을 요청할지, 어떤 순서로 작업할지, 결과를 어떻게 검증할지 를 명확하게 정하는 편이 좋습니다. GitHub에는 이런 작업 방식을 돕는 AI 에이전트 스킬이 여럿 공개되어 있습니다. 이번 글에서는 Karpathy Guidelines, Claude Video, Humanizer, Agent Memory, Superpowers, Skill Creator를 살펴보고, 각 스킬을 활용할 때 어떤 프롬프트를 입력하면 좋은지 예제 중심으로 정리합니다. 이 글에서 다루는 내용 AI가 요청 범위를 벗어나 코드를 수정하지 않도록 지시하는 방법 동영상 분석 결과를 개발 문서로 정리하도록 요청하는 방법 한국어 기술 문서를 자연스럽게 윤문하는 프롬프트 이전 작업의 결정 사항을 다음 세션에 전달하는 방법 설계·구현·테스트를 단계별로 진행하도록 지시하는 방법 반복 작업을 전용 스킬로 만들고 결과를 평가하는 방법 작성 기준일: 2026년 10월 28일 확인 범위: 공개 GitHub 저장소와 공식 문서의 설명을 확인했습니다. 아래 프롬프트는 실제 사용에 참고할 수 있도록 구성한 예제이며, 실제 IDE에서 실행한 결과나 성능 측정값은 아닙니다. 1. 프롬프트를 잘 작성하려면 무엇이 달라야 할까? AI에게 작업을 요청할 때 가장 흔한 실수는 목표만 전달하고 작업 범위와 완료 조건은 정하지 않는 것입니다. 예를 들어 다음과 같이 요청할 수 있습니다....