---
title: AI에게 건네는 첫 문서 — CMDS System Files
slug: cmds-system-files
date: 2026-08-20T20:50
updated: 2026-08-27
kind: 소개
series: "CMDSPACE 생태계"
seriesOrder: 2
summary: 10,000개 노트 볼트를 떠받치는 규격을 그대로 공개했다. AI 에이전트가 내 볼트에서 일하기 전에 읽는 시스템 파일 여섯 종. 왜 만들었고, 왜 나눠주는가.
---

![설계 도면을 건네는 두 손](/images/cmds-system-files/hero-cmds-system-files.jpg)

같은 AI를 쓰는데 결과가 다르다. 그 차이는 모델이 아니라 맥락의 구조에서 난다. Claude Code든 Codex든, 에이전트가 내 볼트에 처음 들어왔을 때 무엇을 읽게 할 것인가. 그 답이 시스템 파일이다.

[system.cmdspace.work](https://system.cmdspace.work) 는 내 볼트의 운영 규격을 그대로 공개한 사이트다.

## 배포하는 것은 세 묶음이다

**시스템 파일 6종.** 우선순위 순서로 로드되는 규칙 문서들이다. Claude Code 전용 기술 규칙, 다른 코딩 에이전트용 규칙, 시스템 철학과 사용자 컨텍스트, 운영 표준, 카테고리 네비게이션, 시각 산출물 규격. 파일마다 대상 독자가 다르고, 서로 충돌하면 우선순위 숫자가 판정한다.

**공유 규칙 9종.** 들여쓰기, frontmatter 표준, 위키링크, 파일 생성 위치 같은 실무 규칙이다. 시스템 파일이 헌법이라면 이쪽은 시행령이다. 에이전트가 노트 하나를 만들 때마다 실제로 참조하는 층이다.

**슬래시 커맨드 8종.** Connect, Merge, Develop, Share의 지식 생애주기를 명령어로 만들었다. 워크플로가 문서로만 존재하면 잊히지만, 커맨드로 존재하면 실행된다.

## 문서가 아니라 구조를 설계하라

이 규격의 핵심 주장은 단순하다. AI가 자동 정리한 문서를 아무리 쌓아도 좋은 시스템이 되지 않는다. 먼저 필요한 것은 해석의 질서, 즉 스키마다. 이 논증은 [Schema는 Harness다](/posts/schema-is-harness/)에서 길게 폈다. Karpathy의 LLM Wiki가, 그리고 Google Cloud의 OKF가 서로 다른 자리에서 같은 구조에 도착하고 있다는 것이 이 방향의 가장 강한 증거다.

그리고 규격은 공개될 때 강해진다. 내 볼트에서 검증된 규칙이 다른 볼트에서도 작동하는지, 포크한 사람들의 사례가 다시 규격을 다듬는다.

## 그대로 쓰라고 주는 게 아니다

사이트에서 파일 여섯 개를 개별로 읽거나 전체 번들 ZIP을 받아 볼트 루트에 놓으면 된다. 하지만 복사가 목적이 아니다. 파일 안의 경로와 카테고리를 자기 구조로 바꾸는 과정, 그 과정 자체가 자기 볼트의 스키마를 처음으로 명시하는 경험이 된다. 규칙을 옮겨 적다 보면 알게 된다. 내 볼트에는 어떤 규칙이 없었는지.

기술 문서 전체는 [system.cmdspace.work/docs](https://system.cmdspace.work/docs/)에 있다. 시작하기 전에 개념부터 잡고 싶다면 [brain.cmdspace.work](https://brain.cmdspace.work)의 "스키마 우선" 카드부터 읽으면 된다.