직전 커밋 산출물에 「Phase 4/5 에서 추가」 문구가 박힌 것을 가 지적했다. 그 문자열은 이번 브랜치에서 쓴 것이 아니라 editor-spec.json 의 description 에 원래 있던 값이고, 새로 만든 생성기가 그것을 문서 앞머리로 옮겨 실으면서 승격된 것이다. 그 필드는 코드가 아니라 사람이 쓴 메모라 실측과 대조되지 않는다. 전수 조사에서 12건 중 5건이 오염돼 있었고, 그중 둘은 바로 아래 실측 표와 정반대를 말했다 — 「controls 는 나중에 추가」라는데 표는 303개가 있다고 한다. 오류도 경고도 나지 않는다: 문서가 자기 자신을 반박한 채로 읽힐 뿐이다. 한 줄 요약은 남기되 실측에서 만든다. 두 표에 흩어진 값을 한 줄로 압축하므로 읽는 쪽이 잃는 것이 없고, 코드에서 파생되므로 어긋날 자리가 사라진다. 도메인 의미는 바로 아래 사람 서술 칸이 이미 담당한다. 스펙 파일의 오염된 메모 5건도 정리했다. 그 파일을 여는 개발자는 문서와 별개로 그 값을 읽고, 확장과 함께 공개 배포된다. 재발 방지는 규정에 명시하고 검사는 두지 않았다 — 어휘를 정규식으로 고정하면 정당한 서술까지 걸리고 목록 밖 표현은 통과해, 「검사했으나 통과」와 「보지 않음」이 구분되지 않는다.
Basic 개발자 문서
templates/_bundled/sirsoft-basic · 템플릿
훅 수: 0 · 구독 훅 수: 0 · 라우트 수: 40 · 모델 수: 0 · 테이블 수: 0 · 마이그레이션 수: 0 · 레이아웃 수: 166 · 핸들러 수: 32
문서 목차
| 문서 | 내용 |
|---|---|
| architecture.md | 설계 의도·계층 지도·디렉토리 맵 |
| components.md | 템플릿이 제공하는 컴포넌트 |
| layouts.md | 레이아웃 목록과 라우트 매핑 |
| handlers.md | 템플릿 전용 핸들러와 부트스트랩 |
| editor-spec.md | 레이아웃 편집기에 선언한 팔레트·컨트롤·샘플 데이터 |
| ../AGENTS.md | 에이전트·확장개발자 진입점 |
| ../README.md | 사람(도입검토자·운영자) 진입점 |