[문서] md 가이드 최소화 — 작업 단위를 이슈로 #1

New Issue

2026-10-27T15:35:41+09:00

msoh1 commented

2026-10-27 15:35:41 +09:00

배경 에이전트는 md 를 처음에 다 읽는다. 지금 에이전트가 읽는 문서가 약 1,400줄(SPEC 615 · FEATURES.json 499 · README 184 · PROGRESS 59 · CLAUDE 37)이다.
할 일

FEATURES.json·PROGRESS.md 삭제 — 할 일은 이슈, 경과는 커밋·닫힌 이슈
SPEC.md 를 지금 지킬 규약(데이터 형식·좌표·단위·검사 원칙·공개 규칙)만 남겨 줄임. 장별 경위는 삭제(git 이력에 남음)
README.md 는 소개·실행·폴더 구조·검사 실행·변환 패키지만
CLAUDE.md 에 세 줄: 작업 목록과 설계 배경은 Gitea 이슈에 있다 / 작업 전에 이슈 제목으로 검색해 그 이슈만 읽는다 / 커밋 메시지에 #이슈번호
1차 기능 46개는 표 하나로 이 이슈 댓글에 남김(제목으로 찾을 수 있게)
완료 기준 md 3개 이하·합계 8KB 이하 · bash check.sh FAIL 0 · 화면 그대로

**배경** 에이전트는 md 를 처음에 다 읽는다. 지금 에이전트가 읽는 문서가 약 1,400줄(SPEC 615 · FEATURES.json 499 · README 184 · PROGRESS 59 · CLAUDE 37)이다. **할 일** - [ ] `FEATURES.json`·`PROGRESS.md` 삭제 — 할 일은 이슈, 경과는 커밋·닫힌 이슈 - [ ] `SPEC.md` 를 지금 지킬 규약(데이터 형식·좌표·단위·검사 원칙·공개 규칙)만 남겨 줄임. 장별 경위는 삭제(git 이력에 남음) - [ ] `README.md` 는 소개·실행·폴더 구조·검사 실행·변환 패키지만 - [ ] `CLAUDE.md` 에 세 줄: 작업 목록과 설계 배경은 Gitea 이슈에 있다 / 작업 전에 이슈 제목으로 검색해 그 이슈만 읽는다 / 커밋 메시지에 `#이슈번호` - [ ] 1차 기능 46개는 표 하나로 이 이슈 댓글에 남김(제목으로 찾을 수 있게) **완료 기준** md 3개 이하·합계 8KB 이하 · `bash check.sh` FAIL 0 · 화면 그대로

msoh1 added the

Priority

High

Kind/Documentation labels 2026-10-27 15:35:41 +09:00

msoh1 referenced this issue from a commit

2026-10-28 11:25:01 +09:00

KIT: 이슈 방식으로 — 새 SPEC·CLAUDE.md, #1 완료 기준 검사 (#1)

msoh1 referenced this issue from a commit

2026-10-28 11:25:01 +09:00

#1 md 가이드 최소화 — README 줄이고 FEATURES·PROGRESS 삭제 (#1)

msoh1 referenced this issue from a commit

2026-10-28 11:25:01 +09:00

#1 README 장 번호·작업 분담 고지 바로잡기 (#1)

msoh1 commented

2026-10-28 11:25:17 +09:00

#1 md 가이드 최소화 — 완료

커밋: bdd2965 (KIT, 새 SPEC·CLAUDE.md) → e5336f6 (md 가이드 최소화) → 3308c27 (README 장 번호·작업 분담 고지 바로잡기) — 모두 main, push 완료

완료 기준 확인

기준	결과	판정
저장소 md 3개 이하	3개 (CLAUDE.md, README.md, SPEC.md)	통과
md 합계 8KB 이하	6,639 B (CLAUDE 1,551 · README 2,751 · SPEC 2,337)	통과
`bash check.sh` FAIL 0	`결과: PASS 153 / FAIL 0 / SKIP 3 (검사 범위 F01~F47)`	통과
화면 그대로	이 커밋은 README.md·FEATURES.json·PROGRESS.md 만 건드림 (index.html·viewer.js·model.js·answer.html 변경 없음, `git show --stat e5336f6`). 코치 확인: 헤드리스 캡처 크기 이전과 동일 (육안 확인은 미실시)	파일 기준 통과

SKIP 3건은 원본 DWG·dwg2dxf 가 이 환경에 없어 건너뛴 변환 검사(SPEC 32장, 옛 설계서 기준 — 9068b6c)다.

경위 한 줄

README 를 소개·실행·파일 구조·다시 만들기(변환 패키지)·검사·사용 도구로 줄이고, check.sh 가 README 에서 보는 낱말(🔒·index.html·answer.html·make_model.sh·model_extracted.js·LibreDWG·dwg2dxf·사용 도구·Haiku·check.sh·evidence/wsl2.txt)을 그대로 남김. FEATURES.json 은 지우기 전에 46개 표로 옮김(아래). PROGRESS.md 삭제. SPEC.md·CLAUDE.md 는 코치 커밋 bdd2965 몫이라 손대지 않음.

1차 기능 46개 (FEATURES.json 에서 옮김, O = 통과)

SPEC 장 번호는 옛 설계서(git 9068b6c) 기준

번호	설명	통과
F01	골격: index.html + viewer.js + model.js 빈 파일, 캔버스가 창을 채운다	O
F02	스파이크 1: 캔버스에 삼각형 하나를 칠한다	O
F03	스파이크 2: 시험용 큐브 하나를 정사 투영, 면 음영, 먼 면부터 그리기로 그린다	O
F04	스파이크 3: 등각 초기 화면 + 마우스 드래그 궤도 회전	O
F05	휠 확대/축소	O
F06	model.js 데이터: 벽, 중간 슬래브 19장, 19B 패드, 하부 슬래브, 바닥콘크리트 (SPEC 4.1~4.3, 5장)	O
F07	disc 그리기: 슬래브·패드·하부 슬래브·바닥콘크리트를 32각형 원판으로, 화면에 모델 전체가 들어오게	O
F08	ring 그리기: 벽체를 32각형 속 빈 원통으로, alpha 0.25 반투명	O
F09	TBM 터널: pipe 데이터(SPEC 4.5) + 누운 속 빈 원통 그리기	O
F10	계단 18런: stair 데이터(SPEC 4.4) + 디딤판 블록 그리기	O
F11	터널 안 채움: fill 3개(잡석, 패드 2단, 패드 1단) 데이터 + 그리기 (일정이 밀리면 가장 먼저 뺀다)	O
F12	README.md: 구동 방법 3줄, 조작법, 모델 설명(구조물·단위), 사용 도구(WSL2·Claude Code Haiku), wsl -l -v 한 줄, 🔒 표기	O
F13	좌우 분할 화면: 왼쪽 도면 칸, 끌어서 움직이는 가운데 막대, 오른쪽 3D (SPEC 10.1)	O
F14	도면 표시·확대·이동: #drawStage 안 img + 겹친 svg, 처음 fit 상자에 맞춤 (SPEC 10.2)	O
F15	도면 클릭 → 3D 강조: MODEL.drawing 데이터 + 부재별 클릭 영역 + 선택 표시 (SPEC 10.3)	O
F16	구동설명서.md: 목적·기획·범위·구동·조작·작업 방식·한계·이력 (SPEC 11.1)	O
F17	README.md 를 코드 설명으로 고쳐 쓰기: 파일 구조·실행·데이터·코드·그리기 방식·도면 연결·검사 (SPEC 11.2)	O
F18	구동설명서를 guide/ HTML 위키(목차 + 8쪽)로 옮기고 3D 칸 오른쪽 위에 「구동 설명서」 버튼 (SPEC 12장)	O
F19	선명한 도면: tools/prep_drawing.py 로 1px 선 SVG 만들기 + 실제 크기로 확대 (SPEC 13.1)	O
F20	모든 그림 연결: MODEL.drawing.views 11개 + 그림별 클릭 영역 + 여러 부재 한 번에 선택 (SPEC 13.2)	O
F21	슬래브 구멍(holes) + 계단 방향 정정 (SPEC 15.1~15.2)	O
F22	카메라 이동: 오른쪽 드래그 팬, 마우스 기준 확대 0.5~40배, 더블클릭·처음 화면 버튼 (SPEC 15.3)	O
F23	사람 애니메이션: 1B~19B 계단을 쉬지 않고 오르내림, 사람 ▶/❚❚ 버튼 (SPEC 15.4)	O
F24	바닥부 부재: 월류벽(prism 3)·집수조·침사조(zone)·사다리(ladder), 19B 슬래브·패드 침사구 구멍 (SPEC 16.1)	O
F25	바닥부 도면 연결: 단면 A-A·20B 평면·19B 침사구 (SPEC 16.2)	O
F26	상부 슬래브·맨홀 목 2개·벽 윗면 −2000·전기 배선구 구멍 정정 (SPEC 17.1)	O
F27	분기구(obox 5)·환기구 덕트와 환기탑(obox 13) (SPEC 17.2)	O
F28	방호 난간 18장·펌프 배출관·위쪽 사다리 2개 (SPEC 17.3)	O
F29	상부 부재 도면 연결: 단면 A-A·평면도 1·2 (SPEC 17.4)	O
F30	사람 두 명이 2초 간격으로 줄지어 이동 (SPEC 18.1)	O
F31	콘크리트 계단: 경사판 밑면, 계단 아래 빈 공간 (SPEC 18.2)	O
F32	구동설명서를 목차 + 목적·구동·조작 3쪽으로 정리, 🔒 줄 빼기 (SPEC 18.3, 코치 작성·하이쿠 커밋)	O
F33	도면 추출 도구 tools/extract_from_dxf.py → model_extracted.js (SPEC 20.1, DXF 입력)	O
F34	대조 검사·변조 시험 통과 + compare.html (SPEC 20.2)	O
F35	계단 18런 추출 → 추출 모델에서도 사람 두 명이 걷는다 (SPEC 21장)	O
F36	정답지 좌표틀 정정 — 평면도 출처 부재를 슬래브 평면 틀로 (SPEC 22장)	O
F37	터널·채움 추출 → 추출 모델에도 TBM 터널 (SPEC 23장)	O
F38	분기구·환기구 추출 → 추출 모델에도 상부 구조 (SPEC 24장)	O
F39	나머지 부재 추출 — 상부 슬래브·목·패드·하부 슬래브·바닥 콘크리트·월류벽·집수조·침사조 (SPEC 25장)	O
F40	정답지 보강 — 환기구 벽 사다리·환기탑 사다리, ladder angle_deg (SPEC 26장)	O
F41	설계 규칙 파일 tools/design_rules.json + 추출 모델이 정답지 부재 전체를 갖는다 (SPEC 27장)	O
F42	변환 패키지 — tools/dwg_to_dxf.sh, tools/select_views.py, tools/make_model.sh (SPEC 28장)	O
F43	DXF → SVG(tools/dxf_to_svg.py) + 도면 연결값을 도면에서 (SPEC 29장)	O
F44	화면 전환 — index.html = 도면에서 만든 모델, answer.html = 정답지 (SPEC 30장)	O
F45	README 「사용 도구」 절 (SPEC 31장)	O
F46	WSL2 설치 증빙 evidence/wsl2.txt (SPEC 33장)	O

**#1 md 가이드 최소화 — 완료** 커밋: `bdd2965` (KIT, 새 SPEC·CLAUDE.md) → `e5336f6` (md 가이드 최소화) → `3308c27` (README 장 번호·작업 분담 고지 바로잡기) — 모두 main, push 완료 ### 완료 기준 확인 | 기준 | 결과 | 판정 | |---|---|---| | 저장소 md 3개 이하 | 3개 (CLAUDE.md, README.md, SPEC.md) | 통과 | | md 합계 8KB 이하 | 6,639 B (CLAUDE 1,551 · README 2,751 · SPEC 2,337) | 통과 | | `bash check.sh` FAIL 0 | `결과: PASS 153 / FAIL 0 / SKIP 3 (검사 범위 F01~F47)` | 통과 | | 화면 그대로 | 이 커밋은 README.md·FEATURES.json·PROGRESS.md 만 건드림 (index.html·viewer.js·model.js·answer.html 변경 없음, `git show --stat e5336f6`). 코치 확인: 헤드리스 캡처 크기 이전과 동일 (육안 확인은 미실시) | 파일 기준 통과 | SKIP 3건은 원본 DWG·dwg2dxf 가 이 환경에 없어 건너뛴 변환 검사(SPEC 32장, 옛 설계서 기준 — 9068b6c)다. ### 경위 한 줄 README 를 소개·실행·파일 구조·다시 만들기(변환 패키지)·검사·사용 도구로 줄이고, check.sh 가 README 에서 보는 낱말(🔒·index.html·answer.html·make_model.sh·model_extracted.js·LibreDWG·dwg2dxf·사용 도구·Haiku·check.sh·evidence/wsl2.txt)을 그대로 남김. FEATURES.json 은 지우기 전에 46개 표로 옮김(아래). PROGRESS.md 삭제. SPEC.md·CLAUDE.md 는 코치 커밋 bdd2965 몫이라 손대지 않음. ### 1차 기능 46개 (FEATURES.json 에서 옮김, O = 통과) SPEC 장 번호는 옛 설계서(git 9068b6c) 기준 | 번호 | 설명 | 통과 | |---|---|---| | F01 | 골격: index.html + viewer.js + model.js 빈 파일, 캔버스가 창을 채운다 | O | | F02 | 스파이크 1: 캔버스에 삼각형 하나를 칠한다 | O | | F03 | 스파이크 2: 시험용 큐브 하나를 정사 투영, 면 음영, 먼 면부터 그리기로 그린다 | O | | F04 | 스파이크 3: 등각 초기 화면 + 마우스 드래그 궤도 회전 | O | | F05 | 휠 확대/축소 | O | | F06 | model.js 데이터: 벽, 중간 슬래브 19장, 19B 패드, 하부 슬래브, 바닥콘크리트 (SPEC 4.1~4.3, 5장) | O | | F07 | disc 그리기: 슬래브·패드·하부 슬래브·바닥콘크리트를 32각형 원판으로, 화면에 모델 전체가 들어오게 | O | | F08 | ring 그리기: 벽체를 32각형 속 빈 원통으로, alpha 0.25 반투명 | O | | F09 | TBM 터널: pipe 데이터(SPEC 4.5) + 누운 속 빈 원통 그리기 | O | | F10 | 계단 18런: stair 데이터(SPEC 4.4) + 디딤판 블록 그리기 | O | | F11 | 터널 안 채움: fill 3개(잡석, 패드 2단, 패드 1단) 데이터 + 그리기 (일정이 밀리면 가장 먼저 뺀다) | O | | F12 | README.md: 구동 방법 3줄, 조작법, 모델 설명(구조물·단위), 사용 도구(WSL2·Claude Code Haiku), wsl -l -v 한 줄, 🔒 표기 | O | | F13 | 좌우 분할 화면: 왼쪽 도면 칸, 끌어서 움직이는 가운데 막대, 오른쪽 3D (SPEC 10.1) | O | | F14 | 도면 표시·확대·이동: #drawStage 안 img + 겹친 svg, 처음 fit 상자에 맞춤 (SPEC 10.2) | O | | F15 | 도면 클릭 → 3D 강조: MODEL.drawing 데이터 + 부재별 클릭 영역 + 선택 표시 (SPEC 10.3) | O | | F16 | 구동설명서.md: 목적·기획·범위·구동·조작·작업 방식·한계·이력 (SPEC 11.1) | O | | F17 | README.md 를 코드 설명으로 고쳐 쓰기: 파일 구조·실행·데이터·코드·그리기 방식·도면 연결·검사 (SPEC 11.2) | O | | F18 | 구동설명서를 guide/ HTML 위키(목차 + 8쪽)로 옮기고 3D 칸 오른쪽 위에 「구동 설명서」 버튼 (SPEC 12장) | O | | F19 | 선명한 도면: tools/prep_drawing.py 로 1px 선 SVG 만들기 + 실제 크기로 확대 (SPEC 13.1) | O | | F20 | 모든 그림 연결: MODEL.drawing.views 11개 + 그림별 클릭 영역 + 여러 부재 한 번에 선택 (SPEC 13.2) | O | | F21 | 슬래브 구멍(holes) + 계단 방향 정정 (SPEC 15.1~15.2) | O | | F22 | 카메라 이동: 오른쪽 드래그 팬, 마우스 기준 확대 0.5~40배, 더블클릭·처음 화면 버튼 (SPEC 15.3) | O | | F23 | 사람 애니메이션: 1B~19B 계단을 쉬지 않고 오르내림, 사람 ▶/❚❚ 버튼 (SPEC 15.4) | O | | F24 | 바닥부 부재: 월류벽(prism 3)·집수조·침사조(zone)·사다리(ladder), 19B 슬래브·패드 침사구 구멍 (SPEC 16.1) | O | | F25 | 바닥부 도면 연결: 단면 A-A·20B 평면·19B 침사구 (SPEC 16.2) | O | | F26 | 상부 슬래브·맨홀 목 2개·벽 윗면 −2000·전기 배선구 구멍 정정 (SPEC 17.1) | O | | F27 | 분기구(obox 5)·환기구 덕트와 환기탑(obox 13) (SPEC 17.2) | O | | F28 | 방호 난간 18장·펌프 배출관·위쪽 사다리 2개 (SPEC 17.3) | O | | F29 | 상부 부재 도면 연결: 단면 A-A·평면도 1·2 (SPEC 17.4) | O | | F30 | 사람 두 명이 2초 간격으로 줄지어 이동 (SPEC 18.1) | O | | F31 | 콘크리트 계단: 경사판 밑면, 계단 아래 빈 공간 (SPEC 18.2) | O | | F32 | 구동설명서를 목차 + 목적·구동·조작 3쪽으로 정리, 🔒 줄 빼기 (SPEC 18.3, 코치 작성·하이쿠 커밋) | O | | F33 | 도면 추출 도구 tools/extract_from_dxf.py → model_extracted.js (SPEC 20.1, DXF 입력) | O | | F34 | 대조 검사·변조 시험 통과 + compare.html (SPEC 20.2) | O | | F35 | 계단 18런 추출 → 추출 모델에서도 사람 두 명이 걷는다 (SPEC 21장) | O | | F36 | 정답지 좌표틀 정정 — 평면도 출처 부재를 슬래브 평면 틀로 (SPEC 22장) | O | | F37 | 터널·채움 추출 → 추출 모델에도 TBM 터널 (SPEC 23장) | O | | F38 | 분기구·환기구 추출 → 추출 모델에도 상부 구조 (SPEC 24장) | O | | F39 | 나머지 부재 추출 — 상부 슬래브·목·패드·하부 슬래브·바닥 콘크리트·월류벽·집수조·침사조 (SPEC 25장) | O | | F40 | 정답지 보강 — 환기구 벽 사다리·환기탑 사다리, ladder angle_deg (SPEC 26장) | O | | F41 | 설계 규칙 파일 tools/design_rules.json + 추출 모델이 정답지 부재 전체를 갖는다 (SPEC 27장) | O | | F42 | 변환 패키지 — tools/dwg_to_dxf.sh, tools/select_views.py, tools/make_model.sh (SPEC 28장) | O | | F43 | DXF → SVG(tools/dxf_to_svg.py) + 도면 연결값을 도면에서 (SPEC 29장) | O | | F44 | 화면 전환 — index.html = 도면에서 만든 모델, answer.html = 정답지 (SPEC 30장) | O | | F45 | README 「사용 도구」 절 (SPEC 31장) | O | | F46 | WSL2 설치 증빙 evidence/wsl2.txt (SPEC 33장) | O |

msoh1 closed this issue

2026-10-28 11:25:20 +09:00

Sign in to join this conversation.

1 Participants

Notifications

Due Date

No due date set.

Dependencies

No dependencies set.

Reference: tdc_engineer/drawing3d-web#1