docs: 설계 문서를 docs/ 루트로 이동 + 역사적 계획서 본문 복원 - #22
Merged
Conversation
docs/superpowers/ 는 개발 도구 어휘가 경로에 남은 것이었다. 코드와 문서가 이 경로를 참조하는 곳이 세 군데(CLAUDE.md · 개발계획서 · check_licenses.py) 있어 함께 갱신한다. spec 은 바이트 동일 순수 리네임(R100), plan 은 3~4행(에이전트 도구 지시문)만 제거하고 8,225행 본문을 복원(R99). 제출한 개발계획서가 "63개 태스크 완료"를 주장하며 이 문서의 Task 63개·Phase 3개를 근거로 드는데, 11줄 스텁을 커밋하면 그 근거가 저장소에서 사라진다. plan 상단에 문서 지위 노트를 추가했다. 381개 미체크 항목이 현재 미완료 표시가 아니라 TDD 절차 템플릿임을 밝히고, 계획 시점과 현재 코드의 결정 차이(Anthropic→Ollama 기본, Kanana 교체, spaCy·dateparser·korean-number 미탑재)를 선제 설명한다. CLAUDE.md 가 plan 을 "spec 6.8이 가리키는 문서"로 지목하고 있었는데 이는 원래부터 틀렸다 — spec 6.8(임계 & 라우팅)은 spec 254행에 있지 plan 에는 없다. spec 을 정본으로, plan 을 실행 계획으로 각각 가리키도록 정정했다. check_licenses.py 의 시크릿 스캔 제외 경로도 새 이름으로 맞췄다. 틀린 채 본문을 복원하면 플레이스홀더 AWS 키·PEM·주민번호 패턴이 3건 오탐으로 CI 를 깬다. .gitignore 에 _workspace/ 와 *.bak-* 를 추가해 git add -A 지뢰를 제거했다.
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
1 participant
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
무엇을 바꿨나
docs/superpowers/→docs/루트로 설계 문서 2개를 이동했다.참조 갱신:
CLAUDE.md,docs/contest/2026-개발계획서-또박.md,tooling/check_licenses.py.왜 11줄 스텁이 아니라 본문을 복원하는가
제출한 개발계획서가 "63개 태스크 완료"를 주장하며 이 문서를 근거로 든다(
:17,:246).옛 plan에
### Task63개 ·## Phase3개가 실재한다. 11줄 스텁은 그 근거를 없앤다.재구성 동기(도구 이름 노출 제거)는 경로 이동 + 3행 삭제로 달성됐다 — 8,216줄을
지울 이유가 목적 자체에서 나오지 않는다.
상단 지위 노트
381개
- [ ]가 모두 비어 있어 "63개 완료"와 시각적으로 충돌하므로, 이것이 TDD 절차템플릿이지 현재 미완료 표시가 아님을 밝혔다. 계획 시점 서술(Anthropic 기본 / Kanana /
spaCy 등)과 현재 코드의 차이도 선제 설명해 오독을 방지한다.
CLAUDE.md포인터는 원래부터 틀렸다spec 6.8(임계 & 라우팅)은 spec 254행에 있지 plan에 없다. 경로만 바꿨을 뿐가리키는 문서 종류가 처음부터 잘못돼 있었다. 이번에 spec을 정본으로, plan을 실행
계획으로 각각 가리키도록 정정했다.
검증
PASS: license & security audit clean.(경로 오타를 안 고치면 시크릿 오탐 3건으로 FAIL — check_licenses.py:206)
pytest -q→ 427 passedruff check→ cleanpip-licenses→ 70 packages, all allowlisted