본문 바로가기

전체 글

 (155)
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: 보안 규칙 명시..
Claude Code TDD 워크플로우: RED-GREEN-REFACTOR로 버그 없는 코드 만들기 TDD 워크플로우 제대로 돌리는 법도 알려드릴게요. RED-GREEN-REFACTOR 사이클이에요.RED는 실패하는 테스트 먼저 쓰는 거예요. 아직 기능 없으니까 당연히 실패하죠. GREEN은 테스트 통과할 만큼만 코드 짜는 거예요. REFACTOR는 그 코드를 깔끔하게 리팩토링하는 거고요.이 순서 지키면 버그가 확 줄어들어요. 해커톤 때 이렇게 했더니 테스트 커버리지 80% 넘겼거든요.TL;DRTDD = Anthropic 공식 권장 워크플로우 ("Anthropic-favorite workflow")RED → GREEN → REFACTOR 사이클 반복Claude에게 명시적으로 TDD임을 알려야 함 (mock 방지)테스트 먼저 작성 → 실패 확인 → 최소 구현 → 리팩토링/tdd 커스텀 명령어로 자동화 가..
Claude Code Extended Thinking: 깊은 사고로 퀄리티 높이기 Extended Thinking이라는 기능도 있어요.복잡한 문제 주면 Claude Code가 스스로 여러 각도로 생각해봐요. "이렇게 하면 어떻게 되지? 저렇게 하면?" 혼자 시뮬레이션 돌리는 거죠.시간은 오래 걸리지만 퀄리티가 확실히 달라요. 중요한 기능 만들 때 한 번씩 써보세요.TL;DRExtended Thinking = Claude가 답변 전에 깊이 생각하는 공식 기능Claude Code에서 기본 활성화 (최대 31,999 토큰)Ctrl+O로 thinking 과정 볼 수 있음 (verbose mode)"think", "think hard", "ultrathink" 키워드로 thinking budget 조절복잡한 아키텍처, 어려운 버그, 수학/분석에 효과적시간/비용 더 들지만 퀄리티 확실히 향상Ex..

티스토리툴바