Keyword / 19 entries
이 키워드가 붙은 글입니다. 전체 글
What I found when I tried to make a repository carry its own agent rules for both runtimes My agents are well trained, as long as they run on my Mac. On 2026-10-01 my ~/.claude held a 22,449-byte CLAUDE.md, 12 rule files, 7 agents, hooks on five events and 24 enabled plugins. My ~/.codex held a 31,128-byte AGENTS.md,…
EN2026-10-22
They should know how to ask your repo — five times mine knew too much On 2026-06-12 I rewrote three skills in my global Claude Code folder, because one of my own projects was living inside them. Not a reference to it. The project itself. My semantic-commit skill, which I had added on 2026-04-19, told the agent to…
A counter-list to the "plugins every developer should install" posts: five things my own transcripts taught me My feed keeps serving me lists of Claude Code plugins and skills I apparently cannot live without. I read them. I also install things: at my 2026-09-03 census, my global skills folder held 36 user skills. So…
EN2026-10-21
What I learned when my own subagents ignored my rules, skipped my gates, refused my approval, and read my answer key On 2026-10-02 I was testing a new Claude Code skill by running it through subagent scenarios. One of the subagents did exactly what the skill told it to do: it stopped at the plan-approval gate, showed…
EN2026-10-20
A skill that never fires may not have a weak description. It may have no description at all. You write a skill. You give it a careful description. Then you wait for Claude to reach for it, and it never does. The natural next step is to rewrite the description: make it sharper, add trigger words, maybe add an…
EN2026-10-19
Almost every line should send the agent to another file. These are the places where mine did not, and what went stale. On the morning of 2026-03-23, I made the CLAUDE.md in mirae, my Flutter alarm app, as helpful as I could. It had the package structure, the flavors, the Riverpod codegen rules, a TDD protocol, a "What…
EN2026-10-18
AI의 질문은 대체로 친절해 보입니다. 문제는 친절함이 아니라 선택의 단위입니다. 계획을 더 다듬을지, 구현을 시작할지, 검토만 할지를 사용자가 다시 정의해야 하기 때문입니다. 선택지를 주면 조금 나아집니다. 그런데 세 선택지가 모두 같은 무게로 놓이면 사용자는 또 묻게 됩니다. “그래서 지금은 뭘 추천하는데?” 구조화된 메뉴는 답의 범위를 줄이고 선택 기록을 남깁니다. 이 글은 그 패턴에 한 단계를 더해 다음 규칙을 제안합니다. 현재 정보로 가장 안전한 기본값과 그 이유를 짧게 보여 줍니다. 이 추천은 확인된 툴킷 기능을 소개하는 문장이 아니라, 사용자가 검토할…
KO2026-09-16
코딩 AI에게 기능을 맡기기 전, “버튼 하나 추가해 줘”라고 바로 말하고 싶을 때가 있습니다. 문장도 짧고 결과도 빨리 보고 싶으니까요. 그런데 코드베이스는 빈 캔버스가 아닙니다. 이미 폴더의 역할, 상태를 다루는 방식, 데이터를 오가는 길, 그리고 지켜야 할 약속이 쌓여 있습니다. 그걸 찾지 않고 구현부터 시키면 AI는 열심히 일하면서도 엉뚱한 서랍에 양말을 넣을 수 있습니다 (정리한 사람만 더 피곤해지는 그 서랍 말입니다). AI가 코드를 잘 생성한다는 사실과, 이 저장소의 맥락을 이미 안다는 사실은 다릅니다. 요구사항은 “무엇을 만들지”를 알려 줍니다. 반면…
KO2026-08-13
프로젝트를 열었는데 루트에도 AGENTS.md가 있고, 작업할 폴더 안에도 또 AGENTS.md가 있다면 AI는 무엇을 읽어야 할까요? 둘 다 읽다가 갑자기 우왕좌왕하는 것 아닐까요? 사람도 규칙 문서 두 장만 만나면 표정이 복잡해지는데, AI라고 문서 더미 앞에서 초연할 리는 없습니다 (다만 표정 대신 다음 토큰을 낼 뿐입니다). 여기서 가장 흔한 오해는 가까운 문서 하나만 이긴다는 생각입니다. 하위 폴더의 지침이 있으니 루트 지침은 폐기되고, 두 문서가 경쟁하는 결승전처럼 보이는 것이죠. 하지만 유지보수하기 좋은 저장소 패턴에서는 조금 다르게 생각하는 편이…
CLAUDE.md도 있고 AGENTS.md도 있다면, 둘 다 길고 자세하게 쓰는 편이 친절할까요? 처음에는 그래 보입니다. 도구마다 알아듣기 쉬운 문서를 하나씩 주면 될 것 같으니까요. 그런데 두 문서가 같은 빌드 명령, 같은 작업 규칙, 같은 검증 절차를 반복하기 시작하면 친절은 금세 두 개의 정답 후보가 됩니다. 문서가 두 명의 교장 선생님처럼 서로 다른 말을 하기 시작하는 순간이죠 (둘 다 진지해서 더 곤란합니다). 이 문제를 피하는 한 가지 관리 패턴이 얇은 도구별 어댑터입니다. 여기서 어댑터란, 특정 AI 도구가 저장소의 운영 방식을 찾고 따르도록 연결해…
AI가 다음 행동을 정해야 하는 순간, 이런 질문을 받으면 어떨까요? “그래서 이제 무엇을 할까요?” 친절해 보입니다. 하지만 막상 답하려고 하면 생각이 길어집니다. 계획을 더 다듬을지, 작업을 시작할지, 잠깐 멈추고 정보를 더 줄지, 아니면 전혀 다른 방향을 말해야 할지 말이죠. 자유로운 질문 하나가 작은 빈칸 시험지가 되는 순간입니다. 이럴 때 메뉴형 질문은 질문을 없애지 않습니다. 대신 답의 모양을 정합니다. AI 도구의 AskUserQuestion 메뉴 패턴은 다음 단계의 선택지를 이름 붙은 항목으로 보여 주고, 사용자가 그중 하나를 고르게 하는 방식입니다.…
AI 코딩 도구에서 /무언가를 입력해 보신 적이 있다면, 어느 날 그 명령이 사라지고 “스킬을 호출하세요”라는 안내를 만났을 때 조금 당황했을 법합니다. 이름만 바꾼 것 같은데, 왜 굳이 명령어를 스킬로 옮길까요? 명령어가 잘못해서 벌을 받는 것도 아닌데 말입니다. 이 질문을 풀 때 가장 먼저 버려야 할 생각은 **“명령어와 스킬은 같은 버튼의 다른 라벨”**이라는 모델입니다. 사용자 입장에서는 둘 다 어떤 일을 시작하는 입구처럼 보입니다. 하지만 도구를 만들고 배포하는 쪽에서는 입구의 이름보다, 그 뒤에 무엇을 묶어 두고 여러 환경에 어떻게 전달할지가 더 큰…
EN2026-10-22
EN2026-10-22
EN2026-10-21
EN2026-10-20
EN2026-10-19
EN2026-10-18
KO2026-09-16
KO2026-08-13
KO2026-08-13
KO2026-08-13
KO2026-08-13
KO2026-08-13