PARA System + Claude Code 실전가이드
본문 로딩 중...
댓글 0
댓글을 작성하려면 로그인이 필요합니다.
아직 댓글이 없습니다. 첫 번째 댓글을 작성해보세요!
저는 개발자에서 기획자로 전환한 사람입니다. 14개의 서비스 레포, 회사 Notion, 수십 개의 기획 문서를 동시에 다루면서 하나의 질문이 생겼습니다.
"이 많은 정보를 어떻게 찾고, 연결하고, 활용할 것인가?"
답은 PARA System으로 정보를 정리하고, Claude Code로 정보를 활용하는 것이었습니다. 이 글은 제가 실제로 매일 사용하는 워크플로우를 공유합니다.
para-system/
├── 1_project/ # 진행 중인 프로젝트 (마감일 있음)
│ ├── develog/ # develog 사이트 구축
│ ├── lms-관리자-페이지/ # LMS 관리자 기능 개발
│ ├── lms-ai-챗봇/ # AI 챗봇 도입
│ └── ...
│
├── 2_area/ # 지속적 관심 영역 (끝나지 않음)
│ ├── claude-code/ # Claude Code 학습/활용
│ ├── develrocket-lms/ # LMS 서비스 운영
│ │ ├── architecture/ # 아키텍처 문서
│ │ └── repos/ # 14개 서비스 레포
│ │ ├── hrd-api/
│ │ ├── lms-api-v3/
│ │ ├── lms-web/
│ │ └── ...
│ ├── planning/ # 기획 역량
│ ├── notion/ # Notion 운영
│ └── ...
│
├── 3_resource/ # 참고 자료
│ ├── hrd/ # HRD 관련 자료
│ ├── platforms/ # 플랫폼 벤치마킹
│ └── ...
│
└── 4_archive/ # 완료/비활성
└── ...
핵심은 로컬 파일 시스템 자체가 PARA 구조라는 점입니다. Claude Code는 이 파일 시스템을 직접 읽고 탐색하기 때문에, 폴더 구조가 곧 AI의 컨텍스트가 됩니다.
PARA 구조의 최상위에 CLAUDE.md를 두면, Claude Code가 프로젝트에 진입할 때마다 이 파일을 자동으로 읽습니다.
# PARA System - Claude Code 프로젝트 설정
### 소유자 프로필
- 역할: 기획자 (이전: NestJS/Next.js 개발자)
- 목표: 성공적인 기획자로 성장
## 응답 규칙
- 기본 언어: 한국어
- 기획자 관점에서 설명 (기술 구현보다 WHY/WHAT 중심)
- 개발 배경이 있으므로 기술적 세부사항도 이해 가능
## 회사 Notion 데이터베이스
| DB | 용도 |
|----|------|
| Projects DB | 프로젝트 관리 |
| Task DB | 할일 관리 |
| Note DB | 문서/노트 |
## 금지 사항
- 사용자 확인 없이 파일 삭제 금지
- 자동 커밋 금지
- 회사 Notion 데이터 수정은 명시적 요청 시에만 허용
이렇게 설정하면 Claude Code는:
CLAUDE.md는 PARA의 모든 폴더에 개별적으로 둘 수 있습니다. 예를 들어 2_area/develrocket-lms/repos/hrd-api/ 안에 별도의 CLAUDE.md를 두면, 해당 레포에서 작업할 때 그 설정이 적용됩니다.
Claude Code의 가장 강력한 기능 중 하나는 **Custom Skills(슬래시 커맨드)**입니다. ~/.claude/commands/ 폴더에 마크다운 파일을 만들면 /명령어로 실행할 수 있습니다.
~/.claude/commands/
├── github/ # GitHub 운영 자동화
│ ├── repo.md # /github:repo
│ ├── activity.md # /github:activity
│ ├── sync.md # /github:sync
│ └── arch.md # /github:arch
│
├── sc/ # SuperClaude 개발/분석 도구
│ ├── analyze.md # /sc:analyze
│ ├── design.md # /sc:design
│ ├── implement.md # /sc:implement
│ ├── document.md # /sc:document
│ ├── workflow.md # /sc:workflow
│ ├── explain.md # /sc:explain
│ ├── load.md # /sc:load
│ └── ...
│
└── util/ # 유틸리티
└── read-hwp.md # /util:read-hwp
PARA 분류: 2_area/develrocket-lms (지속적 운영 업무)
> /github:activity
이 한 줄이면 팀원들의 최근 커밋, PR, 이슈를 한국어로 요약해줍니다. 14개 레포 전체를 gh API로 조회해서 "어제 뭐 했지?"를 30초 만에 파악합니다.
> /github:repo hrd-api
특정 레포의 브랜치, 열린 PR, 이슈 현황을 빠르게 확인합니다.
PARA 분류: 2_area/develrocket-lms/repos (14개 레포 관리)
> /github:sync
한 명령어로 14개 레포 전체를 최신 상태로 동기화합니다. 새로 생긴 레포는 자동 클론, 삭제된 레포는 감지해서 알려줍니다.
PARA 분류: 2_area/develrocket-lms/architecture (아키텍처 문서)
> /github:arch
아키텍처 문서 + 실제 소스코드를 동시에 탐색합니다. 기획 문서를 작성할 때 "이 기능이 어디에 있고, 어떻게 동작하는지" 파악할 때 유용합니다.
PARA 분류: 1_project/ 아래 해당 프로젝트
> /sc:analyze @src/modules/trainee --focus architecture
코드를 직접 분석해서 현재 구조, 의존성, 개선 포인트를 정리해줍니다. 기획자로서 "기술적으로 왜 이렇게 해야 하는지"를 설명할 근거를 만들 때 씁니다.
PARA 분류: 1_project/ → 실행은 2_area/repos/
> /sc:workflow 관리자 페이지에 훈련생 추가정보 CRUD 기능을 추가해야 합니다.
현재 trainee-extra 테이블이 있고, 과정 확장 필드도 추가되어 있습니다.
PRD나 기획 내용을 주면, 단계별 구현 계획을 생성합니다. 태스크 분해, 의존성 매핑, 예상 작업량까지 포함합니다.
PARA 분류: 3_resource/ (외부 자료)
> /util:read-hwp /path/to/직업능력심사평가원_공고.hwp
한국 공공기관에서 오는 HWP 파일을 텍스트로 변환해서 읽어줍니다. 기획자에게 HWP 자료를 빠르게 파악해야 할 때 유용합니다.
PARA 분류: 전체 (Notion이 PARA의 디지털 허브)
> 오늘 할일 보여줘
> 진행 중인 프로젝트 보여줘
> LMS 관련 노트 찾아줘
CLAUDE.md에 Notion DB ID를 설정해두었기 때문에, 자연어로 물어보면 Notion MCP를 통해 직접 조회합니다. Task DB의 오늘 할일, Projects DB의 진행 현황, Note DB의 문서 검색이 대화 안에서 이루어집니다.
| Skill | 명령어 | 용도 | 사용 빈도 |
|---|---|---|---|
| 팀 활동 | /github:activity | 팀원 커밋/PR/이슈 모니터링 | 매일 아침 |
| 레포 조회 | /github:repo [name] | 특정 레포 상태 확인 | 수시 |
| 일괄 동기화 | /github:sync | 14개 레포 전체 pull | 주 2-3회 |
| 아키텍처 | /github:arch | 서비스 구조 파악 | 기획 시 |
| Skill | 명령어 | 용도 | 사용 시점 |
|---|---|---|---|
| 분석 | /sc:analyze [target] | 코드/시스템 분석 | 기획 근거 필요 시 |
| 설계 | /sc:design [target] | API/시스템 설계 | 신규 기능 기획 시 |
| 구현 | /sc:implement [feature] | 기능 구현 | 직접 개발 필요 시 |
| 문서화 | /sc:document [target] | 문서 자동 생성 | 산출물 작성 시 |
| 워크플로우 | /sc:workflow [요구사항] | 구현 계획 생성 | PRD → 태스크 분해 시 |
| 설명 | /sc:explain [target] | 코드/개념 설명 | 팀에 설명할 때 |
| 로드 | /sc:load [path] | 프로젝트 컨텍스트 로딩 | 새 레포 진입 시 |
| Skill | 명령어 | 용도 |
|---|---|---|
| HWP 리더 | /util:read-hwp [path] | 한글 파일 텍스트 추출 |
| 디자인 브리프 | /design-brief | 디자인 작업지시서 생성 |
cd ~/para-system/2_area/develrocket-lms/repos/hrd-api
claude
PARA 폴더에서 Claude Code를 실행하면, 해당 폴더의 CLAUDE.md가 자동 로드됩니다. 어디서 실행하느냐가 곧 AI가 뭘 아느냐를 결정합니다.
| 실행 위치 | AI가 아는 것 |
|---|---|
para-system/ | PARA 전체 구조, 소유자 프로필, Notion DB |
2_area/develrocket-lms/repos/hrd-api/ | HRD API 코드 + 상위 PARA 설정 |
1_project/develog/ | develog 프로젝트 기획서 + 상위 PARA 설정 |
기획(Project) → 코드 분석(Area) → 구현(Area) → 문서화(Project) 흐름이 하나의 대화 안에서 이루어집니다.
나: "관리자 페이지에 훈련생 추가정보 관리 기능이 필요해" (Project)
AI: (sc:analyze로 현재 코드 분석) (Area - repos)
나: "이걸 바탕으로 기획서 초안 만들어줘" (Project)
AI: (sc:document로 기획서 생성) (Project)
나: "구현해줘" (Area - repos)
AI: (sc:implement로 코드 작성) (Area - repos)
Claude Code는 ~/.claude/projects/ 아래에 프로젝트별 메모리를 저장합니다. PARA의 각 영역에서 작업하면서 쌓인 인사이트가 다음 대화에서도 유지됩니다.
"이 프로젝트에서 HRD 동기화는 목적별 Cron으로 분리되어 있어"
→ Memory에 저장
→ 다음 대화에서 관련 질문하면 이 맥락을 알고 있음
mkdir -p ~/para-system/{1_project,2_area,3_resource,4_archive}
cat > ~/para-system/CLAUDE.md << 'EOF'
# 내 PARA System
## 소유자 프로필
- 역할: (여기에 작성)
- 관심 분야: (여기에 작성)
## 응답 규칙
- 기본 언어: 한국어
- 간결하고 실용적인 답변
EOF
cd ~/para-system
claude
이것만으로 시작할 수 있습니다. Custom Skills나 Notion 연동은 익숙해진 후에 하나씩 추가하면 됩니다.
PARA System은 정보를 정리하는 틀이고, Claude Code는 정리된 정보를 활용하는 엔진입니다.
둘을 합치면 "폴더에 들어가서 물어보기만 하면 되는" 워크플로우가 만들어집니다.
기획자든, 개발자든, 어떤 역할이든 — 자기 업무를 PARA로 정리하고 Claude Code를 연결해보세요. 정보를 다루는 방식이 달라집니다.
이 글에서 소개한 Skills와 CLAUDE.md 설정은 제 실제 업무 환경을 기반으로 작성되었습니다.
그대로 따라할 필요 없이, 본인의 역할과 도구에 맞게 조정하세요.