Vibe Sunsang Growth

Growth - 성장 리포트 생성 스킬 (Codex)

AI 활용 세션 데이터를 분석하여 성장 리포트를 자동 생성 (서브에이전트 위임, 유형별 맞춤, v2 6축 분석)

Codex는 skill-first다 (별도 커맨드 파일 없음). 객관식은 Codex CLI에 카드 UI가 없으므로 $PLUGIN_ROOT/shared/questioning-policy.md §A 번호 블록으로 채팅에서 묻는다.

참조 경로

• 대화 로그: ~/vibe-sunsang/conversations/
• 인덱스: ~/vibe-sunsang/conversations/INDEX.md
• 지식 베이스: $PLUGIN_ROOT/skills/vibe-sunsang-knowledge/references/
• 유형 설정: ~/vibe-sunsang/config/workspace_types.json
• 결과 저장: ~/vibe-sunsang/exports/
• 종단 로그: ~/vibe-sunsang/growth-log/TIMELINE.md
• 분석 지침(서브에이전트용): $PLUGIN_ROOT/skills/vibe-sunsang-growth/references/growth-analyst.md
• 스크립트: $PLUGIN_ROOT/scripts/ensure_workspace.py, analysis_scope.py, convert_sessions.py

실행 방식: sub-agent 분리(선택) 또는 인라인

이 스킬은 대량의 세션 파일을 분석하므로, 가능하면 메인 컨텍스트 보호를 위해 Codex의 multi-agent로 sub-agent를 spawn하여 무거운 분석을 분리한다. Codex 플러그인 스키마에는 별도 에이전트 로스터 파일이 없으므로, 본진 growth-analyst 에이전트의 지침은 references/growth-analyst.md에 임베드되어 있고, 런타임 spawn 프롬프트에서 그 파일을 읽고 따르라고 지시한다.

sub-agent spawn이 불가능하거나 사용자가 인라인을 원하면, 이 스킬이 직접 references/growth-analyst.md를 읽고 그대로 분석을 수행한다 — 동작·산출물은 동일하다.

Step 0: 워크스페이스 자동 치유 (dead-end 방지)

파일 존재만 확인하고 튕기지 않는다. 다음으로 워크스페이스를 스스로 준비한다:

python3 "$PLUGIN_ROOT/scripts/ensure_workspace.py" 2>/dev/null || python "$PLUGIN_ROOT/scripts/ensure_workspace.py"

출력 마지막 줄 STATUS ... CONFIG <present|absent>로 분기:

• v1_migrated → "이전 버전 데이터를 새 구조로 옮겼어요." 한 줄 안내 후 계속.
• CONFIG absent (fresh) → "처음이시네요 — 바로 준비할게요!" 후 vibe-sunsang-onboard로 넘긴다. 여기서 종료하지 말 것.
• 그 외 → 다음 단계.

Step 1: 범위 선택

기본은 "지난 리뷰 이후"다. 먼저 증분 범위를 계산해 사용자에게 무엇이 새로 생겼는지 보여준다:

python3 "$PLUGIN_ROOT/scripts/analysis_scope.py" --new 2>/dev/null || python "$PLUGIN_ROOT/scripts/analysis_scope.py" --new

마지막 줄 SUMMARY total=.. matched=.. new=.. continued=.. watermark=..를 읽는다.

• watermark=none(첫 리뷰)이거나 사용자가 명시적으로 범위를 말한 경우 → 아래 §A 번호 블록으로 범위를 고르게 한다.
• 그 외 → "지난 리뷰({watermark}) 이후 새 세션 {new}개, 이어서 진행한 세션 {continued}개가 있어요. 이걸 바로 분석할까요, 아니면 다른 범위로 볼까요?" 라고 안내한 뒤, 사용자가 다른 범위를 원하지 않으면 증분 범위(analysis_scope가 출력한 md 경로 목록)를 그대로 분석 대상으로 삼는다. matched=0이면 "지난 리뷰 이후 새로 이어간 대화가 없어요. 전체 기간으로 볼까요?"로 안내.

사용자가 다른 범위를 원하거나 첫 리뷰면 shared/questioning-policy.md §A 번호 블록:

질문: 성장 리포트를 어떤 범위로 생성할까요?
1. 최근 2주 (추천) — 일반 리뷰 주기. 세션 트렌드 + 6축 레이더 + 안티패턴 + v2 레벨 판정(Fit Score·게이트) + 행동 계획 (~2분)
2. 이번 주 — 빠른 주간 리뷰 (최근 7일). 세션 요약 + 6축 + 빠른 피드백 (~1분)
3. 이번 달 — 월간 성장 추이 (최근 30일). 6축 심층 + 레벨 변화 + 정체기/돌파구 + 상세 행동 계획 (~3분)
4. 특정 프로젝트 — 선택한 프로젝트의 전체 기간, 해당 유형 맞춤 6축 평가 + 프로젝트별 성장 곡선 (~2분)
(모르면 1번으로 진행하겠습니다)

• 1~3번 → analysis_scope.py --window-days 14|7|30으로 대상 md 목록을 뽑는다.
• 4번 → ~/vibe-sunsang/conversations/INDEX.md에서 프로젝트 목록을 §A 번호 블록으로 보여주고 고르게 한다.

Step 2: 워크스페이스 유형 확인

~/vibe-sunsang/config/workspace_types.json을 읽어 분석 대상 프로젝트의 유형을 확인합니다.

• 특정 프로젝트 분석 → 해당 프로젝트의 유형 사용
• 기간 기반 분석 → 포함된 프로젝트들의 유형 목록 수집
• 유형이 등록되지 않은 프로젝트 → default_type (builder) 사용

Step 3: 증분 변환 (항상 자동 선행)

별도 변환 실행을 요구하지 않는다. 위임 직전 항상 증분 변환을 돌려 이어서 진행한 대화까지 최신화한다(증분이라 이미 최신이면 즉시 끝난다):

python3 "$PLUGIN_ROOT/scripts/convert_sessions.py" --names-file "$HOME/vibe-sunsang/config/project_names.json" --output-dir "$HOME/vibe-sunsang/conversations" 2>/dev/null || python "$PLUGIN_ROOT/scripts/convert_sessions.py" --names-file "$HOME/vibe-sunsang/config/project_names.json" --output-dir "$HOME/vibe-sunsang/conversations"

Step 1에서 증분 범위를 이미 계산했다면, 변환 후 새로 이어진 세션이 반영됐을 수 있으니 analysis_scope.py --new를 한 번 더 돌려 최종 대상 목록을 확정한다.

Step 4: 서브에이전트 위임

사용자에게 진행 상황을 알린 후 sub-agent를 spawn합니다 (Codex multi-agent) — 불가 시 인라인으로 직접 수행.

진행 메시지 (spawn 전 반드시 출력):

"성장 리포트를 생성하고 있습니다. v2 레벨 시스템(6축 기술 차원 분석)으로 세션 데이터를 분석하는 중이니 잠시만 기다려주세요..."

어느 경로든 다음 지침을 반드시 분석 프롬프트로 사용한다:

먼저 $PLUGIN_ROOT/skills/vibe-sunsang-growth/references/growth-analyst.md 를 읽고, 그 지침(Execution Flow 0~8, Output, Language)을 그대로 따라 성장 리포트를 생성해주세요.

- 범위: [파악한 범위]
- [증분 분석인 경우] 분석 대상 세션 파일 목록(analysis_scope --new 출력): [md 경로 목록을 그대로 전달]. 이 목록에 있는 세션만 읽어 분석하세요.
- 워크스페이스 유형: [workspace_types.json에서 파악한 유형 정보]
- 유형별 지식 베이스 경로: $PLUGIN_ROOT/skills/vibe-sunsang-knowledge/references/{type}/
- 공통 지식 베이스: $PLUGIN_ROOT/skills/vibe-sunsang-knowledge/references/common/
- 대화 로그 경로: ~/vibe-sunsang/conversations/

[v2 레벨 시스템 요약 — 상세는 growth-analyst.md]
- 6대 기술 차원(DECOMP/VERIFY/ORCH/FAIL/CTX/META)별로 행동 신호를 감지하세요.
- 유형별 동적 가중치를 적용하세요:
    Builder:  DECOMP 25%, VERIFY 25%, ORCH 15%, FAIL 15%, CTX 10%, META 10%
    Explorer: DECOMP 15%, VERIFY 15%, ORCH 10%, FAIL 20%, CTX 20%, META 20%
    Designer: DECOMP 20%, VERIFY 15%, ORCH 10%, FAIL 10%, CTX 25%, META 20%
    Operator: DECOMP 15%, VERIFY 20%, ORCH 25%, FAIL 20%, CTX 10%, META 10%
- Fit Score 공식: F_L = SUM(w_i * S_i)
- 바닥 효과 보정: 첫 세션 ≥ L1.5, 3세션 + 도구 2종 ≥ L2.0
- 게이트 조건 확인: L3(구체성>0.5), L4(검증>0.15 & 수정>0.05), L5(도구>8 또는 오케스트레이션 & 전략>0.05), L6(멀티에이전트), L7(외부기여)
- 내부 소수점 2자리, 공식 0.5 단위 반올림
- 리포트 파일에는 6축 레이더 차트(텍스트), 레벨 카드, 게이트 상태 테이블 포함
- 승급 시 승급 메시지 포함 (L4→L5는 '80%의 벽' 특별 이벤트)

~/vibe-sunsang/conversations/ 에서 세션 파일을 읽고, 해당 유형의 지식 베이스 기준으로 분석한 후,
~/vibe-sunsang/exports/growth-report-YYYY-MM-DD.md 로 저장해주세요.
대화창 회신은 레벨 헤드라인 1줄 + '다음 한 수' 최대 3개 + 저장 경로만으로 끝내세요.

중요: 유형 정보, 경로, v2 지표 지침을 반드시 전달한다.

Step 5: 결과 전달

서브에이전트가 반환한 결과를 판정 하나 + 할 일 + 경로 순서로 전달합니다:

1. 레벨 헤드라인 한 줄 (## L[X.X] [레벨명], 직전 리포트가 있으면 L[이전] → L[현재])
2. 다음 한 수 — 가장 약한 축부터 최대 3개, 한 줄에 하나
3. 저장된 리포트 파일 경로

대화창에 쓰지 않는 것: 6축 개별 점수, 내부 점수, 가중치, Fit Score·게이트 산식, 레이더 차트, 리포트 본문 재출력. 사용자가 "왜 그 레벨이야", "6축 보여줘", "레이더 보여줘"라고 물으면 그때 답합니다 — 근거는 리포트 파일에 전부 있습니다.

메인 컨텍스트에는 요약만 남기고, 상세 분석은 리포트 파일을 참조하도록 안내합니다.

Step 6: 종단 추적 확인

서브에이전트가 리포트를 저장한 후:

1. ~/vibe-sunsang/growth-log/TIMELINE.md가 업데이트되었는지 확인
2. 업데이트되지 않았으면 수동으로 업데이트 (6축 점수 열 포함):

| 날짜 | 레벨 | DECOMP | VERIFY | ORCH | FAIL | CTX | META | 요청품질 | 주요 안티패턴 | 변화 포인트 |

3. 종단 정보는 Step 5의 헤드라인에 흡수한다 — 별도 요약 블록을 새로 만들지 않는다:
   • 레벨 변화는 헤드라인의 L[이전] → L[현재]로 표현
   • 가장 크게 성장한 축, 해소된 안티패턴은 변화가 있을 때만 한 줄로 덧붙인다
   • "다음 레벨까지"는 다음 한 수 목록이 이미 답한다. 중복해서 쓰지 않는다.

Step 7: 분석 워터마크 갱신

리포트가 정상 저장되면 반드시 워터마크를 전진시켜, 다음 리뷰가 "이번에 본 것 이후"만 잡도록 한다:

python3 "$PLUGIN_ROOT/scripts/analysis_scope.py" --new --mark 2>/dev/null || python "$PLUGIN_ROOT/scripts/analysis_scope.py" --new --mark

리포트 저장에 실패했다면 갱신하지 않는다(다음 실행에서 다시 잡히도록). 사용자가 "전체" 등 임의 범위를 강제한 경우에도 워터마크는 최신 활동 기준으로 전진한다.

Gotchas

• 서브에이전트가 TIMELINE.md 업데이트에 실패할 수 있다. Step 6에서 반드시 확인하고 보완한다.
• 첫 리포트일 경우 종단 요약 대신 "첫 리포트가 생성되었습니다. 다음 리포트부터 6축 성장 추이를 비교할 수 있어요."라고 안내한다.
• v1.x 이전 리포트와의 종단 비교 시 6축 데이터가 없을 수 있다. 이 경우 레벨과 요청 품질만 비교한다.
• 세션 3개 미만이면 과적합하지 말고 리포트를 예비(preliminary)로 표시한다.

에러 처리

문제 발생 시 비개발자가 이해할 수 있게 안내합니다:

Guardrails

• 점수는 객관적 정체성 라벨이 아니라 코칭 신호로 다룬다.
• 보이는 세션 증거를 인용한다. 변환된 로그에 없는 예시를 지어내지 않는다.
• Codex CLI에는 객관식 카드 UI가 없다 → shared/questioning-policy.md §A 번호 블록을 쓴다.