v1.5.0 환경 준비와 결과 게시

새 프로젝트에서는 Codex가 load_workspace_dependencies로 Python·Node·라이브러리 경로를 확인하고 준비 스크립트를 실행합니다. 아래 명령은 Codex 내부 실행 예시이며 교육생이 복사할 명령이 아닙니다. Python은 찾은 실행 파일을 사용하고 NODE_PATH와 MODULES_PATH는 실제 발견한 경로로 바꿉니다.

python .agents/skills/seed-ir/scripts/prepare_project.py --project . --team "우리팀" --install-missing --node "NODE_PATH" --node-modules "MODULES_PATH"

준비 상태와 실행 경로는 work/setup/runtime.json의 ready, python, node, node_modules에 기록됩니다. 첫 준비에는 인터넷과 Codex의 권한 승인이 필요할 수 있습니다. 실패하면 Codex가 오류를 확인하고 복구하며 교육생에게 터미널 명령을 맡기지 않습니다. 신규 자료 위치는 자료넣는곳이며 기존 프로젝트는 설정된 입력 폴더를 유지합니다.

두 덱의 실제 렌더와 현재 근거를 검수한 뒤 Codex가 다음 명령으로 결과를 모읍니다.

python .agents/skills/seed-ir/scripts/publish_results.py --project .

결과물/날짜-고유ID/에 한글 이름의 PPTX·대본·질문·검수 보고서를 저장하고 결과물/결과보기.html에서 최신 결과를 안내합니다. 현재 원고의 구조 검사, 투자자 검수(pass/revise), 시각 검수(pass), 피칭 검수(pass)와 지문을 확인합니다. 실제 final 검사에 따라 초안 또는 완료로 표시하며, 미검수·오래된 렌더는 게시하지 않습니다.

시각 검수 기록에는 실제로 확인한 렌더 이미지의 render_sha256 맵을 발표본은 기록 루트에, 상세본은 views.master에 각각 저장합니다. 키는 프로젝트 상대 경로, 값은 SHA256이며 실제 PPTX 렌더를 눈으로 확인한 뒤 계산합니다. 실행만으로 시각 검수를 대신할 수 없습니다.

팀마다 새 폴더 하나를 만듭니다. 설치 후에는 그 폴더를 Codex에서 열어 작업합니다.

복합 장표 런타임 확인

설치한 팀 프로젝트에서 Codex에 “PPTX 런타임을 확인해 줘”라고 요청하세요. 아래는 Windows 가상환경 기준이며 macOS/Linux는 첫 경로를 .venv/bin/python으로 바꿉니다.

.venv/Scripts/python.exe .agents/skills/seed-ir/scripts/render_deck.py --check-runtime

사용 가능하면 Node와 artifact-tool 경로를 출력합니다. 없으면 Codex에 load_workspace_dependencies로 번들 경로를 찾도록 요청하세요. SEED_IR_NODE는 Node 실행 파일, SEED_IR_NODE_MODULES는 @oai 폴더를 포함한 node_modules 디렉터리를 가리킵니다. 아래 경로는 직접 확인한 실제 경로로 바꾸는 예시입니다.

$env:SEED_IR_NODE = 'C:\실제경로\node.exe'
$env:SEED_IR_NODE_MODULES = 'C:\실제경로\node_modules'

export SEED_IR_NODE='/실제경로/node'
export SEED_IR_NODE_MODULES='/실제경로/node_modules'

참가신청서와 사업계획서뿐 아니라 인터뷰 기록, 고객·매출 데이터, 실험 결과, 제품 화면, 팀 소개, 견적서도 넣을 수 있습니다. 자료가 갱신되면 기준 날짜와 단위를 함께 남기세요. 사용자 지정 외부 폴더는 읽을 수 있지만, 추적과 검수는 프로젝트 input/ 사본을 기준으로 합니다. 선택한 한 팀만 복사하고 원본은 수정하지 않습니다. 원래 폴더가 바뀌면 사본도 갱신하세요. 여러 팀의 자료를 하나의 덱에 섞지 않습니다.

지원하지 않거나 손상된 파일도 목록에 남습니다. 중복 파일은 SHA256으로 식별하고 같은 내용을 반복 추출하지 않습니다. 대형 파일과 위험한 압축 구조는 제한하고 이유를 기록합니다.

Codex에서 설치된 my-seed-ir 프로젝트를 연 뒤 새 작업을 시작합니다. 아래 내용을 복사하고 필요한 조건만 덧붙이세요.

팀의 단계, 초기 고객, 제품 구현 상태, 제출 마감, 참고 디자인 경로를 추가하면 초안의 초점이 더 분명해집니다. 외부 검색은 환경에 연결된 검색·브라우저 도구로 수행합니다. 원본 이미지·표의 직접 확인에 필요한 도구와 의존성을 먼저 점검하고, 사용할 수 없는 기능은 대기 작업에 남깁니다.

자료를 추가했거나, 중간에 멈췄다면

$seed-ir 현재 상태와 input 변경을 확인하고 미완료 단계부터 재개해 줘. 질문별 답·논거와 상세본·발표본을 함께 갱신하고 영향받는 투자자·시각·피칭 검수를 다시 수행해 줘.

검수 후 수치나 본문이 바뀌면 해당 검수를 다시 해야 합니다. 이전 통과 기록만으로 새 덱의 완료를 판단하지 않습니다.

사용자 지정 순서는 표지 → 문제 배경 및 최근 트렌드 → 문제 정의 → 기존 대체재의 문제점 → 해결방안 → 제품 및 서비스 소개 → 초기 고객 반응 → 수익 모델 → 시장 규모 → 초기 시장 진입 전략 → 성장 전략 → 마일스톤 → 팀 구성 → 비전이다. 문제 정의·기존 대안·제품 소개·초기 시장 진입은 각각 독립 장표 2개 이상, 나머지는 1개 이상으로 master와 pitch 각각 최소 18장을 만든다. 초기 고객 확보와 이후 성장을 분리하며 기존 대안 2장은 문제 정의 뒤·해결방안 앞에 둔다. 이번 교육 범위에서는 투자 요청·조달·금액·사용 계획을 덱·대본·질문에 넣지 않는다. 마일스톤은 목표·일정·산출물·검증 기준으로 구성한다.

장표 제목을 채우기 전에, 투자자가 알고 싶은 것에 답합니다. 아래 항목을 원문·숫자·사진과 함께 준비하세요.

사용자 지정 목차에 정석biz 노하우 작성 원칙을 재배분한 18개 질문입니다. 질문별로 답 → 그 답을 뒷받침하는 논거 → 필수 데이터별 출처 → 장표의 시각자료 → 부족한 자료를 저장합니다. 기준 파일은 deck/section-briefs.json이며, 이미지까지 목차별로 연결한 목록은 evidence/section-map.json입니다.

14목차·목차별 최소 장수는 사용자 지정이며 양쪽 덱은 최소 18장입니다. 정석biz 노하우 질문과 작성 원칙을 새 순서에 재배분했습니다. 300초 기본 배분은 하네스 설계이며 교안의 공식 시간 규칙이 아닙니다.

v1.5.0: 근거 선택부터 실제 화면까지

장표마다 결론·주요 증거·읽는 순서를 먼저 정합니다. 제품은 실제 화면 또는 설계안임을 밝힌 이미지로 사용 순간과 행동을 설명합니다. 외부 이미지가 필요하면 공식 원문과 재사용 권리를 확인합니다. 공개된 이미지라는 이유만으로 배포하지 않습니다.

적절한 사진이 없거나 숫자·관계를 설명해야 할 때는 확인된 데이터를 편집 가능한 표·차트·도식으로 만듭니다. 차트에는 단위·기간·분모·출처를 남기고, 비교는 같은 조건, 시장은 입력과 산식, 일정은 목표·담당·산출물·검증 기준을 연결합니다. 없는 데이터를 채워 시각적 균형을 맞추지 않습니다.

1. 대표 5~8장 시험 제작: 제품 이미지, 공식 수치, 비교, 시장 산식, 사용자 흐름, 마일스톤 등 서로 다른 관계를 선택합니다. 제목과 증거가 먼저 읽히는지 확인한 뒤 나머지 장표로 확장합니다.
2. 양쪽 덱 전장 검수: 내보낸 실제 PPTX를 다시 읽어 렌더하고 상세본·발표본의 각 장을 개별 확인합니다. 글자 넘침·겹침·누락·크롭·차트 라벨에 더해 정보 위계·증거 가독성·연속 구성 변화를 기록합니다. 축소 모아보기나 자동 검사만으로 대체하지 않습니다.
3. 파일과 검수 연결: 실제 검수한 PPTX·렌더의 현재 지문을 남기고, 수정하면 영향받은 검수를 다시 합니다. 동기화 폴더의 일시적 잠금은 작업용 임시 경로와 최종 복사를 구분해 다룹니다. 용량 최적화는 동일 이미지의 참조만 통합하며 이미지 바이트나 장표 내용을 바꾸지 않아야 합니다.

새 AI 제품 설계 갤러리는 제품 콘셉트와 확인·기록·회고 흐름을 설명하는 교육용 보조물입니다. 생성 이미지의 출처·권리·캡션·해시는 examples/sample-assets.json에 있습니다. 실제 구현·고객·의료 효능의 증거는 아닙니다.

기존 상세 20장·발표 18장, 총 38장의 demo-deck·demo-master-deck PPTX/PDF·viewer는 그대로 유지합니다. 새 갤러리가 그 덱에 반영됐거나 기존 예시를 v1.5.0에서 전장 재검수했다고 표시하지 않습니다. 실제 팀의 원문·근거·검수 기록을 공개 예시로 복사하지 않습니다.

v1.5.0 장표 구성과 실제 화면 검수

새 프로젝트는 require_visual_briefs:true를 사용하며 파일 구조 버전은 호환되는 1.2를 유지합니다. Codex가 모든 장표의 핵심 메시지, 주요 블록, 전체 읽는 순서, 의미에 맞는 구성, 선택 이유를 visual_brief에 기록합니다. 원고 단계의 누락은 보완 경고로 남길 수 있지만 디자인과 결과 게시 전에는 구성안과 제품 이미지가 필요합니다.

제품은 원본 화면·사진 또는 가상 설계임을 밝힌 이미지를 확대해 핵심 작동부를 보여 줍니다. 대안은 같은 기준으로 비교하고, 시장은 범위와 계산 입력, 일정은 실행과 검증의 관계로 구성합니다. 없는 결과를 차트로 만들지 않습니다.

실제 PPTX의 모든 장표에서 기존 다섯 오류 검사와 함께 정보 위계, 증거 가독성, 연속 구성 변화를 직접 확인합니다. 발표본과 상세본 각각 visual_observations에 장표별 관찰을, composition_review에 연속 구성 판단을 기록합니다. 자동 검사는 누락·참조·지문을 확인하며 디자인의 설득력을 자동 판정하지 않습니다.

글루코픽 실제 슬라이드 보기 · 발표본 PPTX · 상세본 PPTX · 발표본 PDF · 상세본 PDF

GlucoPic은 교육용 가상 사업입니다. 샘플의 인터뷰·인물·성과·가격·전망은 가상 사례·가정·계획이며, 표현 방식만 참고하고 우리 팀 근거로 대체합니다.

1. 원문
   한 팀의 문서와 사진을 추출합니다. 파일 해시·문단·표·이미지 위치를 남기고 판독이 안 된 자료를 표시합니다.
2. 질문
   14목차·18질문의 답과 논거를 씁니다. 데이터를 먼저 확인하고 거버닝 메시지를 정합니다.
3. 근거
   투자자 관점에서 원문이 주장을 지지하는지 대조합니다. 내부 확인과 외부 조사를 나누고 공식 자료·논문·상충 증거를 검토합니다.
4. 복합 시각화
   표·차트·제품 화면·산식을 함께 구성합니다. 문제–해결 대응, 제품 여정, 경쟁표, 검증 일정처럼 내용의 관계가 보이는 구조를 고릅니다.
5. 상세본
   master에 충분한 설명과 증거를 보존합니다. 최소 18장과 목차별 최소 장수를 지키며 필요한 장표를 추가하고 질문별 논증을 검수합니다.
6. 300초 발표본
   pitch에 핵심 흐름을 선택·압축합니다. 상세본 근거와 연결한 상태로 두 PPTX의 실제 화면과 발표 대본을 검수합니다.

총괄이 정본을 관리하고, 하위 에이전트는 맡은 폴더에 결과를 씁니다. 독립 업무는 기본 최대 3개를 병렬 수행하며 같은 파일을 동시에 덮어쓰지 않습니다.

프로그램은 참조·파일·해시·누락을 검사합니다. 원문이 주장을 실제로 입증하는지, 논리가 타당한지, 화면이 잘 읽히는지는 검수자가 직접 판단해야 합니다. 파일이 있거나 렌더가 생성되었다는 이유만으로 검수 통과를 기록하지 않습니다.

조사는 검색 범위·실제 쿼리·선정과 제외 이유·상충 자료·접근 한계를 남깁니다. 인터넷과 논문 전체의 전수조사 완료를 주장하지 않습니다. 하위 에이전트가 지원되지 않는 환경에서는 순차 역할 검수임을 기록합니다.

아래는 14목차·최소 18장에 맞춘 연습용 시간 예산입니다. 문제 정의·기존 대안·제품 소개·초기 시장 진입은 각각 최소 2장으로 설명합니다. 여러 목차를 한 장에 합쳐 필수 장수를 대신하지 않습니다. 상세본의 설명을 보존한 채 발표본의 흐름과 장표 시간을 조정하세요. 기본 배분은 하네스 제안이며 정석biz 노하우 교안의 공식 시간 규칙이 아닙니다.

제출 전 직접 확인할 여섯 가지

이 체크리스트는 개인 점검용이며 프로젝트의 검수 통과 기록을 변경하지 않습니다.

발표본이 압축한 내용은 상세본의 해당 장표와 연결됩니다. 결과에서 내용이 빠졌다면 상세본과 질문별 원고를 먼저 확인하세요. 실제 렌더·필수 근거·질문 검수가 남아 있으면 초안으로 전달합니다.

• data/raw/원본 목록·본문·이미지·판독 대기와 출처 위치
• evidence/주장별 근거와 14목차별 데이터·이미지·누락 목록
• deck/section-briefs.json18질문의 답·논거·필수 항목별 근거·시각 블록·부족한 자료
• deck/deck.json공통 장표와 master/pitch 순서, 거버닝 메시지·복합 시각 블록
• research/ · reviews/실제 검색, 원문 확인, 투자자·양쪽 화면·피칭 검수
• output/pitch-script.md발표 대본과 시간, 예상 질문 및 상세 근거 위치
• state.json단계와 자료 변경에 따라 다시 필요한 검수

.venv/Scripts/python.exe .agents/skills/seed-ir/scripts/render_deck.py --project . --variant master
.venv/Scripts/python.exe .agents/skills/seed-ir/scripts/render_deck.py --project . --variant pitch

.venv/Scripts/python.exe .agents/skills/seed-ir/scripts/harness.py status --project .
.venv/Scripts/python.exe .agents/skills/seed-ir/scripts/harness.py check --project . --stage final
.venv/Scripts/python.exe .agents/skills/seed-ir/scripts/harness.py finalize --project .

이전 1.0/1.1 프로젝트가 있다면

최신 프로젝트를 준비하고 Codex에 이전 원문·근거를 보존하며 이관해 달라고 요청하세요. 하네스 스크립트의 harness.py migrate --project <기존 프로젝트>는 기존 덱을 백업하고 새 질문 틀을 만듭니다. 설치된 스킬을 자동 갱신하거나 빈 질문을 완성하는 명령은 아니므로 이관 후 다시 검수해야 합니다.

실제 자료를 읽을 때 자주 만나는 함정

• 제품 화면의 숫자는 시연 데이터일 수 있습니다. 가격·점수·사용자 수를 화면에서 읽었다는 사실만으로 실제 매출이나 검증 결과가 되지 않습니다.
• 시장 통계는 분모부터 맞춥니다. 산업 전체 금액이 곧 우리 서비스의 시장은 아닙니다. 복수 응답 비율·기준 연도·대상 업종과 지불 의사 조건을 확인하세요.
• 현재 실적과 이력을 분리합니다. 이전 회사나 참여 프로젝트의 성과는 팀의 관련 경험이 될 수 있지만 현재 회사의 고객·투자 유치 실적은 아닙니다.
• 표를 추출해도 행·열 관계는 확인해야 합니다. HWP 대체 추출에서 문단 순서와 그림 배치가 사라질 수 있습니다. 중요한 숫자는 원본 화면·표와 대조하세요.
• 목표와 현재 성과를 구분합니다. 마일스톤은 일정·담당·산출물·검증 기준을 연결합니다. 없는 결과를 목표 숫자로 꾸며 실제 성과처럼 표시하지 않습니다.
• 개인정보는 IR 근거와 구분합니다. 서명·연락처·증명서의 불필요한 정보는 공개 덱에서 제외하고 사업에 필요한 경력만 확인합니다.

더 자세한 기준