위키독스 분석 보드 — 2026-07-02

이 책은 Godot .NET C#으로 비개발자가 작은 2D 게임을 끝까지 완성·빌드·출시하는 과정을 최소 범위, 단계적 기능 누적, 폴더·에셋 정리, 출시 체크리스트 중심으로 안내하는 입문 실습서다.

이 책은 Godot·게임 개발 자체보다 ‘작은 완성 단위, 입문자 선행 개념, 에셋/폴더 위생, 출시 체크리스트’가 가치다. adopt 후보 3개, improve 3개, skip 2개 — 핵심 가치는 형님 시스템에 없는 게임형 인터랙티브 콘텐츠 제작 루트와 신규 도메인 MVP 축소 템플릿이다.

1. ADOPT 작은 완성 단위 기반 학습 루프
   software-development/plan 또는 writing-plans SKILL에 '첫 산출물은 시작 화면·핵심 상호작용·종료 조건·재시작·배포 형태를 포함한 1개 완성 루프로 제한한다'는 MVP 체크 섹션을 추가한다. 신규 Godot/인터랙티브 콘텐츠 실험용으로 `30. 자원 상자/템플릿/작은 완성 프로젝트 기획서.md`를 만든다.
2. ADOPT Godot .NET C# 기반 인터랙티브 콘텐츠 제작
   새 SKILL `creative/godot-csharp-mini-game`을 만들고 macOS 기준 Godot .NET 설치, `dotnet --version` 확인, 프로젝트 구조, Scene/Node/C# 스크립트, itch.io 또는 웹/데스크톱 빌드 체크리스트를 추가한다. 교육·강의 영역에서는 '게임으로 배우는 자동화/멘탈모델' 실습 콘텐츠로 연결한다.
3. IMPROVE 입문자용 개념 선행 사전
   obsidian-keywords 또는 wikidocs 분석 프롬프트에 '이 책에서 새 도메인 입문자가 먼저 알아야 할 선행 개념 10개와 형님 concept note 매핑' 섹션을 추가한다. Godot 책의 경우 `Godot`, `Node`, `Scene`, `Frame`, `Collision`, `Asset`, `C#`, `2D Game`, `UI`, `Build` concept note 후보를 검토한다.
4. IMPROVE 폴더·파일명 규칙을 초반부터 고정하는 습관
   creative 계열 SKILL 또는 새 Godot SKILL에 `Assets/Images`, `Assets/Sounds/SFX`, `Assets/Sounds/BGM`, `Assets/Fonts`, `Scenes`, `Scripts` 기본 구조와 파일명 규칙을 추가한다. 기존 SPoE 문서에는 별도 변경 불필요하다.
5. ADOPT 출시 전 체크리스트와 itch.io 배포 흐름
   새 Godot SKILL에 `release_checklist.md` 템플릿을 포함한다. 항목은 완성 기준, 실행 파일 생성, 실행 테스트, 폴더 압축, README/소개 문구, 스크린샷 3장, 피드백 링크, 출시 후 버그 로그로 둔다.

이 책은 네이버 클라우드 Ubuntu 서버에 Python/FastAPI 기반 AI TODO 앱을 만들고 OpenAI Responses API, 이미지 입력, 구조화 출력, 함수 호출, 카카오톡 연동으로 실제 챗봇 서비스를 배포하는 초급 실습서다.

이 책은 클라우드·VS Code·초급 API 호출 파트는 대부분 skip이지만, strict JSON Schema, function calling 분리, API Key 보안, Base64 이미지 입력, usage 로깅은 형님 시스템의 정량화·검증·안전 실행 빈자리에 맞는다 — adopt 후보 3개, improve 3개, skip 2개 — 핵심 가치는 '초급 실습 코드를 형님 자동화의 출력 계약·보안·계측 표준으로 끌어올릴 재료'다.

1. IMPROVE OpenAI Responses API 기반 구조화 출력 strict JSON Schema
   templates/agents/wikidocs_analyzer.py의 분석 프롬프트 출력부에 JSON Schema 검증 레이어를 추가한다. 공통 유틸로 templates/agents/structured_output_validator.py를 만들고 one_liner, chapter_summaries, gap_analysis, blog_series_ideas, honest_verdict 필수 키와 gap_analysis 5~8개 조건을 검증한다. 실패 시 harness_integration.run_as_automation의 retry 경로로 재요청하도록 연결한다.
2. IMPROVE 함수 호출을 '실행'이 아니라 '함수명·인자 구조화 생성'으로 분리하는 패턴
   agent_registry.py에 자연어 요청 → {agent_name, args, confidence, reason} JSON 후보를 생성하는 dry-run 라우팅 모드를 추가한다. 실행은 바로 하지 말고 harness_integration.run_as_automation 앞단에서 HARNESS_DOMAIN_REGISTRY.md와 대조해 허용 agent인지 검증한다. 특히 텔레그램·옵시디언·파일쓰기 계열은 Pre-Write Protocol 3단계 흔적을 통과한 뒤 실행한다.
3. ADOPT .env와 API Key 보안 기본기
   pre_write_harness_check.py에 .env, API key, sk-, Bearer token, service account JSON 패턴을 감지하는 secret check를 추가한다. PostToolUse hook의 Write/Edit 경로에서도 .env나 credential 파일이 옵시디언 백링크 처리·블로그 저장 경로로 흘러가지 않도록 blacklist 예외를 둔다. requesting-code-review SKILL의 사전 점검 항목에도 secret scan을 추가한다.
4. IMPROVE 원격 서버 일반 사용자 계정과 root 최소화
   hermes-operations 운영 문서에 '원격 서버 배포 시 root 금지, hermes 전용 사용자, sudo 최소화, 서비스별 system user 분리' 체크리스트를 추가한다. launchd 로컬 작업에는 적용하지 말고, VPS 배포 대상 agent에만 배포 전 점검 항목으로 둔다.
5. ADOPT 이미지 URL·Base64 멀티모달 입력 처리
   templates/agents에 multimodal_input_helper.py를 추가해 local image path → data:image/<type>;base64 변환 함수를 만든다. blog-image의 결과 검수, running-daily의 대시보드 스크린샷 설명, obsidian-blog-saver의 이미지 매핑 검증에서 선택적으로 재사용한다. PostToolUse hook에는 이미지 파일 Write 후 자동 분석을 붙이지 말고 race condition 방지를 위해 수동 호출 SKILL로 둔다.