본문 바로가기

전체 글

 (157)
왜 페르소나는 단순한 '말투' 이상의 기술인가? ADK(Agent Development Kit)에 대해서 보다가 알게된 것을 정리해봤습니다. ADK 에서 알아보다가 표준화된 공통 규격의 인터페이스로 어댑팅하는 구조라는 것을 알게 되었고, 그 구조에서 페르소나가 있다는 것을 알게 되었습니다. 대부분의 최신 LLM은 대화 기록을 보낼 때 다음과 같은 공통 구조를 사용합니다.System: AI의 역할 설정 (너는 전문가야)User: 사용자의 질문Assistant: AI의 답변Tool/Function: 도구 실행 결과그래서 물어봤습니다. 기본적으로 LLM은 페르소나를 주입하는구나.. 이렇게 해야 하는 특별한 이유가 있나? 주입하지 않은 상태에서 하는 것과 어떤 차이가 있어? 맞습니다. LLM에게 페르소나(Persona)를 주입하는 것은 단순히 "재미"를 위..
Claude Code의 한계를 넘다: claude-context-mode AI 코딩 에이전트인 Claude Code를 사용하다 보면 가장 먼저 마주치는 벽이 있습니다. 바로 '컨텍스트 윈도우(Context Window)'의 고갈입니다. 아무리 똑똑한 Claude라도 수만 줄의 로그와 웹 페이지 전체를 한꺼번에 읽다 보면 금방 기억력을 잃고 느려지기 마련이죠.이 문제를 우아하게 해결한 MCP(Model Context Protocol) 서버, claude-context-mode 를 소개합니다.1. 해결하고자 하는 문제 (The Problem)AI 에이전트가 외부 도구(MCP)를 사용할 때 발생하는 '데이터 폭발' 현상을 해결합니다.컨텍스트 낭비: 웹 브라우저 스냅샷 하나가 약 56KB, GitHub 이슈 목록이 60KB를 차지합니다.빠른 성능 저하: 몇 번의 도구 실행만으로 20..
Superpowers: AI 코딩 에이전트의 잠재력을 극대화하는 스킬 프레임워크 들어가며AI 코딩 에이전트가 빠르게 발전하면서 개발자들의 작업 방식이 근본적으로 변화하고 있습니다. 하지만 현재의 AI 에이전트들은 종종 즉흥적으로 코드를 작성하거나, 체계적인 계획 없이 구현에 뛰어드는 경향이 있습니다. Superpowers는 이런 문제를 해결하기 위해 등장한 오픈소스 프로젝트로, AI 에이전트에게 체계적인 소프트웨어 개발 워크플로우를 가르치는 "스킬(Skills)" 프레임워크입니다.GitHub에서 34,000개 이상의 스타를 받으며 개발자 커뮤니티의 뜨거운 관심을 받고 있는 이 프로젝트의 핵심 개념과 작동 방식을 살펴보겠습니다.Superpowers가 해결하는 문제일반적인 AI 코딩 에이전트에게 "로그인 기능을 만들어줘"라고 요청하면 어떻게 될까요? 대부분의 경우 에이전트는 즉시 코드 ..
AI 에이전트를 위한 PostgreSQL 베스트 프랙티스: Supabase Agent Skills 완벽 가이드 > 이 글은 [supabase/agent-skills](https://github.com/supabase/agent-skills)를 기반으로 정리했습니다.들어가며AI 코딩 에이전트가 데이터베이스 스키마를 설계하고 쿼리를 작성하는 시대가 되었습니다. Claude Code, Cursor, GitHub Copilot 같은 도구들이 SQL 코드를 생성하고, MCP(Model Context Protocol)를 통해 데이터베이스와 직접 상호작용하기도 합니다.하지만 AI 에이전트가 생성한 코드가 항상 최적은 아닙니다. 인덱스 없이 대용량 테이블을 조회하거나, RLS(Row Level Security) 정책을 비효율적으로 구성하거나, 커넥션 풀링을 무시한 채 직접 연결을 남발하는 경우가 흔합니다.Supabase는 이 ..
[개발 가이드] Claude Code 제대로 쓰는 법: Anthropic이 공개한 8가지 베스트 프랙티스 최근 공개된 Claude Code는 단순한 코딩 어시스턴트를 넘어, 직접 파일을 수정하고 터미널 명령어를 실행하는 '에이전트'형 도구입니다. 하지만 강력한 만큼 제대로 쓰는 법을 아는 것이 중요합니다. Anthropic 공식 문서( https://code.claude.com/docs/en/best-practices )를 바탕으로, Claude Code의 성능을 극대화하는 꿀팁을 정리했습니다. 1. 핵심 철학: "검증 가능하게 지시하라"Claude Code를 사용할 때 가장 중요한 한 가지를 꼽으라면 바로 **'검증 수단 제공'**입니다. Claude가 코드를 짠 후 잘 돌아가는지 스스로 확인할 수 있게 해주세요.Bad: "이메일 유효성 검사 함수 만들어줘."Good: "이메일 유효성 검사 함수를 만들고..
Claude Code에서 MCP vs Skills vs CLI - 무엇을 선택해야 할까? 들어가며Claude Code에서 GitHub와 연동하려고 할 때, 선택지가 여러 개다:GitHub MCP 서버Skills (SKILL.md)gh CLI + CLAUDE.md처음엔 당연히 MCP가 "올바른" 방법이라 생각했다. 공식적이고, 구조화되어 있고, 뭔가 있어 보이니까. 하지만 실제로 팀 프로젝트에 적용하려다 보니 예상치 못한 문제를 만났다.문제의 시작: 팀 프로젝트에서 토큰 공유프로젝트 레벨의 MCP 설정(.mcp.json)을 git으로 공유하려 했다. 그런데 GitHub MCP는 인증 토큰이 필요하다.{ "github": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-github"], "env": { ..
Claude Code 생산성 10배 올리기: 키보드부터 자동화까지 키보드 단축키부터 외우세요. Cmd+K는 퀵 액션, Cmd+Shift+P는 명령 팔레트, Cmd+/는 주석 토글, Cmd+D는 같은 단어 선택... 이런 거 손에 익으면 마우스 안 쓰고도 코딩할 수 있어요. 처음엔 느려도 1주일만 연습하면 2배는 빨라져요.TL;DR키보드 단축키: Escape(중단), Double-Escape(되감기), Tab(자동완성)프롬프트: 구체적 + 컨텍스트 = 최고의 결과물자동 커밋: Stop Hook으로 세션 종료 시 자동 커밋PR 템플릿: .github/pull_request_template.md로 표준화/clear 자주: 새 작업마다 컨텍스트 리셋커스텀 명령어: 반복 작업을 한 줄로1. 키보드 단축키 마스터하기Claude Code 핵심 단축키"Press Escape to i..
Claude Code 보안 Best Practices: 타협 없는 안전한 AI 코딩 보안은 절대 타협하면 안 돼요. Rules 시스템 적극 활용하세요.CLAUDE.md에 "API 키 절대 하드코딩 금지, 환경 변수 무조건 사용" 이렇게 박아두면 Claude Code가 지켜줘요.Security Reviewer Agent도 돌려보세요. SQL 인젝션, XSS, CSRF 같은 취약점 자동으로 찾아내요. 배포 전에 꼭 한 번 체크하는 습관 들이세요.TL;DR기본 원칙: Claude를 "똑똑하지만 신뢰할 수 없는 인턴"으로 대하기Permission 시스템: allow/deny/ask 규칙으로 세밀하게 제어Sandbox: /sandbox로 파일시스템 + 네트워크 격리 (84% 권한 요청 감소)민감 파일 차단: .env, ~/.ssh/, ~/.aws/ 접근 denyCLAUDE.md: 보안 규칙 명시..

티스토리툴바