simon-report

simon-report

사전 분석 보고서 작성 스킬. 전문가팀 토론 기반 심층 분석 후 사용자 지정 양식으로 문서를 생성합니다.

자율주행모드 ON 입니다. 여러 Agent와 병행하여 딥하게 조사해주세요. 이 선언은 CLAUDE.md의 모호성 확인 규칙보다 우선한다 — 분석 진행 중 세부 모호함은 스스로 판단해 진행한다. 단, 분석 대상 자체(코드/레포/질문)가 특정되지 않는 수준의 모호함은 시작 전 1회만 확인한다.

Instructions

You are executing the simon-report skill. This skill analyzes a codebase topic using expert team discussions (from simon's domain team structure) and produces a pre-implementation document in the user's chosen format.

This is NOT a post-implementation report. It is a PRE-work analysis document (RFC, 현황 분석, 기술 제안서 등).

도구 제한: 이 스킬은 분석용이다. 프로젝트 소스 코드를 Edit/Write하지 않는다. 보고서 파일(~/claude-reports/)만 Write한다.

Shared Protocols: ~/.claude/skills/_shared/preamble.md 읽기 — Session Isolation, Error Resilience, Forbidden Rules, Agent Teams, Cognitive Independence 공통 프로토콜 포함.

Session Isolation Protocol (확장 — Report 전용)

Report 세션의 SESSION_DIR은 타임스탬프 기반으로 결정한다:

PROJECT_SLUG=$(git rev-parse --show-toplevel | tr '/' '-')
SESSION_ID="report-$(date +%Y%m%d-%H%M%S)"
SESSION_DIR="${HOME}/.claude/projects/${PROJECT_SLUG}/sessions/${SESSION_ID}"
mkdir -p "${SESSION_DIR}/reports"
echo "${SESSION_DIR}" > ~/.claude/.report-readonly-active

Read-Only Guard Hook

report-readonly-guard.sh(PreToolUse, Write|Edit)가 report 세션 중 보고서 디렉토리 밖 파일 수정을 결정론적으로 차단한다. 활성화 방식:

• Startup에서 marker 생성: echo "${SESSION_DIR}" > ~/.claude/.report-readonly-active
• hook은 marker가 존재할 때만 동작하며, {SESSION_DIR}/ 하위와 ~/claude-reports/ 하위만 허용
• 스킬 종료(정상/중단 모두) 시 marker 제거: rm -f ~/.claude/.report-readonly-active

Reference Loading Policy

트리거	읽을 파일
Step 3 Domain Expert 진입	references/domain-teams.md
Step 4-B Document Generation 진입	references/examples.md

Step 0: Input Collection (P-001 AI-First Draft)

0-A: 워크플로 설정 확인

• .claude/workflow/config.yaml이 존재하면 읽기 (language, experts 설정 활용)
• 없으면 기본값 사용 (language: ko)

0-B: AI-First Draft 입력 수집

사용자 요청에서 문서 유형, 분석 주제, 분석 범위를 AI가 자동 추론하고 한 번에 제시한다. 3-4회의 AskUserQuestion을 1회로 축소.