국가건설기준을 이름으로 찾는다 (KDS 설계기준·KCS 표준시방서 등 3,572건).

query: 찾을 말. 띄어쓰기로 나눈 낱말이 모두 들어간 기준을 찾는다. (예: "강구조 부재") code_type: KDS·KCS·SMCS·LHCS·EXCS·KRCCS·KWCS·NHCS·KRACS 중 하나로 좁힌다. 빈 값이면 전체. limit: 최대 건수. domain: 분야. 비우면 교량 이 기본이다 (건축 기준이 딸려 오는 것을 막기 위해). 건축구조물이면 건축 이라고 지정한다. 전체 로 두면 안 가린다.

★분야를 밝히지 않으면 교량으로 봅니다. 결과에 분야를 표시하고, 기본 분야가 아닌 것은 뒤로 미룹니다 — 교량 설계에 건축 기준(KDS 14 3x)을 쓰면 하중조합부터 달라집니다.

※ 이 검색은 기준 이름과 상위 분류만 본다. 본문 속 낱말은 찾지 못한다 (예: "강관"은 본문에 있어도 이름에는 없다). 본문 검색은 kcsc_grep 을 쓴다.

기준의 목차(조항번호 계층)를 낸다. 어느 절을 읽을지 고르는 데 쓴다.

code: KDS 14 31 10 · 14 31 10 · 143110 다 받는다. code_type: 6자리 코드는 종류가 다르면 겹칠 수 있다. 겹치면 여기에 KDS·KCS 등을 지정한다. depth: 몇 단계까지 볼지. 3이면 4.2.1 까지. 0이나 음수면 전부.

기준 원문을 절 단위로 읽는다. 표는 표 그대로 보존된다.

code: KDS 14 31 10 · 143110 등. section: 조항번호. 4.2 를 주면 4.2.x 하위까지 전부 포함한다. 빈 값이면 문서 전체 (대개 매우 길다 — 먼저 kcsc_outline 으로 절을 고르는 편이 낫다). code_type: 코드가 겹칠 때만 지정. max_chars: 출력 상한. 0이면 기본값(KCSC_MAX_CHARS, 기본 20000).

※ 수식·기호는 원문이 이미지라 〔그림〕 으로만 나온다. 이 도구는 식을 지어내지 않는다. 이 원문을 근거로 계산했다면 식은 원문이 아니라 기억에서 온 것이므로, 그 사실을 밝히고 kcsc_audit 으로 인용을 검증할 것.

★그 절의 수식을 이미지 그대로 가져온다. 식을 기억으로 채우지 않아도 된다.

code: 기준 코드 (KDS 14 31 10 등) section: 조항번호. 반드시 좁혀서 지정한다 (예: 4.3.2.1.1.4). 한 절에 이미지가 수십 개다. code_type: 코드가 겹칠 때만 지정. max_images: 최대 이미지 수. 0이면 기본 40.

KCSC 원문의 수식·기호는 텍스트가 아니라 GIF 이미지입니다 (alt 도 MathML 도 없음). 이 도구는 그 이미지를 그대로 돌려줍니다 — 본문의 〔그림 N〕 과 번호가 같습니다.

※ 이미지를 읽는 것도 인식이라 첨자를 잘못 볼 수 있습니다. 다만 설계자가 같은 그림을 볼 수 있어 대조가 됩니다. 기억으로 채운 식은 대조할 대상조차 없습니다. 최종판단은 설계자가 합니다.

기준 본문에서 그 말이 있는 절을 찾는다. kcsc_search 가 못 보는 곳을 본다.

code: 기준 코드. 쉼표로 여러 개를 줄 수 있다 (예: KDS 14 31 10, KDS 14 31 05). 문서를 통째로 받아 훑기 때문에 한 번에 최대 10건까지만 받는다. keyword: 찾을 말. 띄어쓰기로 나눈 낱말이 모두 들어간 절을 찾는다. code_type: 코드가 겹칠 때만 지정. limit: 최대 절 수.

표 안의 글자도 함께 찾는다 — 기준의 값은 대부분 표에 있기 때문이다. 수식은 원문이 이미지라 찾을 수 없다 (〔그림〕 자리). 기호로는 검색되지 않는다.

계산·검토 답변의 인용을 기계로 검증한다. 기준·조항·식 번호·표 번호가 실재하는지 확인.

text: 검증할 답변 글 전체를 그대로 넣는다. 안에서 인용을 뽑아 하나씩 확인한다. code: 기준이 하나뿐인데 글에 안 적혀 있으면 여기에 지정한다.

★구조계산 답변을 냈으면 이 검증을 함께 돌리고 결과를 밝히세요. KCSC 원문은 수식이 이미지라 도구가 읽지 못합니다. 그래서 계산에 쓴 식·계수는 원문에서 온 것이 아니라 모델이 기억으로 채운 것입니다. 맞을 때도 있고 틀릴 때도 있는데, 출력만 봐서는 구분이 안 됩니다. 이 도구는 그 경계를 드러냅니다.

확인하는 것: 기준 실재·버전 · 조항 실재 · 식 번호 실재와 그 식이 몇 절에 있는지 · 표/그림 번호 실재 · 그 조항의 식이 이미지인지 확인하지 못하는 것: 식의 내용 · 그 조항이 이 부재에 맞는지 · 계산이 맞는지

기준의 버전·개정일을 확인한다. 개정 여부를 확인할 때 쓴다.

code: 기준 코드. 쉼표로 여러 개를 줄 수 있다. code_type: 코드가 겹칠 때만 지정.

카탈로그를 새로 받아 확인하므로, 결정트리의 근거 조항을 다시 검증해야 하는지 판단하는 데 쓸 수 있다.

쓸 수 있는 설계 결정트리 목록. 부재·단면·설계법·검증상태를 함께 낸다.

트리는 두 곳에서 읽는다 — 패키지 동봉 예제와 사용자 폴더(~/.kcsc-mcp/flows/*.yaml). 같은 조건이면 사용자 폴더가 이긴다 (각 회사의 트리가 그 회사 기준이다).

트리 이음 지도 — 어느 트리가 어디로 이어지고, 무엇이 아직 없는지 낸다.

구조계산서는 트리 하나로 끝나지 않는다. 휨부재가 "약축"으로 판정되면 약축 트리로, 인장부재가 블록전단 검토로 가면 연결 기준으로 이어져야 한다. 이 도구는 그 연결을 한눈에 보여 주고 끊긴 곳을 목록으로 낸다. 그 목록이 곧 "완성하려면 뭘 더 만들어야 하는가" 다.

부재의 설계 흐름을 단계별로 낸다. 각 단계의 근거 조항 원문을 함께 조회해 붙인다.

member: 부재 (예: 압축부재) shape: 단면 (예: 원형강관) method: 설계법 (예: 한계상태설계법 · 허용응력설계법). ★같은 부재·같은 단면이라도 설계법이 다르면 근거 기준 자체가 다릅니다. 트리가 여럿이면 되묻고, 임의로 고르지 않습니다. with_source: 각 단계의 근거 조항 원문을 함께 낼지. 끄면 흐름만 낸다. excerpt_chars: 단계마다 붙일 원문 길이.

※ 이 도구는 흐름과 근거까지입니다. 값 입력·계산·최종판단은 설계자가 합니다.

빈 단면검토 엑셀을 만들고 파일 경로를 낸다.

member·shape·method: design_flow 와 같다. 설계법이 애매하면 되묻는다. out_path: 저장 위치. 비우면 ~/.kcsc-mcp/sheets/ 에 만든다.

★만드는 것은 빈 템플릿입니다 — 입력 셀·검토 단계·근거 조항·"식이 있는 원문 위치"까지. 계산식과 값은 넣지 않습니다. 수식은 원문이 이미지이고, 넣는 순간 이 도구가 구조계산을 대행하는 것이 됩니다. 값·계산·판정은 설계자가 합니다.

결정트리를 검사한다. ★적어 둔 근거 조항이 실재하는지 API 로 확인한다.

tree_yaml: 검사할 YAML 본문. (또는) path: 검사할 YAML 파일 경로. 둘 다 비우면 사용자 폴더의 트리를 전부 검사한다. check_refs: 근거 조항 실재 확인 여부. 끄면 스키마만 본다(빠르다).

잡아내는 것: · 스키마 누락 · 단계 식별자 중복 · 분기가 없는 단계를 가리키는 것(트리가 끊긴다) · 지어낸/오타난/폐지된 조항번호 — 기준에 그 절·표가 실제로 있는지 확인 · 설계법과 근거 기준의 불일치 (LRFD 트리가 허용응력설계법 기준을 근거로 삼는 등)

트리는 사람이 쓰고, 근거가 실재하는지는 기계가 검사합니다. 지어낸 조항번호가 그대로 남는 것이 제일 위험하기 때문입니다.

확정 트리에 확정 시점 기록(검증일·검증기준)을 박는다.

path: 트리 파일 경로. (또는) all_confirmed: True 면 사용자 폴더의 검증: 설계자확정 트리 전부에 박는다(기록 없는 것만). date: 확정한 날(YYYY-MM-DD). 비우면 오늘.

검증기준 은 트리가 인용하는 기준마다 지금 API 가 주는 판({코드: 버전})이다. 이후 design_validate 가 지금 판과 대조해 기준이 개정되면 "구판으로 확정된 트리" 라고 잡아낸다. 확정 자체가 자동으로 유효하지 않게 되는 것을 놓치지 않기 위한 기록이다.

★기록을 박는 것은 기계지만, 개정된 기준을 다시 확인하는 것은 설계자다.

새 부재용 결정트리 YAML 뼈대를 낸다. 빈 폴더에서 형식을 몰라 못 시작하는 것을 막는다.

member: 부재 (예: 휨부재) shape: 단면 (예: H형강) method: 설계법. 비우면 한계상태설계법(LRFD)으로 채운다 — ★쓰기 전에 반드시 확인하세요.

낸 뼈대를 채워 ~/.kcsc-mcp/flows/ 에 넣고 design_validate 로 검사하세요. 근거로 적은 조항이 실재하는지 그때 기계가 확인합니다.