Commit Graph
5 Commits
Author SHA1 Message Date
DongHyeonka 6b79e7b39f fix(form): 폼이 mutation을 받아 저장 규칙을 맡고 FormSaveFeedback이 피드백을 그린다
결과 불명 상태를 코디네이터(useApplicationMutation)와 폼(useAppForm)이
따로 갖고, 둘을 맞추는 규칙은 생성 작성 페이지의 사본에 있다: 결과 불명·
다른 저장 중 새 저장 막기, 「변경됨으로 확인」 뒤 settleApplied, 같은 키
재전송, 다른 저장이 도는 동안의 표시. 그래서 플랫폼에서 고친 것(1105/08-02,
1105/08-04, 1106/08-02)이 이미 생성한 기능에 들어가지 않는다(1112/01-01).
같은 구조에서 셋이 더 나온다.

- 재전송이 쓰기 전에 거절되거나(429·503) 선언한 409가 나면 "입력 내용을
  확인해 주세요." 요약 아래 나온다(1112/04-02).
- 폼 밖에서 부른 같은 입력이 NOT_APPLIED로 끝나면 훅은 결과 불명인데 폼은
  다시 시도를 보인다(1106/03-01 ②).
- 필드 이름이 붙은 결과 불명(VALIDATION_REJECTED + MAYBE_APPLIED)이 필드
  오류와 결과 불명 화면을 함께 띄운다(1101/03-04).

고른 방법(R9-D1, 권하는 안으로 정함(2026-11-12, 총괄)): useAppForm에 선택
옵션 mutation을 더한다(추가만). 주면 폼이 saveBlocked로 새 저장을 막고
confirmUnknownEffect·resendUnknownEffect를 내주며, 입력 오류가 아닌 저장
안내를 notice로 둔다. 새 FormSaveFeedback이 결과 불명 → 저장 실패 → 충돌 →
다른 저장 순으로 피드백을 그리고, AsyncSurface의 새 notice 칸에 재전송 거절
안내를 보인다. 결과 불명을 코디네이터 상태로 먼저 보므로 ②도 같은 화면이
된다. 폼은 MAYBE_APPLIED를 입력 오류보다 먼저 본다. 생성 작성 페이지는 이
둘을 쓰고 자기 사본을 지운다. mutation을 주지 않은 폼은 전과 같다. 버린
대안: 판정 hook을 따로 두고 폼은 그대로(사본이 하나 더 생긴다).

위험·한계: 이미 생성한 기능은 바뀌지 않는다. CHANGELOG에 생성 페이지를
옮기는 방법을 적는다. 다시 마운트한 폼이 mutation 없이 쓰이면 ②는 그대로다.
VD-04 결정 5의 범위(선언하지 않은 409만)는 머리 블록에 적었다(1103/03-01 (3)).

검증: tests/component/form-foundation.test.tsx의 새 시험 넷(막기, 확인,
재전송 거절 표면, 결과 불명 우선)과 create-feature.test.ts의 생성 페이지
시험이 고치기 전 코드에서 실패하고 고친 뒤 통과한다. 생성 페이지는
FE-GATE-020 scaffold 드릴과 FE-GATE-008 e2e가 돈다(PR 본문).

Refs: 1112/01-01, 1112/04-02, 1106/03-01, 1101/03-04, 1103/03-01
2026-11-12 23:21:21 +09:00
DongHyeonka 8acf07c2f6 docs(adr): VD-09·11·13을 채택(보완)으로 올리고 보완 절을 단다
문제: 세 결정 기록은 결정한 뒤 본문을 제자리에서 고쳤지만 본문에 날짜가
붙은 보완 메모가 없어, 2026-11-08 머리 블록을 달 때 기계 규칙대로
「채택」이 됐다. 머리 블록은 본문이 결정한 때의 원문이라고 말하지만
실제로는 고친 뒤의 내용이다.

고른 방법: git 이력에서 결정 뒤 본문을 바꾼 커밋을 찾아 상태를
「채택(보완)」으로 올리고, 맨 아래 「보완」 절에 날짜·커밋·바뀐 절을
적는다(docs/README.md 2절). 본문은 고치지 않는다. 처음 커밋한 본문을
보는 git show 명령도 적는다.
- VD-09: 2026-07-30 6c52cdb9(스크립트 경로 .mjs→.ts),
  2026-08-02 92e5cace(결정 6~11번, 도식, 검증, Rollback)
- VD-11: 2026-09-18 ec7f20e2(case 수 고정 문단을 규칙으로 바꿈)
- VD-13: 2026-11-06 02a761f0(Web Storage key 이름을 정본 가리키기로)
6f6c48eb(2026-09-24)는 이력을 다시 시작한 커밋이라 세 본문 모두 그
앞 커밋과 내용이 같다. 그래서 보완에 넣지 않았다.

위험: 둘째 줄 「본문은 결정한 때의 원문이다」는 검사기가 고정한 문구라
그대로다. 보완 절의 첫 인용 블록이 실제 사정을 적는다.

검증: 각 커밋의 diff를 git diff <앞>:<경로> <뒤>:<경로>로 읽었다. 인용한
커밋 다섯 개가 모두 main의 조상이다. 문서 검사는 desktop에서 돌린다.
2026-11-12 09:40:51 +09:00
DongHyeonka 2b8a348c1f docs: 옮긴 VD·계획서 안의 상대 링크를 새 위치로 고친다
문제: 링크를 고친 앞 커밋은 옮긴 파일의 옛 위치를 지금 트리에서
찾았다. 그래서 VD와 superpowers 계획서 안에서 나가는 상대 링크
28개(예: VD-14의 `../../operations/…`)는 옛 위치 기준 그대로 남아
없는 곳을 가리킨다.

고른 방법: 옛 위치를 `git diff --name-status -M ad3a071f HEAD`의 이름
바뀜으로 다시 구해, 옮기기 전에는 풀리던 링크만 새 위치 기준으로 다시
쓴다. 옮기기 전에도 깨져 있던 링크 22개는 쓴 때의 글이라 그대로 둔다.
고친 것은 링크 대상뿐이다.

위험: 없음에 가깝다. 기록 본문의 글자는 바뀌지 않는다.

검증: 같은 스크립트를 다시 돌려 「옮기기 전엔 풀리던 깨진 링크」 0건.
2026-11-08 17:25:41 +09:00
DongHyeonka 75fad73a7d docs(records): 기록·설계서·결정 기록 67개에 한국어 머리 블록을 단다
문제: 옮긴 기록은 지금 동작을 설명하는지, 상태가 무엇인지, 지금
정본이 어디인지 알 길이 없다. 설계서·계획서 27개와 docs/architecture
목표 설계 16개에는 상태 칸이 없고, VD는 「상태: Accepted」 같은 영어
값을 쓴다.

고른 방법: docs-system.md 4절 형식으로 맨 위에 머리 블록을 달고 본문은
한 글자도 고치지 않는다. 상태는 기계 변환이다.
- 설계서: Accepted·확정·정본·설계 완료 → 채택, 상태 줄이 없으면
  확인 안 함 (채택 4, 확인 안 함 21)
- 계획서: 체크 상자가 모두 표시됐으면 끝남, 아니면 확인 안 함. SPEC.md는
  같은 폴더 plan.md와 같은 근거(0.2.0으로 끝난 라운드)로 끝남 (끝남 5,
  확인 안 함 14. 이미 블록이 있던 5개는 그대로)
- 결정 기록: Accepted → 채택, 날짜가 붙은 뒤늦은 보완 메모가 본문에
  있으면 채택(보완) (채택 14, 채택(보완) 9). 프론트 VD는 처음부터
  한국어로 썼고 번역하지 않으므로 둘째 줄은 「원문이다」 문구다.
- 작성일: 파일 이름 날짜 → 본문 날짜 줄(VD는 `결정일:`) → git 첫 추가일.

위험: VD-09·11·13은 git으로 보면 결정 뒤 본문이 그 자리에서
고쳐졌지만 본문에 날짜 표시가 없어 기계 규칙대로 채택으로 두었다.
보완으로 올릴지는 사람이 정한다. 「현재 정본」은 지금 있는 살아 있는
문서나 코드 경로만 쓴다.

검증: 블록과 그 뒤 빈 줄 하나를 빼면 72개 모두 `git show HEAD:`와 바이트가
같다. 뒤 커밋의 문서 검사 head 규칙으로 돌려 문제 0건.
2026-11-08 17:25:41 +09:00
DongHyeonka 99e76e8722 docs: 기록·설계서·결정 기록을 docs/history·docs/design·docs/adr로 옮긴다
문제: 프론트 docs/는 지금 동작을 설명하는 문서와 쓴 때의 기록이 한
폴더에 섞여 있다. docs/architecture/에는 현재 계약 10개와 목표 설계
14개, 결정 기록 VD 23개가 같이 있고, 설계서·계획서는 플러그인 이름
폴더(docs/superpowers/)에 있다. 문서 체계 규칙(design-docs
conventions/docs-system.md v1, 2026-11-07 소유자 결정)은 수명으로
나누고 폴더 이름을 백엔드와 같게 하라고 정한다.

고른 방법: 내용 변경 없이 git mv만 담는다. git이 이름 바뀜을 알아보고
리뷰어가 이동과 내용 변경을 따로 볼 수 있게 하려는 것이다. 참조 수정과
머리 블록은 다음 커밋들이 한다.
- docs/superpowers/specs → docs/design/, plans → docs/history/plans/
- docs/architecture/ 목표 설계 13개와 styling·testing의 목표 설계
  2개 → docs/design/<작성일>-<이름>-design.md (2026-07-30 결정 정본은
  이름 그대로)
- docs/architecture/decisions/VD-* → docs/adr/ (번호 유지)

위험: 이 커밋만으로는 옮긴 문서를 가리키는 링크와 경로가 깨진다.
다음 커밋이 고친다. 게이트가 읽는 파일(review-ledger.json,
review-evidence.md, adapter-remediation-ledger.md, INVENTORY.md)은
옮기지 않았다. docs/history/는 복사한 프로젝트가 지워도 된다는 약속
(tests/unit/deletable-history-documents.test.ts)이 있어서 코드가 읽는
파일을 둘 수 없다. SPEC.md는 공통 완료 기준을 매뉴얼로 옮긴 뒤 따로
옮긴다.

검증: git status가 이름 바뀜(R) 66개만 보인다.
2026-11-08 17:25:41 +09:00