독자 수준별 구조 문서와 게이머 입문·전술 안내를 재정비한다

docs/user/commands-and-timing.md

@@ -1,17 +1,20 @@
 # 커맨드와 실행 시기
 
+커맨드는 장수나 국가에 내리는 **행동 명령**입니다. 처음에는 전체 목록을 외우지
+말고 지금 신분과 목적에 맞는 절을 읽으세요. 전쟁 약어는 [모출·모훈사출출 안내](./war-and-orders.md)에 있습니다.
+
 ## 화면의 상태 표시
 
 서버는 내 장수, 도시, 국가와 현재 시점으로 각 커맨드를 사전 평가합니다.
 
-| 표시           | 의미                                                                          |
-| -------------- | ----------------------------------------------------------------------------- |
-| 사용 가능      | 현재 알려진 조건을 만족합니다. 실행 시 다시 검사합니다.                       |
-| 대상 선택 필요 | 도시·장수·국가·수량 같은 입력을 고르면 판정할 수 있습니다.                    |
-| 사용 불가      | 현재 확정된 조건을 만족하지 않으며 이유가 함께 표시됩니다.                    |
-| 정보 부족      | 사전 화면에 없는 실행 context가 필요합니다. 실제 실행 성공을 뜻하지 않습니다. |
+| 표시           | 의미                                                                              |
+| -------------- | --------------------------------------------------------------------------------- |
+| 사용 가능      | 현재 알려진 조건을 만족합니다. 실행 시 다시 검사합니다.                           |
+| 대상 선택 필요 | 도시·장수·국가·수량 같은 입력을 고르면 판정할 수 있습니다.                        |
+| 사용 불가      | 현재 확정된 조건을 만족하지 않으며 이유가 함께 표시됩니다.                        |
+| 정보 부족      | 사전 화면에 없는 실행 시점의 정보가 필요합니다. 실제 실행 성공을 뜻하지 않습니다. |
 
-전체 key와 화면 이름은 [자동 생성 커맨드 목록](./command-catalog.generated.md)에 있습니다.
+전체 명령 이름과 내부 식별자는 [자동 생성 커맨드 목록](./command-catalog.generated.md)에 있습니다.
 
 ## 시기별로 보는 장수 커맨드
 
@@ -60,7 +63,7 @@
 
 ### 외교 상태에 따른 명령
 
-선전포고는 기본 구현에서 scenario 시작 연도보다 적어도 1년 지난 뒤에 허용되며, 대상 국가와의 상태도
+선전포고는 기본 구현에서 시나리오 시작 연도보다 적어도 1년 지난 뒤에 허용되며, 대상 국가와의 상태도
 맞아야 합니다. 종전·불가침·불가침 파기 제안은 현재 외교 관계와 최소 기간을 검사합니다. 상대가 제안을
 수락하는 즉시 행동은 일반 예약 국가 턴과 별도의 승인 흐름으로 처리됩니다.
 
@@ -72,17 +75,17 @@
 
 ### 특수 병종 연구
 
-`event_*연구` 명령은 scenario가 해당 명령을 profile에 넣고 필요한 연구 flag가 아직 없을 때 사용할 수
-있습니다. 군주와 국고 조건을 검사하며 11턴 또는 23턴을 연속으로 쌓은 뒤 비용을 지불하고 병종 사용
-권한을 얻습니다. 소스의 선행 턴 값 11·23은 완료 턴을 포함하지 않으므로 화면에서 필요한 전체 실행은
-각각 12턴·24턴입니다.
+특수 병종 연구 명령은 시나리오가 해당 명령을 서버 설정에 넣고 해당 연구가 아직 완료되지 않았을 때 사용할 수
+있습니다. 군주와 국고 등의 조건을 만족한 상태에서 정해진 횟수만큼 연속으로 실행해야 합니다.
+기본 연구는 완료 턴까지 포함해 12턴 또는 24턴이 필요합니다. 중간에 다른 명령을 넣기 전에
+진행 조건과 남은 횟수를 확인하세요.
 
 ## 보호 기간과 연도
 
-scenario의 `startYear`와 `openingPartYear`가 초반 제한의 기준입니다. 다음은 대표적인 동작이며 서버별
-상수에 따라 실제 연도가 달라집니다.
+시나리오의 시작 연도와 초반 보호 기간이 제한의 기준입니다. 다음은 대표적인 동작이며 서버별
+설정에 따라 실제 연도가 달라집니다.
 
-- 출병은 예약 사전 판단과 실제 실행 모두 보호 기간을 고려합니다.
+- 출병의 예약 가능 시점과 실제 출병 가능 시점은 다를 수 있습니다. 미리 예약했더라도 실행 차례가 보호 기간 안이면 실패할 수 있습니다.
 - 방랑, 의병 모집, 몰수 같은 일부 국가 변화도 초반에는 제한됩니다.
 - 기술 연구의 허용 기술 단계와 임관 인원 제한은 경과 연도에 따라 넓어질 수 있습니다.
 - 선전포고는 시작 직후가 아니라 상대 연도 1 이상에서 가능합니다.
@@ -94,5 +97,5 @@ scenario의 `startYear`와 `openingPartYear`가 초반 제한의 기준입니다
 1. 메인 로그에서 실패 이유를 확인합니다.
 2. 자원·병력, 소속 도시와 보급, 직책, 대상과 외교 상태를 다시 확인합니다.
 3. 여러 턴 뒤 실행될 명령이면 앞선 예턴이 상태를 바꾸는지 살펴봅니다.
-4. command table을 새로 불러와 대상 목록과 가능 상태를 갱신합니다.
-5. 동일 요청을 반복 전송하지 말고 화면이 최신 revision을 받은 뒤 다시 저장해 주세요.
+4. 명령 입력창을 다시 열어 대상 목록과 가능 상태를 갱신합니다.
+5. 동일 요청을 반복 전송하지 말고 화면이 최신 예약 목록을 불러온 뒤 다시 저장해 주세요.

docs/user/economy-and-diplomacy.md

@@ -0,0 +1,75 @@
+# 국가 재정과 외교
+
+일반 장수도 세금과 외교의 뜻을 알면 국가 지시를 이해하기 쉬워집니다. 설정을
+직접 바꾸는 일은 군주·담당 직책의 권한이 필요합니다.
+
+## 세율과 지급률은 다릅니다
+
+**세율**은 국가가 도시에서 거둘 수입과 주민·내정 변화에 영향을 줍니다.
+**지급률**은 장수에게 나눠 주는 봉급 쪽 설정입니다. 세율 30%를 “군주가
+내 돈의 30%를 가져간다”거나, 지급률 200%를 “국가 수입이 두 배”라는 뜻으로
+읽으면 안 됩니다. 도시의 인구·농업·상업·민심과 국가 설정을 함께 봐야 합니다.
+
+## 왜 세율 5%와 30%를 이야기하나요?
+
+세율을 낮추면 당장 걷는 수입은 적지만 도시를 회복·성장시키기 좋고, 높이면
+더 걷는 대신 도시 상태에 부담을 줍니다. 다음은 현재 기본 반기 처리의 비교입니다.
+서버별 특수 효과, 도시 최대치, 반올림과 별도 인구 증가가 최종 수치를 바꿀 수 있습니다.
+
+| 기본 처리에서 비교                      | 5%      | 30%           |
+| --------------------------------------- | ------- | ------------- |
+| 같은 도시 상태에서 세율에 비례하는 수입 | 낮음    | 높음          |
+| 내정치의 세율 보정                      | +7.5%   | −5%           |
+| 민심 변화                               | +15     | −10           |
+| 인구의 세율 보정 방향                   | 증가 쪽 | 비례 증가분 0 |
+
+내정은 이 보정 전에 기본 1% 감소도 거칩니다. 따라서 5%일 때 최종 내정이
+무조건 7.5% 증가하는 것은 아닙니다. 30%에서 인구 비례 증가분이 0이어도 별도
+기본 증가량이 있으므로 “인구가 전혀 늘지 않는다”는 뜻이 아닙니다.
+
+나라가 가난한지, 전쟁 중인지, 도시가 충분히 성장했는지에 따라 판단이 달라집니다.
+[10기 회고](https://sam.hided.net/xe/community/15146)에는 5% 세율과 높은 지급률로도
+재정이 넉넉했던 사례가 있지만, 당시 나라 사정과 규칙에 따른 경험담입니다.
+이를 모든 기수에 통하는 추천값으로 보지 마세요.
+
+## 바꾸는 시점도 중요합니다
+
+현재 구현은 월이 바뀔 때 적용할 세율을 따로 확정해 수입·반기 처리에 사용합니다.
+화면에서 변경한 값이 이미 처리 중인 정산에 소급 적용되지는 않습니다.
+월 변경 직전 접속해서 무조건 원하는 결과를 얻을 수 있다고 가정하지 마세요.
+
+세율 담당자는 현재 설정, 다음 정산, 적용 결과와 국가 재정을 함께 확인합니다.
+일반 장수라면 임의 변경보다 “모병비가 부족하다”, “이 도시의 인구가 줄었다”처럼
+현재 문제를 알리는 편이 좋습니다. 계산·적용 시점의 코드 근거는
+[자료 안내](./sources.md)에 모았습니다.
+
+## 불가침·선포·개전·종전
+
+**불가침**은 정한 기간 서로 공격하지 않는 관계입니다. **선포**는 선전포고를
+줄인 말이고, **개전**은 실제 전쟁이 시작되는 시점입니다. 선포가 처리됐다고
+그 즉시 아무 도시로나 출병할 수 있다고 가정하지 마세요. 외교 화면의 관계·시각과
+출병 조건을 확인합니다. **종전**은 전쟁을 끝내는 합의입니다.
+
+제안을 보낸 것과 상대가 수락한 것은 다릅니다. 합의가 필요하다면 수락 결과까지
+확인하세요. 국가가 멸망하거나 직책·관계가 바뀌면 이전 제안을 처리할 수 없을 수도
+있습니다.
+
+## 최후 2국 외교는 자동 승리 규칙이 아닙니다
+
+**최후 2국**은 마지막에 두 나라만 남은 상황을 뜻하기도 하고, 두 나라가 마지막까지
+서로를 남겨 두자는 장기 외교 약속을 뜻하기도 합니다. 게시판이나 대화에서 어느
+의미로 쓰였는지 먼저 구분해야 합니다.
+
+“최후 2국 하자” 한 문장만으로는 원조, 다른 나라와의 전쟁 참여, 땅 교환과 길
+열어 주기, 약속 종료 시점이 정해지지 않습니다.
+[외교 옵션 건의](https://sam.hided.net/xe/devel/12712)는 이런 포괄적 표현의 모호함을
+지적했습니다. 이것은 당시의 제안 글이며, 그 글의 모든 문장이 현재 서버의 공식
+운영 규칙이라는 뜻은 아닙니다.
+
+실제로 외교를 맡았다면 기간, 공격 관계, 원조, 땅·통로, 상황이 달라졌을 때의
+처리를 구체적으로 협의하고 게임 안 외교 문서에 남깁니다. 게임의 불가침 설정과
+사람 사이의 추가 약속은 구별해서 확인해야 합니다. 최후 2국이라는 약속만으로
+두 나라가 공동 통일하거나 서버가 자동으로 약속을 집행하지는 않습니다.
+
+처음 참가한 장수라면 국가가 합의한 공격 목표를 따르고, 다른 나라에 나라 전체를
+대표하는 약속을 하기 전에 담당자에게 알려 주세요.

docs/user/general-and-city.md

@@ -0,0 +1,65 @@
+# 장수와 도시, 내정
+
+[첫 안내](./index.md)를 읽었다면 이제 내 화면의 숫자를 살펴봅시다.
+모든 수치를 외우기보다 “어떤 일을 하려는데 무엇이 부족한가”를 찾으면 됩니다.
+
+## 장수의 능력과 자원
+
+| 항목      | 처음에는 이렇게 이해하세요                          |
+| --------- | --------------------------------------------------- |
+| 통솔      | 이끌 수 있는 병력 규모와 관련된 능력                |
+| 무력      | 무장을 중심으로 한 전투와 관련된 능력               |
+| 지력      | 지장을 중심으로 한 전투·내정과 관련된 능력          |
+| 금        | 모병, 장비, 내정 등 행동에 쓰는 돈                  |
+| 쌀·군량   | 병력을 운용하고 전쟁을 이어 가는 식량               |
+| 병력      | 현재 이끌고 있는 병사의 수                          |
+| 훈련·사기 | 지금 병력이 얼마나 싸울 준비가 되었는지 나타내는 값 |
+| 숙련도    | 병종별 전투 경험과 관련된 값                        |
+| 특기·장비 | 특정 행동이나 전투에 영향을 주는 추가 효과          |
+
+능력치만 비슷하다고 전투력이 같지는 않습니다. 병종, 병력 수, 훈련·사기,
+숙련도, 특기, 장비, 부상과 전투 상황이 함께 작용합니다. 모병으로 병사를 채우는
+일과 훈련·사기로 전투 준비를 하는 일도 다릅니다.
+
+**무장**은 무력을, **지장**은 지력을 중심으로 키우는 장수를 가리키는 말입니다.
+국가가 원하는 역할과 접속 가능한 시간을 먼저 상의하면 능력 배분과 할 일을 정하기
+쉽습니다. 전쟁에 자주 접속하지 못해도 내정과 예약 행동으로 기여할 수 있습니다.
+
+## 도시는 나라의 생활 기반입니다
+
+도시는 병사를 모을 주민, 수입을 만드는 농업·상업, 치안과 방어 시설을 가집니다.
+이것들을 돌보는 일을 **내정**이라고 합니다. 지도에 우리 색의 도시가 많아도
+주민과 내정이 무너지면 전쟁을 오래 이어 가기 어렵습니다.
+
+| 행동                | 목적                            | 먼저 볼 것                           |
+| ------------------- | ------------------------------- | ------------------------------------ |
+| 농지 개간           | 농업을 올려 식량 생산 기반 마련 | 농업이 이미 최대인지                 |
+| 상업 투자           | 상업을 올려 금 수입 기반 마련   | 상업이 이미 최대인지                 |
+| 치안 강화           | 도시의 치안 개선                | 현재 치안과 국가 지시                |
+| 정착 장려           | 주민 확보                       | 현재 인구와 최대 인구                |
+| 성벽 보수·수비 강화 | 도시 방어 준비                  | 전선이 될 도시인지, 부족한 방어 수치 |
+| 기술 연구           | 국가의 기술 발전                | 허용 기술 단계와 필요한 자원         |
+
+현재 도시와 소속 국가, 보급, 비용 등의 조건을 만족해야 합니다. 이미 최대인
+항목만 계속 예약하면 원하는 성과를 얻지 못할 수 있으니 다른 도시나 일을
+국가에 물어보세요. [명령별 조건](./commands-and-timing.md)에서 확인할 수 있습니다.
+
+## 내 금·쌀과 국고는 다릅니다
+
+국가가 부유해도 내 장수의 돈이 부족할 수 있습니다. 국고에서 장수에게 자원을
+나누는 **포상**, 장수의 자원을 국가로 모으는 **몰수**, 나라 사이의 **원조**는
+대상과 권한이 다릅니다. 전쟁 중 모병이 막혔다면 “돈이 없어요”보다
+“어느 도시에서 어떤 병종을 몇 명 모으려는데 금이 부족합니다”라고 알려 주세요.
+
+봉급과 세금은 [국가 재정](./economy-and-diplomacy.md)에서 이어 설명합니다.
+장비 구매·경매·유니크 획득은 서로 다른 경로입니다. **유니크**는 특별한 장비를
+부르는 말이며, 모든 서버에서 원하는 장비를 즉시 살 수 있다는 뜻은 아닙니다.
+
+## 처음 막혔을 때
+
+내정이 실패하면 현재 도시가 우리 땅인지, 보급이 되는지, 비용이 있는지, 수치가
+이미 최대인지부터 봅니다. 전쟁으로 도시 주인이 바뀌거나 발령으로 위치가 달라졌다면
+이전 예턴이 지금 상태에 맞지 않을 수 있습니다. 행동 기록의 실패 이유를 읽고
+가까운 예약부터 다시 정하세요.
+
+다음은 [시간과 턴](./time-and-turns.md)입니다.

docs/user/glossary.md

@@ -0,0 +1,116 @@
+# 국가 메시지와 게시판 용어 사전
+
+모르는 말이 나오면 여기서 찾고, 자세한 행동은 연결한 안내를 읽으세요.
+**기본 용어**는 화면·명령의 뜻, **커뮤니티 표현**은 이용자들이 줄여 부르는 말입니다.
+전략 표현 자체가 별도 게임 기능이나 운영 규칙을 뜻하지는 않습니다.
+조사한 글과 현재 코드의 구분은 [자료 안내](./sources.md)에 있습니다.
+
+## 참가와 역할
+
+| 말            | 뜻                                                                      |
+| ------------- | ----------------------------------------------------------------------- |
+| 삼모          | 삼국지 모의전투의 줄임말                                                |
+| 기수·깃수     | 시작부터 종료까지 한 차례 진행하는 게임                                 |
+| 천통          | 천하통일. 나라가 통일을 이루는 것                                       |
+| 군주          | 국가를 이끄는 장수                                                      |
+| 수뇌          | 국가 운영을 맡는 주요 직책의 장수들을 묶어 부르는 말                    |
+| 사령턴·국가턴 | 권한을 가진 장수가 넣는 국가 명령의 예약 턴                             |
+| 무장·지장     | 무력 또는 지력을 중심으로 키우는 장수                                   |
+| 무지장        | 무력과 지력을 함께 중심으로 둔 장수라는 표현                            |
+| 유저장        | 사람이 맡는 장수                                                        |
+| NPC·엔장      | 컴퓨터가 행동을 정하는 장수                                             |
+| 빙의          | 허용된 기존 NPC를 이용자가 맡는 참가 방식                               |
+| 임관          | 나라에 들어가 소속 장수가 되는 것                                       |
+| 랜임          | 무작위 임관. 나라를 직접 고르지 않는 임관                               |
+| 지정임관      | 특정 나라를 골라 들어가는 임관을 가리키는 말                            |
+| 선약          | 함께 참가하기로 미리 한 약속. 서버의 가입 제한보다 우선하는 기능은 아님 |
+| 재야          | 소속 국가가 없는 장수 상태                                              |
+| 하야          | 관직·소속을 내려놓고 나라를 떠나는 명령                                 |
+| 방랑          | 도시를 가진 정착 국가와 다른 국가 상태. 단순 장수 이동과 구분           |
+| 열전          | 기수가 끝난 뒤 활동과 이야기를 회고한 글, 또는 장수의 이력              |
+
+역할과 참가의 실제 사용례는 [97기 장수열전](https://sam.hided.net/xe/community/78162)과
+[43기 국가열전](https://sam.hided.net/xe/community/25102)에서 확인했습니다.
+
+## 소통과 접속
+
+| 말               | 뜻                                                                                                                         |
+| ---------------- | -------------------------------------------------------------------------------------------------------------------------- |
+| 예턴             | 예약 턴. 접속하지 않는 동안에도 순서대로 실행할 행동 목록                                                                  |
+| 실접             | 실제로 접속해 상황을 보며 조작하는 것                                                                                      |
+| 국메·국가 메시지 | 같은 나라에 보내는 메시지                                                                                                  |
+| 갠메·개인 메시지 | 특정 사람에게 보내는 메시지. 글에 따라 갠매로도 씀                                                                         |
+| 전메·전체 메시지 | 전체 이용자에게 보이는 메시지                                                                                              |
+| 국톡             | 국가 구성원의 외부 단체 대화방을 가리키는 말                                                                               |
+| 국방             | 문맥상 국가방침의 줄임말일 수 있음. “국가 방어”라는 보통 뜻과 구분                                                         |
+| 호출             | 상황에 맞춰 접속·행동을 부탁하는 말                                                                                        |
+| 삭턴             | 화면에서는 장수 삭제까지의 남은 턴과 관련된 값. 대화의 “삭턴 난다”는 명령 실패 등으로 행동 기회를 낭비한다는 뜻으로도 쓰임 |
+| 벌점             | 활동 상태와 관련해 표시하는 값. 정확한 조건은 현재 화면 안내를 확인하고, 운영 제재와 같은 것으로 단정하지 않음             |
+
+[뉴비 질문 모음](https://sam.hided.net/xe/community/51784)에는 삭턴·벌점 질문이,
+[97기 회고](https://sam.hided.net/xe/community/78162)에는 실패를 피하려고 발령과 경로를
+조정하는 맥락의 삭턴 표현이 나옵니다. 같은 단어라도 문맥을 확인하세요.
+
+## 내정과 자원
+
+| 말          | 뜻                                                              |
+| ----------- | --------------------------------------------------------------- |
+| 내정        | 농업·상업·치안·인구·방어·기술 등 나라의 기반을 돌보는 행동      |
+| 농상        | 농업과 상업을 함께 부르는 말                                    |
+| 기연        | 기술 연구                                                       |
+| 금쌀        | 금과 쌀을 함께 부르는 말                                        |
+| 국고·군량   | 국가의 돈·식량. 내 장수의 금·쌀과 구분                          |
+| 포상        | 국가 자원을 장수에게 지급하는 명령                              |
+| 몰수        | 장수 자원을 국가로 회수하는 명령                                |
+| 원조        | 나라 사이에 물자를 보내는 물자 원조                             |
+| 물조        | 물자조달. 장수가 자원을 마련하는 내정 명령으로 물자 원조와 다름 |
+| 세율        | 수입과 주민·내정 변화에 영향을 주는 국가 설정                   |
+| 지급률      | 장수 봉급 지급과 관련된 국가 설정                               |
+| 유니크·유닉 | 특별한 장비를 부르는 말                                         |
+| 유산        | 기수를 넘겨 활용하는 포인트와 그 기능. 현재 소지 금·쌀과 다름   |
+| 템          | 아이템·장비                                                     |
+
+금·쌀이 어디에 쓰이는지는 [장수와 도시](./general-and-city.md), 세율 5%·30%의
+차이는 [재정 안내](./economy-and-diplomacy.md)를 읽으세요. 기연·유니크·유산의
+사용례는 [97기 회고](https://sam.hided.net/xe/community/78162)에 있습니다.
+
+## 전쟁과 지도
+
+| 말             | 뜻                                                                     |
+| -------------- | ---------------------------------------------------------------------- |
+| 모·징·훈·사·출 | 각각 모병·징병·훈련·사기 진작·출병                                     |
+| 모출·모출출    | 모병 후 출병 한 번 또는 두 번을 예약하는 표현                          |
+| 모훈사출출     | 모병 → 훈련 → 사기 진작 → 출병 → 출병                                  |
+| 징훈훈사사     | 징병 뒤 훈련 두 번과 사기 진작 두 번                                   |
+| 풀훈사         | 훈련·사기를 충분히 채운 병력 상태                                      |
+| 양파·모병양파  | 병력을 반복 보충하면서 수비를 이어 가는 방식                           |
+| 점사           | 특정 목표·시점에 공격을 집중하는 전술                                  |
+| 턴 정렬        | 동료의 행동·공격 순서를 맞추는 것                                      |
+| 병종 저격      | 상대에게 유리한 상성의 병종으로 싸우려는 것. 특기 “저격”과 구분        |
+| 수비 켬끔      | 수비 참여를 켜고 끄며 전투 참여를 조절하는 플레이                      |
+| 땅따           | 땅따먹기. 특히 초반 공백지를 선점하는 확장 경쟁                        |
+| 공백지         | 어느 나라에도 속하지 않은 도시                                         |
+| 접경·전선·후방 | 다른 나라와 닿는 곳·전쟁이 벌어지는 곳·그 뒤의 지역                    |
+| 깃 끊기        | 수도에서 이어지는 보급 연결을 끊는 전술                                |
+| 길막·길 열기   | 진출할 통로를 차지해 막거나, 지나갈 수 있도록 조정하는 것              |
+| 수복           | 빼앗긴 도시를 되찾는 것                                                |
+| 발령           | 국가 명령으로 장수·부대의 배치를 바꾸는 것                             |
+| 집합·집합장    | 부대원을 모으는 행동·이를 맡는 장수. 병사 한 명을 뜻하지 않음          |
+| 쟁·연쟁        | 전쟁·연속되는 전쟁                                                     |
+| 다굴           | 여러 나라가 한 나라를 함께 공격하는 상황을 가리키는 표현               |
+| 선포           | 선전포고                                                               |
+| 불가침         | 정한 기간 서로 공격하지 않는 관계                                      |
+| 최후 2국       | 마지막 남은 두 나라 또는 그때까지 서로 남겨 두자는 외교 약속           |
+| 의병           | 의병 모집으로 동원하는 전력. 일반 모병과 구분                          |
+| 필즉·백동      | 국가 전략 명령인 필사즉생·백성 동원의 줄임말                           |
+| 전금           | 전쟁 금지 방침을 줄여 부르는 말. 적용 대상·설정 범위를 확인            |
+| 살상률·교환비  | 적에게 준 병력 손실과 내가 입은 손실을 비교하는 지표·표현. 승률과 다름 |
+
+조합과 수비는 [전쟁 안내](./war-and-orders.md), 보급과 땅따는
+[지도 안내](./map-and-supply.md), 최후 2국은 [외교 안내](./economy-and-diplomacy.md)에서
+사례와 주의점을 설명합니다. [70기 전쟁 회고](https://sam.hided.net/xe/community/47834)는
+양파·발령·다굴·전쟁 금지·필즉의 사용 맥락을,
+[99기 국가열전](https://sam.hided.net/xe/community/79329)은 외교·의병·전금·백동의 맥락을
+보여 줍니다. 사전의 설명은 원문을 그대로 옮긴 것이 아니라 처음 읽는 사람을 위한 풀이입니다.
+
+물조의 역사적 사용례는 [물조 명성 관련 건의](https://sam.hided.net/xe/devel/2569)에 있습니다. 당시 보상 변경 제안을 현재 효과로 읽지 마세요.

docs/user/index.md

@@ -1,37 +1,58 @@
-# 플레이어 가이드
+# 삼국지 모의전투, 처음부터 시작하기
 
-core2026에서는 지금 누르는 버튼이 즉시 모든 결과를 만드는 것이 아니라, 많은 행동을 **예턴**에 넣고 내
-장수의 다음 턴에 실행합니다. 국가 커맨드도 같은 방식이지만 군주·직책과 국가 상태에 따라 이용 범위가
-달라집니다.
+삼국지 모의전투는 **여러 사람이 장수 한 명씩을 맡아, 같은 나라를 키우고 다른 나라와
+경쟁하는 웹 전쟁 게임**입니다. 삼국지 소설이나 프로그래밍을 몰라도 시작할 수 있습니다.
+혼자 나라의 모든 병사를 움직이는 게임과 달리, 동료들과 역할과 행동 시간을 맞추는
+일이 중요합니다. 직접 싸우는 사람도, 돈과 식량을 마련하는 사람도 나라에 필요합니다.
 
-## 처음 접속했을 때
+## 내가 움직이는 것은 장수 한 명입니다
 
-1. Gateway에서 로그인하고 열려 있는 서버 profile을 선택합니다.
-2. 게임에 장수가 없다면 장수 생성·참가 화면에서 이름, 능력치 등 필요한 정보를 정합니다.
-3. 메인 화면에서 현재 도시·국가·자원·다음 턴 시각을 확인합니다.
-4. 예턴 목록의 가까운 순서부터 실행할 커맨드를 지정합니다.
-5. 국가에 소속됐다면 국가 정보·도시·장수·외교 화면에서 상황을 확인합니다.
+**장수**는 게임 속 내 인물입니다. **국가**는 여러 장수가 함께 속하는 편이고,
+**도시**는 지도 위의 거점입니다. 장수는 한 도시에 머물며 일하거나 병사를 모으고,
+다른 도시로 이동하거나 공격합니다. 컴퓨터가 움직이는 장수는 **NPC**, 이용자들은
+줄여서 **엔장**이라고 부릅니다.
 
-서버마다 scenario, 시작 연도, 턴 간격, 가입 방식, map, 병종과 허용 커맨드가 다를 수 있습니다. 이 문서는
-기본 구현을 설명하며 현재 화면의 가능/불가 표시와 운영 공지를 우선해 주세요.
+나라들은 도시를 늘리고 전쟁·외교를 거쳐 통일을 목표로 합니다. 한 차례의 게임을
+**기수** 또는 **깃수**, 천하통일을 **천통**이라고 부릅니다. 한 기수가 끝나면 다음
+기수에서는 새 상황에서 다시 시작합니다. 개인적으로는 전투·내정·성장·기록을 즐길
+수도 있습니다. 처음부터 군주가 되어 나라를 운영할 필요는 없습니다.
 
-## 어디서 무엇을 하나요?
+## 버튼을 누른 순간 모두 실행되지는 않습니다
 
-| 메뉴                       | 용도                                           |
-| -------------------------- | ---------------------------------------------- |
-| 메인                       | 장수·국가 예턴, 현재 상태, 최근 기록           |
-| 현재 도시·국가 정보        | 도시 내정치·보급·전선, 국가 자원·기술          |
-| 국가 장수·인사             | 소속 장수와 직책, 권한이 있으면 인사·방침 설정 |
-| 외교                       | 국가 관계와 제안·교전 상태 확인                |
-| 부대                       | 부대 생성·가입·관리                            |
-| 경매·토너먼트·베팅         | 해당 기간에 열린 참가·입찰·예측 기능           |
-| 게시판·메시지              | 공개/국가 소통과 개인 메시지                   |
-| 연감·명장·왕조·과거 플레이 | 현재·과거 기록 열람                            |
-| 내 정보·설정               | 표시·알림 등 개인 설정                         |
+이 게임의 **턴**은 내 장수가 행동할 차례입니다. **예턴**은 앞으로 할 행동을
+미리 적어 놓은 목록입니다. “농지 개간 → 농지 개간 → 이동”을 넣었다면 내 차례가
+올 때마다 앞에서부터 하나씩 실행합니다. 저장 직후 도시가 바뀌지 않아도 이상한
+것은 아닙니다. 실제 행동은 다음 턴에 일어납니다.
 
-## 다음에 읽을 문서
+로그아웃해도 예약한 행동은 진행됩니다. 다만 전쟁으로 길이 막히거나 자원이
+부족해지면 실패할 수 있습니다. 접속할 때는 **현재 상태 → 최근 기록 → 다음 예턴**
+순서로 확인하세요. [시간과 턴](./time-and-turns.md)에 예시가 있습니다.
 
-- 예턴이 언제 실행되는지: [시간과 턴](./time-and-turns.md)
-- 어떤 조건에서 커맨드를 쓸 수 있는지: [커맨드와 실행 시기](./commands-and-timing.md)
-- 현재 소스에 등록된 전체 목록: [커맨드 전체 목록](./command-catalog.generated.md)
-- 국가 직책과 부가 기능: [국가 운영과 주요 기능](./nation-and-features.md)
+## 첫 접속에서 할 일
+
+1. 로그인한 뒤 로비에서 참가할 게임 서버를 고릅니다. 서버마다 지도·속도·규칙이
+   다를 수 있으니 현재 공지와 시작 시각을 읽습니다.
+2. 장수 생성·참가 화면의 안내를 따릅니다. 이름과 능력치를 정하는 방식, 기존
+   NPC를 맡는 **빙의** 가능 여부는 서버 설정에 따라 다릅니다.
+3. 메인에서 내 **국가, 현재 도시, 금, 쌀, 다음 턴 시각**을 찾습니다.
+4. 나라가 없다면 **임관**으로 나라에 들어갑니다. 무작위 임관만 허용하는 서버도
+   있습니다. 나라가 있다면 국가 공지와 메시지를 먼저 읽습니다.
+5. “처음입니다. 어느 도시에서 어떤 일을 하면 될까요?”라고 국가 메시지로 물어보고,
+   가까운 예턴부터 입력합니다. 저장된 목록이 원하는 순서인지 확인합니다.
+6. 다음 접속 때 행동 기록에서 성공·실패 이유를 읽고 남은 예턴을 고칩니다.
+
+## 어디까지 읽으면 되나요?
+
+| 지금 필요한 것                  | 읽을 문서                                         |
+| ------------------------------- | ------------------------------------------------- |
+| 내 장수와 돈·쌀·도시가 무엇인지 | [장수와 도시, 내정](./general-and-city.md)        |
+| 행동을 예약하고 결과를 확인하기 | [시간과 턴](./time-and-turns.md)                  |
+| 처음 전쟁에 참여하기            | [전쟁과 예턴 조합](./war-and-orders.md)           |
+| 지도에서 길과 정보 읽기         | [보급·정찰·땅따](./map-and-supply.md)             |
+| 세율과 외교를 이해하기          | [국가 재정과 외교](./economy-and-diplomacy.md)    |
+| 게시판과 국가 메시지의 줄임말   | [용어 사전](./glossary.md)                        |
+| 메뉴와 부가 기능 찾기           | [국가 운영과 주요 기능](./nation-and-features.md) |
+| 특정 명령의 조건 확인하기       | [커맨드와 실행 시기](./commands-and-timing.md)    |
+
+전략 글은 당시 규칙과 경험에 따른 조언입니다. 이 안내서는
+[게시판 원문과 확인 근거](./sources.md)를 연결하고, 현재 규칙과 경험담을 구분합니다.

docs/user/map-and-supply.md

@@ -0,0 +1,69 @@
+# 보급·정찰·땅따: 지도 읽기
+
+지도에서는 도시 색뿐 아니라 **도시 사이의 연결선, 수도, 보급 상태**를 함께 봅니다.
+가까워 보이는 두 도시라도 길이 연결되지 않았다면 바로 이동하거나 공격할 수
+없을 수 있습니다.
+
+## 수도에서 이어지는 길이 보급로입니다
+
+보급은 나라의 도시들이 수도와 같은 나라의 도시를 거쳐 연결되어 있는지에 관한
+상태입니다. 단순히 내 장수가 쌀을 많이 들고 있다는 뜻은 아닙니다.
+
+```text
+수도 A ─ 우리 도시 B ─ 우리 도시 C
+```
+
+다른 길이 없을 때 적이 B를 점령하면 C는 수도와 끊깁니다. C를 직접 공격하지
+않아도 보급을 위협할 수 있습니다. 반대로 우회하는 우리 도시의 연결이 있다면
+B 하나를 잃어도 이어질 수 있습니다.
+
+## 깃 끊기·깃발이 떨어지기
+
+이 맥락에서 **깃 끊기**는 보급 연결을 끊는 전술을 말합니다. 게임 한 판을 뜻하는
+“깃수”와 구분하세요. [43기 국가열전](https://sam.hided.net/xe/community/25102)에는
+연결 도시를 빼앗아 여러 지역의 보급을 끊고, 상대가 연결을 되찾는 공방이 나옵니다.
+
+현재 기본 보급 처리는 수도에서 같은 나라 도시의 연결을 따라 판정합니다.
+보급이 끊긴 도시는 내정·인구 등에서 손해를 받고, 그곳의 소속 장수도 병력과
+훈련·사기가 줄어들 수 있습니다. 모병·내정 등 보급을 요구하는 행동도 확인해야
+합니다. 도시 하나의 손실이 뒤쪽 여러 도시의 문제로 번지는 이유입니다.
+
+도시 점령 순간과 보급 갱신 시점은 구분해야 합니다. 화면의 보급 표시와 월 변경
+뒤의 기록을 확인하고, 고립된 곳에서 모병만 계속 예약하지 마세요. 국가 운영자는
+연결 도시 수복이나 수도 위치 등 가능한 회복 수단을 살펴야 합니다.
+
+## 장수 이동으로 도시 정보 밝히기
+
+내 장수가 있는 도시는 현재 도시 화면에서 자세히 볼 수 있습니다. 따라서
+허용된 **이동**으로 도시를 직접 살펴보는 것도 정보 수집 방법입니다. 이동은
+도시를 점령하는 행동이 아니므로, 정보 확인과 공격을 혼동하지 않습니다.
+
+현재 도시 조회는 자신의 위치, 소속 국가의 도시와 장수 위치, 첩보, 인접 여부
+등에 따라 공개 범위를 나눕니다. 같은 국가의 관직을 가진 장수는 아군 장수가
+있는 도시를 조회할 수 있는 조건도 있습니다. 그래서 장수 한 명의 위치가 국가의
+정보 수집에 도움이 될 수 있습니다. 다만 도시가 보인다고 적 장수의 모든 비밀
+정보나 예약 행동까지 공개되지는 않습니다.
+
+이동은 거리·비용 등 실행 조건을 확인해야 하고, 자리를 비우면 원래 도시에서
+하던 내정·수비·모병 계획이 달라집니다. 떠난 뒤에도 정보가 영구히 남는 탐험
+게임으로 생각하지 마세요. **첩보**로 얻는 정보와 직접 주둔해서 보이는 정보도
+구분합니다. 이 설명은 현재 도시 조회 코드로 확인한 기능이며, 같은 표현의
+게시판 공략을 발견했다고 주장하는 것은 아닙니다. 근거는 [자료 안내](./sources.md)에 있습니다.
+
+## 땅따와 183년
+
+**땅따**는 땅따먹기의 줄임말입니다. 특히 게임 초반 출병 제한이 풀린 뒤 공백지
+등을 선점해 나라의 영역과 접경을 만드는 시기를 가리킵니다. **공백지**는 어느
+나라에도 속하지 않은 도시이며, 아무 준비 없이 점령할 수 있다는 뜻은 아닙니다.
+
+게시판에서 자주 보이는 **183년 땅따**는 그 시나리오의 시작 연도와 보호 기간을
+배경으로 합니다. [84기 회고](https://sam.hided.net/xe/community/72721)에는
+183년 초 땅따가 끝난 사례가 있습니다. 모든 서버가 반드시 183년에 열리는 것은
+아닙니다. 현재 서버의 공지와 출병 가능 시점을 확인하세요.
+
+땅따 전에는 병력·훈련·사기·군량을 준비하고 동료와 목표 도시를 나눕니다.
+가까운 성 하나만 보지 말고 그 뒤로 갈 길과 수도 연결, 다른 나라와 닿을 국경을
+살펴보세요. 너무 넓게 뻗으면 지킬 곳이 늘어나고, 다른 나라의 확장과 부딪힐 수
+있습니다. 이미 외교로 약속한 경로가 있는지도 국가 공지에서 확인합니다.
+
+다음은 [국가 재정과 외교](./economy-and-diplomacy.md)입니다.

docs/user/nation-and-features.md

@@ -6,8 +6,9 @@
 전략·재정 설정, 비밀 장수 정보와 정찰 차단 같은 기능에 적용됩니다. 같은 국가 장수에게만 보이는 정보도
 있고, 공개 목록에는 일부 값이 가려질 수 있습니다.
 
-내가 직접 URL이나 장수 번호를 입력해도 권한은 늘어나지 않습니다. 서버가 로그인 session에서 내 장수를
-찾아 국가·직책·대상 관계를 판단합니다.
+직책은 단순한 명예 표시가 아니라 실제 이용 권한과 연결됩니다. 처음에는 군주나
+수뇌(국가 운영 담당 장수)에게 맡을 역할을 물어보세요. 권한이 없는 메뉴가 보이지
+않거나 일부 정보가 가려지는 것은 정상일 수 있습니다.
 
 ## 국가 운영 화면
 
@@ -28,7 +29,7 @@
 ## 외교와 즉시 승인
 
 선전포고 같은 일부 외교 행동은 국가 예턴으로 실행합니다. 종전·불가침·파기 제안은 제안 생성과 상대의
-수락이 나뉘며, 수락은 현재 관계와 권한을 다시 확인하는 즉시 action입니다. 제안 뒤 국가가 멸망하거나
+수락이 나뉘며, 수락은 현재 관계와 권한을 다시 확인하는 즉시 처리입니다. 제안 뒤 국가가 멸망하거나
 관계·직책이 바뀌면 수락할 수 없을 수 있습니다.
 
 ## 부대
@@ -38,14 +39,13 @@
 
 ## 경매
 
-경매는 열림·입찰·마감 단계가 있습니다. 입찰은 로그인한 내 장수와 자원을 기준으로 저장되고, 마감은 daemon
-worker가 낙찰과 정산을 확정합니다. 이미 마감됐거나 자원이 바뀌면 이전에 보던 화면의 입찰 가능 상태가
+경매는 열림·입찰·마감 단계가 있습니다. 입찰은 로그인한 내 장수와 자원을 기준으로 저장되고, 마감은 서버가 낙찰과 정산을 확정합니다. 이미 마감됐거나 자원이 바뀌면 이전에 보던 화면의 입찰 가능 상태가
 유효하지 않을 수 있습니다.
 
 ## 토너먼트와 베팅
 
-토너먼트는 등록·진행·종료와 보상 정산 lifecycle을 가집니다. 국가 베팅도 열림과 마감·정산 event가
-scenario 달력에 의해 발생합니다. 각 화면의 현재 상태와 마감 시각을 확인해 주세요. profile에서 event가
+토너먼트는 등록·진행·종료와 보상 정산 단계을 가집니다. 국가 베팅도 열림과 마감·정산 행사가
+시나리오 달력에 의해 발생합니다. 각 화면의 현재 상태와 마감 시각을 확인해 주세요. 서버에서 행사가
 열리지 않았다면 메뉴가 있어도 참여할 수 없습니다.
 
 ## 게시판·메시지
@@ -55,10 +55,12 @@ scenario 달력에 의해 발생합니다. 각 화면의 현재 상태와 마감
 
 ## 기록
 
-- 연감은 월 경계의 world 상태를 보존합니다.
+- 연감은 월이 바뀔 때의 게임 상태를 보존합니다.
 - 명장·순위·왕조 화면은 현재 또는 종료된 시즌의 집계 데이터를 보여 줍니다.
-- 과거 플레이는 로그인한 사용자 소유 archive만 볼 수 있습니다.
-- 다른 사용자의 archive나 국가 비밀 정보는 URL을 바꿔도 공개되지 않습니다.
+- 과거 플레이는 로그인한 사용자의 보관 기록만 볼 수 있습니다.
+- 다른 사용자의 개인 보관 기록과 국가 비밀 정보는 공개 범위에 따라 가려집니다.
 
 기록 화면의 값은 실시간 메인 상태와 갱신 시점이 다를 수 있습니다. 월 정산이나 시즌 종료 직후에는 해당
 기능의 최신 상태 표시를 함께 확인해 주세요.
+
+국가 운영 판단은 [재정과 외교](./economy-and-diplomacy.md), 낯선 말은 [용어 사전](./glossary.md)에서 이어 읽으세요.

docs/user/sources.md

@@ -0,0 +1,60 @@
+# 자료와 확인 범위
+
+이 안내서는 공개 게시판의 말과 경험을 처음 참가하는 사람의 언어로 풀고,
+현재 게임 규칙은 Core 코드와 대조했습니다. 조사일은 **2026-09-29**입니다.
+게시판 글은 역사적 경험·제안의 근거이며, 현재 설정이나 공식 운영 규정의 증명은
+아닙니다. 서버 공지와 실제 화면의 조건을 먼저 확인하세요.
+
+## 게시판에서 읽은 자료
+
+본문과 필요한 공개 댓글을 확인했습니다. 글 전체·작성자 정보를 복제하지 않고
+주제와 링크만 남깁니다. 검색 결과의 제목만으로 전략 효과를 확정하지 않았습니다.
+
+| 원문                                                                                 | 안내서에 반영한 내용                                          | 읽을 때의 한계                                                  |
+| ------------------------------------------------------------------------------------ | ------------------------------------------------------------- | --------------------------------------------------------------- |
+| [뉴비의 질문을 모아둡니다](https://sam.hided.net/xe/community/51784)                 | 직책, 훈사, 세율, 장비, 임관, 삭턴·벌점 등 초보자의 실제 질문 | 질문 모음 자체가 답이나 규칙은 아님                             |
+| [어떻게 해야 숙련도를 많이 높일 수 있을까?](https://sam.hided.net/xe/community/9660) | 모훈사, 양파, 징훈훈사사, 병종 저격, 준비 시간과 성장의 관계  | 2018년 계산 배수·버그 관련 조언을 현행 공략으로 재사용하지 않음 |
+| [모훈사·징훈훈사사 완료 시 사기 건의](https://sam.hided.net/xe/devel/1143)           | 준비 턴 약어와 자원·전쟁 준비 간의 고민                       | 당시 제안이며 현재 훈사 결과를 보장하지 않음                    |
+| [2기 물조명성너프필수 개인열전](https://sam.hided.net/xe/community/2846)             | 점사, 턴 정렬과 준비 순서가 어긋나는 사례                     | 당시 참가자의 회고                                              |
+| [10기 충차전 비스마르크 국 열전](https://sam.hided.net/xe/community/15146)           | 세율 5%·지급률·포상 사용례                                    | 특수 기수의 재정 경험을 일반 최적값으로 취급하지 않음           |
+| [43기 삼린이좋아국 국가열전](https://sam.hided.net/xe/community/25102)               | 초반 확장·외교·연결 도시 수복과 보급 차단                     | 당시 지도·외교·병종 조건에 의존                                 |
+| [70기 일단박죠 이야기 마무리](https://sam.hided.net/xe/community/47834)              | 모훈사출출, 양파, 발령, 전쟁 금지, 다굴                       | 전술의 성공을 보편적인 보장으로 취급하지 않음                   |
+| [84기 유산채굴국 열전](https://sam.hided.net/xe/community/72721)                     | 183년 땅따 사용례                                             | 모든 서버의 출병 해금 연도가 183년인 것은 아님                  |
+| [89기 바나낫 후기](https://sam.hided.net/xe/community/75894)                         | 최후 2국 약속과 길막, 역할 분담                               | 표현의 실제 사용례이며 외교 규정이 아님                         |
+| [97기 탱커단속반 장수열전](https://sam.hided.net/xe/community/78162)                 | 모출, 예턴, 기연, 발령, 삭턴의 대화상 의미                    | 개인별 평가를 이용자 성향 정보로 재배포하지 않음                |
+| [99기 99](https://sam.hided.net/xe/community/79329)                                  | 국가 운영, NPC 정책, 세율 담당, 외교·의병·수뇌                | 최신에 가까운 회고도 현재 Core 구현과는 별도                    |
+| [외교 옵션을 명확하게 정의해 달라는 건의](https://sam.hided.net/xe/devel/12712)      | 최후 2국 같은 포괄적 약속의 모호함                            | 제안 글을 공식 규정으로 옮기지 않음                             |
+| [물조 명성 관련 건의](https://sam.hided.net/xe/devel/2569)                           | 물조와 자원 조달의 맥락                                       | 당시 제안의 보상 수치를 현행 규칙으로 취급하지 않음             |
+| [개별 대화에서 설명한 내용을 모은 글](https://sam.hided.net/xe/devel/31537)          | 댓글의 도시 장수 정렬·턴 순서 설명                            | 오래된 설명이며 현재 화면별 정렬은 따로 확인해야 함             |
+
+검색은 공개 `community`·`devel` 게시판의 제목+내용과 웹 검색에서 양파, 모출,
+모훈사출출, 세율, 보급, 깃 끊기, 최후2국, 땅따 등의 표현을 조합했습니다.
+전수조사나 모든 은어 수집을 뜻하지 않습니다. 다른 서버의 관습이나 사적인 대화방
+내용을 섞지 않았습니다.
+
+## 현재 규칙을 확인한 위치
+
+다음은 문서 편집자·개발자를 위한 근거입니다. 게임을 하기 위해 코드를 읽을
+필요는 없습니다. 경로는 `core2026` 저장소 기준입니다.
+
+| 내용                                           | 확인 위치                                                                                 |
+| ---------------------------------------------- | ----------------------------------------------------------------------------------------- |
+| 모병·훈련·사기·이동·출병의 입력과 실행 조건    | `packages/logic/src/actions/turn/general/`, 생성 커맨드 목록                              |
+| 출병 보호 기간                                 | `che_출병.ts`의 예약·실행 constraint, `packages/logic/src/constraints/misc.ts`            |
+| 수도와 소유 도시 연결에 따른 보급·고립 손실    | `app/game-engine/src/turn/monthlyCitySupplyAction.ts`                                     |
+| 주둔·같은 국가 장수 위치·첩보에 따른 도시 정보 | `app/game-api/src/router/world/index.ts`의 `getCurrentCity`                               |
+| 세율 5%·30%의 내정·민심·인구 비교              | `app/game-engine/src/turn/monthlySemiAnnualAction.ts`                                     |
+| 세율에 비례하는 수입                           | `packages/logic/src/economy/nationIncome.ts`, `app/game-engine/src/turn/incomeHandler.ts` |
+| 적용 세율 확정                                 | `app/game-engine/src/turn/nationTurnMonthlyHandler.ts`, `nationTaxRate.ts`                |
+| 수비 설정의 표시와 선택지                      | `app/game-frontend/src/views/MyPageView.vue`                                              |
+
+“장수 이동으로 도시 정보 밝히기”는 현재 조회·이동 코드로 확인했습니다. 직접
+설명하는 게시판 원문은 이번 표본에서 확보하지 못했습니다. “모병양파”는 게시판의
+양파·모병 반복 맥락을 풀어 쓴 표현입니다. 세율 30%의 효과는 계산 코드로 확인했으며,
+30%를 권장하는 공략을 발견한 것으로 표시하지 않았습니다.
+
+## 안내서를 고칠 때
+
+새 용어는 원문에서 어떤 상황에 쓰였는지 보고, 뜻·행동·조건·손해를 함께 적습니다.
+규칙 숫자는 현재 코드와 서버 설정을 확인하고, 경험담의 효율 배수나 오래된 운영
+제안을 그대로 옮기지 않습니다. 화면 용어와 커뮤니티 약어가 다르면 양쪽을 연결합니다.

docs/user/time-and-turns.md

@@ -2,12 +2,20 @@
 
 ## 현실 시간과 게임 달력
 
-서버는 profile의 턴 schedule에 따라 tick을 진행합니다. 한 tick마다 실행 시각이 된 장수의 명령을 처리하고,
-게임 달력이 다음 달로 넘어갈 경계에서는 월간 정산과 event도 처리합니다. 실제 턴 간격은 서버 설정에 따라
-달라지므로 메인 화면의 다음 턴 시각을 확인해 주세요.
+내 장수는 정해진 간격으로 돌아오는 차례에 행동합니다. 화면의 **다음 턴 시각**이
+그 차례를 알려 줍니다. 서버마다 간격이 다르고 장수마다 차례가 다를 수 있으므로,
+다른 사람의 시각을 내 시각으로 생각하지 마세요.
+
+예를 들어 다음 턴이 14:03이고 턴 간격이 10분인 서버에서, 정상 진행 중
+“모병 → 훈련 → 사기 진작”을 예약했다면 14:03, 14:13, 14:23에 하나씩 실행하는
+식입니다. 예시의 10분은 고정 규칙이 아닙니다. 일시정지·재개나 운영 조정이 있다면
+갱신된 화면의 시각을 확인합니다.
+
+현실 시간과 별도로 게임 속 연·월이 흐릅니다. 월이 바뀔 때의 국가 정산과
+내 장수의 차례는 구분하세요.
 
 게임 달력은 1월부터 12월까지 진행하고 12월 다음은 다음 해 1월입니다. 월이 바뀔 때 수입, 외교·전쟁 상태,
-도시·국가 상태, 연감, scenario event 같은 여러 처리가 정해진 순서로 일어납니다. 그러므로 같은 커맨드도
+도시·국가 상태, 연감, 시나리오에 정해진 사건 같은 여러 처리가 정해진 순서로 일어납니다. 그러므로 같은 커맨드도
 월 변경 직전과 직후에 자원이나 조건이 달라질 수 있습니다.
 
 ## 예턴
@@ -18,8 +26,8 @@
 - 대상 도시·장수·국가, 병종, 수량 등이 필요한 커맨드는 입력값까지 저장됩니다.
 - 비어 있는 칸과 실행 뒤 밀려난 끝 칸은 기본적으로 `휴식`으로 채워집니다.
 
-여러 칸에 한꺼번에 같은 명령을 넣거나 예턴을 앞뒤로 이동할 수 있습니다. 다른 탭에서 먼저 수정하면 revision
-충돌이 날 수 있으므로 새 목록을 불러온 뒤 다시 적용해 주세요.
+여러 칸에 한꺼번에 같은 명령을 넣거나 예턴을 앞뒤로 이동할 수 있습니다. 다른 탭에서 먼저 수정하면 저장 내용이
+충돌할 수 있으므로 최신 목록을 불러온 뒤 다시 적용해 주세요.
 
 ## 예약할 수 있어도 실행에 실패할 수 있습니다
 
@@ -30,7 +38,7 @@
 - 내 소속 국가와 직책
 - 대상 장수·도시·국가의 존재와 외교 관계
 - 전쟁·불가침 기간과 전략 커맨드 재사용 상태
-- scenario 연도, 가입 방식, 기술 수준과 병종 개방
+- 시나리오 연도, 가입 방식, 기술 수준과 병종 개방
 
 입력 화면은 현재 정보로 사전 판단하지만, 실제 턴에서는 전체 조건을 다시 확인합니다. 실패 이유는 명령
 로그에서 확인하고 다음 예턴을 조정해 주세요.
@@ -48,5 +56,7 @@
 - 국가 운영자는 국고·군량, 직책과 외교 제안의 만료·수락 상태를 확인해 주세요.
 - 경매·토너먼트·국가 베팅은 각 화면에 열린 기간과 마감 상태가 표시될 때만 입력해 주세요.
 
-월간 event는 scenario resource가 결정하므로 모든 서버가 같은 월에 같은 event를 실행한다고 가정하지
+월간 사건은 시나리오 설정에 따라 달라지므로 모든 서버가 같은 월에 같은 행사를 연다고 가정하지
 말아 주세요.
+
+다음은 [전쟁과 예턴 조합](./war-and-orders.md)입니다.

docs/user/war-and-orders.md

@@ -0,0 +1,73 @@
+# 전쟁과 예턴 조합
+
+도시를 공격하려면 먼저 병력을 준비하고, 공격 가능한 관계와 경로인지 확인해야
+합니다. **출병**은 공격 행동, **이동**은 장수의 위치를 바꾸는 행동입니다.
+이동만으로 적 도시를 점령하지는 않습니다.
+
+## 전쟁에 처음 참가할 때
+
+1. 국가 공지에서 공격할 도시와 방어할 도시를 확인합니다.
+2. 내 위치, 모병할 병종·수량, 금과 쌀을 확인합니다.
+3. 병력을 모으고 필요한 훈련·사기를 준비합니다.
+4. 공격 목표와 수비 설정을 확인하고 예턴을 넣습니다.
+5. 첫 전투 뒤 병력·훈련·사기·쌀과 로그를 다시 봅니다. 다음 출병도 성공할지는
+   앞 전투의 결과에 달려 있습니다.
+
+병종마다 사용할 수 있는 도시·기술 등의 조건이 다릅니다. 같은 병종을 계속
+모으려면 [보급과 지도](./map-and-supply.md)도 함께 봐야 합니다.
+
+## 모출·모훈사출출은 명령 순서를 줄인 말입니다
+
+**모**는 모병, **징**은 징병, **훈**은 훈련, **사**는 사기 진작, **출**은 출병입니다.
+한 글자마다 예턴 한 칸을 뜻합니다. “모훈사출출”이라는 별도 버튼을 찾는 것이
+아닙니다. 각 칸의 병종·수량·도시도 지정해야 합니다.
+
+| 조합       | 실제 순서                             | 쓰려는 목적과 주의점                                                                  |
+| ---------- | ------------------------------------- | ------------------------------------------------------------------------------------- |
+| 모출       | 모병 → 출병                           | 급히 공격을 이어 갑니다. 훈련·사기 준비를 줄인 만큼 전투 효율을 확인해야 합니다.      |
+| 모출출     | 모병 → 출병 → 출병                    | 공격 기회를 늘리려는 조합입니다. 첫 전투 뒤 병력이 남아야 다음 공격도 가능합니다.     |
+| 모훈사출   | 모병 → 훈련 → 사기 진작 → 출병        | 전투 준비 후 공격하는 기본적인 읽기 예시입니다.                                       |
+| 모훈사출출 | 모병 → 훈련 → 사기 진작 → 출병 → 출병 | 준비된 병력으로 두 차례 공격을 시도합니다. 항상 두 번 싸울 수 있다는 보장은 없습니다. |
+| 징훈훈사사 | 징병 → 훈련 두 번 → 사기 진작 두 번   | 징병 뒤 준비를 길게 하는 표현입니다. 비용뿐 아니라 인구·민심과 준비 시간도 봅니다.    |
+| 풀훈사     | 훈련·사기를 충분히 채운 상태          | 행동 이름이 아니라 준비 상태입니다. 실제 수치를 확인합니다.                           |
+
+이 조합들이 사용된 근거는 [숙련도 토론](https://sam.hided.net/xe/community/9660),
+[준비 턴 건의](https://sam.hided.net/xe/devel/1143),
+[70기 전쟁 회고](https://sam.hided.net/xe/community/47834)에 있습니다.
+오래된 글의 효율 배수나 권장 수비 수치를 현재의 정답으로 옮기지는 않았습니다.
+
+## 모병양파: 병력을 계속 보충하며 버티기
+
+**양파**는 병력을 깎아도 다시 보충되어 계속 상대해야 하는 수비를 가리키는 은어입니다.
+**모병양파**는 모병을 반복하면서 방어 병력을 다시 채우는 방식으로 이해하면 됩니다.
+훈련·사기 준비에 시간을 쓰기보다 당장 도시가 무너지지 않게 막으려는 선택입니다.
+
+예턴에 모병만 넣어도 자동으로 모든 공격을 막는 것은 아닙니다. 현재 도시,
+병력과 자원, 수비 참여 설정·훈련사기 기준이 맞아야 합니다. 계속 모병하면 도시의
+인구와 내 자원이 줄고, 준비가 덜 된 병력으로 싸우면서 손실이 커질 수 있습니다.
+[숙련도 토론](https://sam.hided.net/xe/community/9660)도 양파를 개인 성장의 만능 해법으로
+보지 않습니다. 국가의 급한 수비와 장수 개인의 성장 목적이 다를 수 있습니다.
+
+처음에는 수비 수치를 임의로 낮추기보다 “지금 양파가 필요한지, 어떤 병종·수량과
+수비 기준을 쓸지”를 국가에 물어보세요. 수비 설정을 바꿨다면 이후 예턴도 확인합니다.
+
+## 점사·턴 정렬·병종 저격
+
+**점사**는 여러 장수의 공격을 특정 도시·시점에 모으는 것, **턴 정렬**은 그 공격
+순서를 맞추는 일입니다. 먼저 공격한 사람이 수비 병력을 줄이고 뒤의 사람이 성벽을
+공격할 수 있으므로, 혼자 한 번 더 공격하는 것이 공동 계획과 어긋날 수도 있습니다.
+[초기 전쟁 회고](https://sam.hided.net/xe/community/2846)에는 준비 턴이 어긋난 사례가 나옵니다.
+
+**병종 저격**은 상대 병종과의 유리한 상성을 노리는 표현입니다. 장수 특기 이름인
+“저격”과 문맥을 구분하세요. **수비 켬끔**은 수비 참여를 켜거나 끄며 상대할 전투를
+조절하는 플레이를 뜻합니다. 처음에는 국가 지시에 맞춰 사용하고, 접속을 마칠 때
+원하는 수비 설정으로 남아 있는지 확인하세요.
+
+## 로그에서 다음 행동 결정하기
+
+승패 한 줄만 보지 말고 누구와 싸웠는지, 병력이 얼마나 줄었는지, 쌀이 남았는지,
+도시를 실제로 점령했는지 봅니다. 전투 시뮬레이터의 예상은 실제 상대 상태·난수·
+연속 전투를 모두 보장하지 않습니다. 패배 후에도 내 장수가 남아 있다면 다시 준비해
+참전할 수 있고, 나라가 멸망한 뒤의 소속 변경은 서버 규칙과 화면 안내를 따릅니다.
+
+다음은 [보급·정찰·땅따](./map-and-supply.md)입니다.