앱서비스, 홈페이지 만드는데 6개월 이상 클로드코드를 활용했지만
기능을 제대로 활용했을까 싶습니다.
그냥 '이런거 구현해줘', '오류 수정해줘' 정도만 했던거 같습니다.
체계적인 설정을 통해 더 똑똑한 클로드코드를 만들 수 없을까 해서 이 스터디를 지원했습니다.
기존엔 projects 폴더에 각 서비스들을 따로따로 만들었는데, 통합할 필요가 있을 것 같아서
전체 총괄하는 프로젝트 폴더를 만들고 각 서비스들의 폴더를 통합했습니다.
그리고 이 프로젝트를 제대로 관리할 수 있는 방법들이 뭐가 있는지 물어봤습니다.
CLAUDE.md, Memory.md, Settings, Hooks 등 다양한 방식을 알려줍니다.
사실 스터디장님이나 진경님이 제안해 주신 skills 방식과는 좀 달라서 더 추궁하려다 멈췄습니다.
이제 커멘드 창에서 메인 폴더에서 클로드코드를 시작할 거기 때문에
각 프로젝트를 진행하기 위해 처음에 어떻게 시작하면 좋겠느냐는 질문을 던져봤습니다.
수정할 부분이 /proppedia, /proptalk, /propsheet, /propmap 각각 진행하게
될 것 같아. 처음 이 폴더에서 시작할 때, 각 서비스 부분을 수정할거라는걸
인식하고, 해당되는 서비스의 구성과 필요한 부분을 먼저 읽고 대화를
진행하도록 하고 싶은데, 클로드코드의 어떤 기능을 이용하면 좋을지, 그리고
어떻게 구성하면 좋을지 제안해 줘.
"C:\Users\ant19\projects\Propnet\docs\claude-code-guide.md"그랬더니 방식을 제안해 줍니다.
● 3가지 방식을 제안드립니다:
┌──────────────┬───────────────────────────┬─────────────────────────┐
│ 방식 │ 기능 │ 효과 │
├──────────────┼───────────────────────────┼─────────────────────────┤
│ 서비스별 │ 서브디렉토리 CLAUDE.md │ 해당 서비스 파일 작업 │
│ CLAUDE.md │ 자동 로드 │ 시 규칙/구조 자동 인식 │
├──────────────┼───────────────────────────┼─────────────────────────┤
│ 루트 │ "서비스 작업 시 CLAUDE.md │ 루트에서 시작해도 │
│ CLAUDE.md │ 먼저 읽기" 규칙 │ 서비스 컨텍스트 선행 │
│ 지시 │ │ 로드 │
├──────────────┼───────────────────────────┼─────────────────────────┤
│ │ .claude/agents/에 │ @propedia-dev 같은 │
│ Custom Agent │ 서비스별 에이전트 │ 형태로 전문 에이전트 │
│ │ │ 호출 │
└──────────────┴───────────────────────────┴─────────────────────────┘
● 계획을 정리했습니다. 요약하면:
4단계 작업:
┌──────┬─────────────────────────────────────────┬─────────────────────┐
│ Step │ 작업 │ 파일 │
├──────┼─────────────────────────────────────────┼─────────────────────┤
│ 1 │ PropSheet CLAUDE.md 생성 │ propsheet/CLAUDE.md │
├──────┼─────────────────────────────────────────┼─────────────────────┤
│ 2 │ PropMap CLAUDE.md 생성 │ propmap/CLAUDE.md │
├──────┼─────────────────────────────────────────┼─────────────────────┤
│ 3 │ 루트 CLAUDE.md에 "서비스 진입 규칙" │ CLAUDE.md │
│ │ 추가 │ │
├──────┼─────────────────────────────────────────┼─────────────────────┤
│ 4 │ 서비스별 Custom Agent 4개 생성 │ .claude/agents/*.md │
└──────┴─────────────────────────────────────────┴─────────────────────┘
핵심 포인트:
- PropSheet은 서버에만 코드가 있으므로 MCP 접근 방식을 CLAUDE.md에 안내
- PropMap은 개발 초기이므로 현재 상태 + 향후 방향 중심
- 루트 CLAUDE.md에 "서비스 작업 시 해당 CLAUDE.md 먼저 읽기" 규칙 추가
- .claude/agents/에 4개 서비스별 전문 에이전트 생성핵심은,
각 프로젝트에 CLAUDE.md 파일을 만든다.
루트 프로젝트에 CLAUDE.md에서 각 서비스에 진입하도록 규칙을 만든다.
각 서비스의 CLAUDE.md 파일을 반드시 읽도록 설정한다.
.claude/agents/에 4개 서비스별 전문 agent를 생성한다.
그리고 사용방법과 검증방법을 제시합니다.
계획을 승인했습니다. CLAUDE.md 파일을 새로 만들고, 수정하고 있습니다.
그리고 루트에 서비스 진입 규칙을 만들어줍니다.
이제 Agent 들을 만들어줍니다. 그런데 이건 경험이 없어서 조심스럽습니다.
놀랍게도 --dangerously-skip-permissions 적용했는데도, 이 과정은 물어보네요.
이전에도 이렇게 진행을 했었고, 수정 후 /test, /build 기능을 만들어서 사용했었는데, 그런 부분을 반영해서 작성해 주네요.
이건 자동 진행할지에 대해 고민해서 수정해야 할 것 같습니다. build나 commit/push는 내가 다 되었다 싶을 때 진행해야 하니까요. 우선 문서만 작성하는 거니까 진행시킵니다.
각각의 CLAUDE.md 파일과, 루트 파일, 그리고 agent 파일들을 만들어 줬습니다.
생성된 파일 (6개):
┌─────────────────────────────────┬────────────────────────────────────┐
│ 파일 │ 용도 │
├─────────────────────────────────┼────────────────────────────────────┤
│ propsheet/CLAUDE.md │ PropSheet 서비스 규칙/구조 │
│ │ (HTMX/Alpine.js, Flask Blueprint) │
├─────────────────────────────────┼────────────────────────────────────┤
│ propmap/CLAUDE.md │ PropMap 서비스 규칙/구조 (정적 │
│ │ HTML, 개발 초기) │
├─────────────────────────────────┼────────────────────────────────────┤
│ .claude/agents/propedia-dev.md │ Propedia Flutter 앱 전문 에이전트 │
├─────────────────────────────────┼────────────────────────────────────┤
│ .claude/agents/proptalk-dev.md │ Proptalk 음성 서비스 전문 에이전트 │
├─────────────────────────────────┼────────────────────────────────────┤
│ .claude/agents/propsheet-dev.md │ PropSheet 스프레드시트 전문 │
│ │ 에이전트 │
├─────────────────────────────────┼────────────────────────────────────┤
│ .claude/agents/propmap-dev.md │ PropMap 매물지도 전문 에이전트 │
└─────────────────────────────────┴────────────────────────────────────┘
수정된 파일 (1개):
┌───────────────┬─────────────────────────────────────────────────────┐
│ 파일 │ 변경 내용 │
├───────────────┼─────────────────────────────────────────────────────┤
│ CLAUDE.md │ propsheet/propmap CLAUDE.md 참조 추가 + "서비스별 │
│ (루트) │ 작업 규칙" 섹션 추가 │
└───────────────┴─────────────────────────────────────────────────────┘agent가 어떻게 생겼는지 그 중 하나를 살펴봤습니다. 서비스 설명과 규칙인데, 생각보다 단순하게 작성되어 있어. 제대로 작동할지 모르겠습니다.
---
name: Propedia Developer
description: Propedia Flutter 앱 개발 전문 에이전트. Clean Architecture, Riverpod, 코드 생성 기반 Flutter 앱 수정 시 사용.
---
# Propedia Developer Agent
Propedia(부동산백과) Flutter 앱 개발을 전담합니다.
## 작업 시작 전 필수
1. `propedia/CLAUDE.md`를 읽어 서비스 구조와 규칙을 파악하세요
2. 수정 대상 파일을 먼저 읽고 기존 패턴을 파악하세요
## 핵심 규칙
- **Clean Architecture**: domain → data → presentation 계층 분리 유지
- **State Management**: Riverpod (`@riverpod` 어노테이션) 사용
- **코드 생성**: freezed, json_serializable, retrofit, riverpod 어노테이션 수정 후 반드시 `dart run build_runner build --delete-conflicting-outputs` 실행
- **라우팅**: go_router 사용
- **로컬 DB**: Isar
- **테마**: Material 3, `lib/shared/theme/app_theme.dart`
## 서버 정보
- API Base: `https://goldenrabbit.biz/app/api/`
- 서버 경로: `/home/webapp/goldenrabbit/backend/proppedia/`
- 배포 후: `sudo systemctl restart proppedia`
## 릴리즈 워크플로우
1. 코드 수정 → 2. `/test` → 3. `docs/progress_development.md` 업데이트 → 4. `pubspec.yaml` 버전 업 → 5. `/build` → 6. 커밋/푸시사용방법도 알려줍니다.
사용 방법:
- 일반 대화에서 "propsheet 수정해줘" → Claude가 자동으로 propsheet/CLAUDE.md를 먼저 읽고 시작
- 에이전트 호출: 대화에서 @propedia-dev, @proptalk-dev, @propsheet-dev, @propmap-dev 사용 가능agent는 사용해 본 적이 없어서 이걸 적용할 때 뭐가 달라지는지 확인해 봐야겠습니다.
클로드코드가 좀 똑똑해졌을까요? (원래 똑똑하긴 했지만...)
