프로젝트 파악 + /his 스킬 분석

질의 원문

프로젝트 파악하고 /his 스킬에 대해 분석해. 그리고 history.md 문서도 읽어

수집 경로와 시점

• 수집 시점: 2026-07-26 KST
• 프로젝트 루트: D:\03.Dev\Projects\11.real_assets
• 확인 파일:
• README.md
• HISTORY.md
• docs/STATUS.md
• docs/analysis/README.md
• .claude/sessions/2026-07-26-realestate-data-system-invest-analysis.md
• C:\Users\progd\.claude\commands\his.md
• C:\Users\progd\.claude\docs\commands\his.md
• C:\Users\progd\.claude\projects\D--03-Dev-Projects-11-real-assets\memory\MEMORY.md
• src/realestate/models.py
• src/realestate/auction/models.py
• src/realestate/auction/rights_engine.py
• src/realestate/auction/parser.py
• src/realestate/cli.py
• .agents/skills/region-invest/SKILL.md
• .claude/skills/region-invest/SKILL.md

데이터 등급

• 1차 로컬 원본: 현재 워크스페이스 파일, 사용자 홈의 Claude command/skill/memory 파일.
• 2차 요약: README.md, docs/STATUS.md, HISTORY.md, .claude/sessions/*.md.
• 미검증: /his command의 실제 Claude 런타임 호출 동작. 본 분석은 파일 규약 분석이며 /his를 실행하지 않았다.

프로젝트 파악

이 저장소는 부동산 투자·경매 분석 Python 툴킷이다. 공식·정형 데이터와 검색·커뮤니티 신호를 모아 투자가치 판단, 진입시점, 자금 마련, 매수/처분 가이드까지 산출한다.

핵심 구조는 세 흐름이다.

• 조건 → 후보 검색: search/criteria.py, search/repository.py, search/ranking.py, search/live.py
• 물건 → 투자 가이드: analysis/, guide/, report/
• 경매 → 권리판단: auction/models.py, auction/rights_engine.py, auction/parser.py, guide/

공유 계약은 src/realestate/models.py와 src/realestate/auction/models.py에 집중되어 있다. Property, Metrics, ScoreResult, AuctionCase, Right, Tenant, CaseAnalysis가 모듈 간 데이터 경계다.

최근 상태(v0.16)는 좌표 기반 자동 점수(analysis/auto_score.py)와 region-invest auto가 추가된 단계다. 테스트 기준은 문서상 python -m pytest -q 144 passed이며, 현재 워크트리는 v0.5 이후 대규모 변경이 아직 커밋되지 않은 상태다.

/his 분석

/his는 현재 Codex 스킬이 아니라 Claude 전역 slash command다. 실행 프롬프트는 C:\Users\progd\.claude\commands\his.md에 있고, 설계 문서는 C:\Users\progd\.claude\docs\commands\his.md에 있다.

실행 프롬프트의 최신 규약은 다음과 같다.

• .claude/sessions/YYYY-MM-DD-<slug>.md: 상세 session log, 원문 증거와 가설 궤적 보존.
• HISTORY.md: 최신 1세션 full, 직전 1세션 10줄 이하 요약, 그 이전은 1줄 인덱스.
• docs/BACKLOG.md 또는 BACKLOG.md: 미완·이월 작업 누적.
• 구형 헤더 LAST_MESSAGE, LAST_MESSAGE_PREV, COVERED_THRU는 폐지.
• HISTORY.md는 자동 로드 비용 때문에 약 8KB 이하 유지.
• session log 작성 후 memory 추출과 무결성 검증을 수행한다.

현재 HISTORY.md 상태:

• 크기: 3,276 bytes로 8KB 예산 이내.
• 최신 세션 로그 링크: .claude/sessions/2026-07-26-realestate-data-system-invest-analysis.md 존재 확인.
• 구형 헤더: LAST_MESSAGE, LAST_MESSAGE_PREV, COVERED_THRU 없음.
• 백로그 포인터: docs/BACKLOG.md 존재.
• 메모리 인덱스: C:\Users\progd\.claude\projects\D--03-Dev-Projects-11-real-assets\memory\MEMORY.md 존재.
• 내용상 첫 /his 기록이며, 직전 세션은 없음으로 표시되어 있다.

발견한 문제

1. ~/.claude/commands/his.md와 ~/.claude/docs/commands/his.md가 어긋난다. 실행 프롬프트는 BACKLOG, memory, 구형 헤더 폐지를 반영하지만 설계 문서는 아직 2-tier, LAST_MESSAGE, COVERED_THRU 설명을 포함한다. 실행 프롬프트를 단일 진실 소스로 봐야 한다.
2. /his는 Codex 스킬 레지스트리에 없다. Codex에서 같은 워크플로를 쓰려면 명령을 포팅하거나, Codex용 skill/command로 별도 등록해야 한다.
3. .agents/skills/region-invest/SKILL.md의 실행 예시가 python .Codex/skills/...로 되어 있어 실제 경로(.agents/skills/...)와 다르다. .claude/skills/region-invest/SKILL.md는 .claude/skills/...로 맞다.
4. HISTORY.md의 현재 상태는 대체로 /his 최신 규약을 잘 따른다. 다만 /his를 실제 실행한 것은 아니므로, 현재 대화 내용이 session log로 추가되지는 않았다.

가정

• 사용자가 말한 /his 스킬은 실제 파일상 ~/.claude/commands/his.md slash command를 뜻한다고 보았다.
• 이번 요청은 /his 실행이 아니라 분석 요청으로 해석했다.

한계·미확인

• Claude 앱에서 slash command가 실제로 어떤 방식으로 호출되는지는 파일 기반으로만 추정했다.
• Codex에서 /his를 직접 호출 가능한지는 현재 도구 목록에 해당 command runtime이 없어 검증하지 않았다.
• 전체 pytest는 실행하지 않았다. 이번 작업은 코드 변경이 아니라 문서·구조 분석이었다.

설계 결정

• 이 분석은 프로젝트 규약에 따라 docs/analysis/에 기록했다.
• /his 관련 기준은 설계 문서보다 최신 실행 프롬프트(~/.claude/commands/his.md)를 우선한다.