문서

규칙과 MCP

네 층의 규칙(전역 설정, ~/.level11/system.md, AGENT.md, .level11/rules.md), 시스템 프롬프트가 다른 에이전트 프리셋, MCP 서버 연결.

규칙의 네 층

에이전트의 시스템 프롬프트는 LEVEL11의 기본 지침, 환경 정보(워크스페이스 경로, OS, 셸, 날짜), 작업 모드 설명 위에 사용자의 규칙을 층층이 얹어 만듭니다. Rules 도구에서 네 층을 한 화면에서 보고 편집합니다.

위에서 아래로 갈수록 범위가 좁고 구체적입니다. 프롬프트에는 ~/.level11/system.md, AGENT.md, .level11/rules.md, 전역 규칙 순으로 각각 제목이 붙어 들어가므로, 프로젝트에 가까운 규칙일수록 그 프로젝트에서 더 구체적으로 작용합니다. 관례, 금지할 명령, 선호하는 도구 체인 같은 것을 자유 형식으로 적으면 됩니다. 규칙 파일은 모두 내 컴퓨터에만 있고 서버로 올라가지 않습니다.

예를 들어 .level11/rules.md에 이렇게 적을 수 있습니다.

- 패키지 관리자는 pnpm만 쓴다. npm install을 실행하지 않는다.
- 커밋 메시지는 한국어로, 제목 50자 이내.
- src/legacy/ 아래는 읽기만 하고 수정하지 않는다.

에이전트 프리셋

Agents 도구에서 역할별 에이전트를 만듭니다. 각 프리셋은 이름, 시스템 프롬프트, 모델 재정의(또는 세션 모델 사용), 기본 모드(또는 세션 모드 유지)를 가집니다. 프리셋의 시스템 프롬프트는 규칙 층 뒤에 # Agent: <이름> 절로 덧붙습니다. 작성기에서 세션마다 프리셋을 고르고, 작업이 바뀌면 바꿔 씁니다.

내장 프리셋은 다섯 가지입니다.

• Planner: 편집 전에 코드베이스를 조사하고 todo_write로 번호 매긴 구현 계획(고칠 파일, 위험, 검증 방법)을 먼저 세웁니다.
• Code Reviewer: 변경을 읽고 검토 의견을 냅니다.
• Test Writer: 테스트를 작성합니다.
• Docs Writer: 문서를 씁니다.
• 커머스 빌더: 토스페이먼츠·나이스페이·페이플·카페24·NHN Cloud·네이버 클라우드·메가존의 공식 SDK와 REST 관례를 따르고, 시크릿 키는 하드코딩하지 않고 연동에서 주입된 환경 변수를 쓰도록 되어 있습니다. 한국어로 답합니다.

모델 재정의에 local을 넣으면 그 프리셋만 로컬 모델을 씁니다.

MCP 서버

Model Context Protocol 서버는 로컬 프로세스(stdio)로 실행되고, 서버가 내놓는 도구가 그대로 에이전트의 도구가 됩니다. 설정 파일은 ~/.level11/mcp.json입니다.

{
  "mcpServers": {
    "filesystem": { "command": "npx", "args": ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/dir"] },
    "disabled-example": { "command": "my-server", "disabled": true }
  }
}

MCP 도구에서 서버를 추가하거나 켜고 끄고, 연결 상태를 새로고침합니다. 프리셋으로 filesystem(워크스페이스 밖 파일 읽기/쓰기), github(이슈·PR·저장소), playwright(브라우저 자동화), postgres(데이터베이스 질의)를 바로 넣을 수 있습니다. 상태 표시줄에 "MCP: 연결된 수/전체"가 보입니다.

MCP 도구는 빌더 모드에서 호출 전에 승인을 묻고, 자동 실행 모드에서는 묻지 않으며, 채팅 모드에서는 붙지 않습니다. 플러그인과 OAuth 커넥터는 준비 중입니다.