메뉴
새 docs 서브카테고리(섹션) 추가. DOCS_GROUPS 그룹 배치, 색상 hue, sidebar, index.mdx까지 모든 동기화 지점을 한 번에 일관되게 처리. 사용자가 '새 섹션', '새 카테고리', '새 서브카테고리', '새 항목 추가', '새 도큐 카테고리' 등을 언급하거나 docs/<key>/ 디렉토리를 새로 만들려는 의도가 보일 때 반드시 사용. 단일 문서 추가는 `/add`, 학습 로드맵 설계는 `/roadmap`.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
payment-platform-portfolio 페이지(/payment-platform-portfolio/)의 파일 맵과 편집 위치 안내. 결제 플랫폼 포트폴리오의 문구·수치·다이어그램·시나리오·표·상태 머신·설계 결정을 수정하거나, 어느 파일·어느 상수를 고쳐야 하는지 파악해야 할 때 반드시 먼저 사용한다. '포트폴리오', '히어로 문구', '시나리오 추가', '벤치마크 수치', '설계 결정', '상태 머신', '경합 표', '알람 표' 등 포트폴리오 관련 편집·질문이 나오면, 사용자가 파일명을 명시하지 않아도 이 스킬을 참조해 4계층(astro/css/scripts/data) 중 올바른 파일로 라우팅한다.
기술 블로그 글의 가독성과 품질을 리뷰한다. 글 피드백 요청, 리뷰 요청, 가독성 점검 요청 시 사용한다. '이 글 피드백해줘', '리뷰해줘', '낯선 사람이 읽으면 어떨까' 등의 요청에도 반응한다.
문서 콘텐츠 작성 컨벤션. 문서를 새로 작성하거나 수정할 때, 기존 문서의 스타일 컨벤션 확인 요청 시, 본문 내용을 직접 작성할 때 사용한다.
학습 로드맵 스펙 파일(`<CAT>_SPEC.md`) 작성. 새로운 docs 서브카테고리의 학습 커리큘럼을 GRADLE_SPEC.md / ELK_SPEC.md와 동일한 5 Layer 구조로 설계할 때 호출. '학습 로드맵', '커리큘럼', '과정 파일', '스펙 파일', '문서 계획', '학습 계획' 키워드 또는 기존 `*_SPEC.md` 참조하며 새 카테고리 동일 형식 작성 요청 시 반드시 사용. 단순 문서 1개 추가는 `/add` 사용.
새 게시글/문서 추가. 새 글 추가, 포스팅, 문서 등록 요청 시, 또는 완성된 마크다운 문서를 제공하면서 등록 요청 시 사용한다.
SEO description 작성/추가/점검. description 작성, 추가, SEO 개선, 카테고리 일괄 작업, 기존 description 검토 요청 시 사용한다.
| name | section |
| description | 새 docs 서브카테고리(섹션) 추가. DOCS_GROUPS 그룹 배치, 색상 hue, sidebar, index.mdx까지 모든 동기화 지점을 한 번에 일관되게 처리. 사용자가 '새 섹션', '새 카테고리', '새 서브카테고리', '새 항목 추가', '새 도큐 카테고리' 등을 언급하거나 docs/<key>/ 디렉토리를 새로 만들려는 의도가 보일 때 반드시 사용. 단일 문서 추가는 `/add`, 학습 로드맵 설계는 `/roadmap`. |
/section 호출 시단일 문서 추가는
/add, 학습 로드맵 스펙(*_SPEC.md) 작성은/roadmap. 본 스킬은 빈 서브카테고리 뼈대를 만들 때 사용.
$ARGUMENTS — 서브카테고리 키 또는 라벨 (예: "elk", "PostgreSQL"). 생략 시 인터뷰로 결정.
새 서브카테고리는 4개 파일에 동시 등록되어야 정상 동작함. 한 곳이라도 누락되면:
| 누락 | 증상 |
|---|---|
docsGroups.ts 미등록 | /docs/ DocsTree에 표시 안 됨 |
tagColors.ts 미등록 | 태그 색상이 해시 기반으로 결정되어 의도와 무관한 색상 |
astro.config.mjs sidebar 미등록 | 사이드바 자동 생성 누락, 문서 페이지에서 좌측 네비게이션 깨짐 |
index.mdx 미생성 | DocsTree에서 항목 자체가 표시 안 됨 (가시성 판단 기준) |
본 스킬은 이 4지점을 한 번에 일관되게 처리하여 누락 사고를 방지함.
대화 맥락에 이미 답이 있으면 활용하고, 빠진 부분만 질문.
| 항목 | 형식 | 예시 |
|---|---|---|
| key | kebab-case 영문 | elk, postgresql, open-telemetry |
| label | 표시명 (제목 컨벤션 준수) | ELK, PostgreSQL, OpenTelemetry |
| group | 기존 그룹 또는 새 그룹 | Streaming & Observability |
| hue | 0~360 정수 | 175 |
| tag | frontmatter tags 값 (대개 label과 동일) | ELK |
tags 배열 값. 일반적으로 label과 동일.다음 파일을 읽어 현재 상태 파악:
src/data/docsGroups.ts — 기존 그룹·서브카테고리 목록src/data/tagColors.ts — 기존 hue 분포astro.config.mjs sidebar 배열 — 기존 sidebar 엔트리src/content/docs/docs/<key>/ — 디렉토리 존재 여부docsGroups.ts의 그룹 라벨 목록을 사용자에게 제시하고 적합한 그룹 선택. 의미적으로 명확하면 추천을 먼저 제시.
예: "ELK는 Streaming & Observability 그룹이 맞을 것 같음. 동의?"
기존 그룹 어디에도 의미적으로 맞지 않으면 신설 제안. 다음을 사용자와 확정:
신설 가이드:
Database, Framework, Observability)Spring Modules 같은 단일 기술 전용 라벨 X)기존 TAG_HUES 값들 사이의 빈 구간(gap)을 분석해 추천.
| 토픽 유형 | 대표 hue 범위 |
|---|---|
| 데이터베이스 | 다양 (브랜드별) |
| 메시징·스트리밍 | 핑크·마젠타 (~310-340) |
| 관측성·모니터링 | 청록 (~170-200) |
| 인프라·배포 | 파랑·청록 (~200-230) |
| 보안 | 빨강 (~340-360) |
같은 그룹의 다른 서브카테고리와 색상이 너무 비슷하면 (15° 이내) 의도적으로 다른 영역 선택. BlogTree·DocsTree에서 색상으로 구분하기 위함.
추천 hue를 제시하고 사용자가 다른 값을 선호하면 변경. 색상 미리보기는 어렵지만 hue 값과 색상 영역(예: "175 = 청록")을 함께 안내.
확정된 정보로 4개 파일을 한 번에 수정. 각 변경 사항을 사용자에게 미리보기 후 진행.
src/data/docsGroups.ts기존 그룹에 추가:
{ label: '<group label>', items: [
...,
{ key: '<key>', label: '<label>' },
]},
새 그룹 신설:
{ label: '<new group label>', items: [
{ key: '<key>', label: '<label>' },
]},
→ 의미적으로 인접한 그룹 옆에 삽입.
src/data/tagColors.tsTAG_HUES 객체에 추가:
'<tag>': <hue>,
→ 마지막 항목 뒤에 추가.
astro.config.mjssidebar 배열에 추가:
{
label: '<label>',
collapsed: true,
autogenerate: { directory: 'docs/<key>', collapsed: true },
},
→ 같은 그룹의 인접 서브카테고리 옆 또는 알파벳·의미 순으로 배치.
src/content/docs/docs/<key>/index.mdx---
title: <label>
tags: [<tag>]
description: "<한 문장 요약>"
---
import SubcategoryPage from '../../../../components/SubcategoryPage.astro';
<SubcategoryPage subcategory="<key>" />
description 작성은 /description 가이드라인 준수. 작성 시점에 본문이 없으므로 카테고리 전체를 요약하는 1문장 (예: "Kafka의 핵심 아키텍처부터 프로듀서·컨슈머 내부 동작, 복제 메커니즘, 메시지 전달 보장, KRaft까지 정리한다.").
다음 자가 점검 후 결과 보고:
| 항목 | 확인 |
|---|---|
docsGroups.ts에 key 추가됨 | ✅ |
tagColors.ts에 tag·hue 추가됨 | ✅ |
astro.config.mjs sidebar에 엔트리 추가됨 | ✅ |
<key>/index.mdx 생성됨 | ✅ |
| 새 그룹 신설 시 적절한 위치에 삽입 | ✅ (해당 시) |
| description 1문장 작성됨 | ✅ |
## 새 섹션 추가 완료
서브카테고리: <label> (key: <key>)
그룹: <group label> [신설 / 기존]
색상 hue: <hue>
태그: <tag>
변경 파일:
- src/data/docsGroups.ts (그룹 멤버십)
- src/data/tagColors.ts (hue 등록)
- astro.config.mjs (sidebar 엔트리)
- src/content/docs/docs/<key>/index.mdx (랜딩 페이지)
다음 단계:
- [ ] 첫 문서 작성 (`/add docs/<key>` 또는 `/writing` 컨벤션)
- [ ] 문서 추가 시 `docsSections.ts`에 슬러그 등록 (선택)
- [ ] 학습 로드맵이 필요하면 `/roadmap <기술명>`으로 SPEC 파일 작성
$ARGUMENTS 또는 사용자 메시지에서 토픽 추출/structure skill의 데이터 레이어 표 참조. 본 스킬은 그 표의 모든 항목을 한 번에 일관되게 갱신함.
/add — 단일 문서 추가 (Mode 2의 새 카테고리 분기는 본 스킬 호출로 위임 가능)/roadmap — 학습 로드맵 스펙 파일 작성 (서브카테고리 신설 직후 흔히 이어지는 작업)/writing — 문서 콘텐츠 작성 컨벤션/description — index.mdx의 description 작성 가이드라인