/moai todo NEW
정보moai gtd와/moai gtd는 기존 자동화와 스크립트를 위한 호환 표면으로 계속 완전히 지원됩니다. 정식 이름은/moai todo와moai todo이며, 두 이름은 같은 SQLite 대기열과 카드 ID, 순서, 보관·복원 동작을 사용합니다.
다음에 할 일을 한 줄씩 쌓아 두는 백로그 대기열입니다. 팩토리 큐의 backlog에는 맡은 세션이 없어서 아무도 일을 밀어 넣지 못합니다. 그래서 카드를 큐에 들이는 일은 언제나 사람의 판단이고, /moai todo가 그 창구입니다.
정보한 줄 요약:/moai todo는 다음에 할 일을 기록하는 대기열입니다. 항목을 넣고, 목록을 보고, 완료한 카드를 보관하고, 다음에 착수할 카드를 고릅니다. 선택만으로 SPEC이 생기지는 않으며, 카드 분류에 따라 작업 절차가 정해집니다.
정보슬래시 커맨드: Claude Code에서/moai:todo를 입력하면 바로 실행됩니다./moai만 입력하면 사용 가능한 모든 서브커맨드 목록이 표시됩니다.
백로그의 한 항목은 의도 한 줄이며 SPEC이나 계획서가 아닙니다. 사람이 고른 뒤 Class A는 바로 마무리하고, Class B는 SPEC 없이 run → sync를 진행하며, Class C는 plan에서 SPEC을 작성한 뒤 run → sync로 이어집니다.
대기열은 일부러 얇게 만들었습니다. SPEC이나 git 이력, 팩토리 실행 기록이 더 잘 기록할 것은 담지 않고, 사람이 다음에 무엇을 원하는가만 남깁니다.
flowchart TD
Add["/moai todo 설명
항목 추가"] --> Queue["백로그 대기열"]
Queue --> Pick["팩토리 리더의 질문 채널에서
사람이 하나 선택"]
Pick --> Class{"카드 분류"}
Class --> A["A: 바로 마무리"]
Class --> B["B: run → sync"]
Class --> Plan["C: plan → run → sync
plan에서 SPEC 작성"]
Plan --> Spec["SPEC ID를 항목에 기록"]# 항목 추가
> /moai todo "인증 미들웨어의 오류 경로 정리"
# 대기열 보기
> /moai todo| 호출 | 동작 |
|---|---|
/moai todo "<설명>" | 항목을 대기열 끝에 추가하고, 추가된 항목과 위치를 보여 줍니다. |
/moai todo | 대기열을 순서대로, 위치 번호와 함께 보여 줍니다. |
항목을 제거하거나 다음 카드를 고르는 동사는 슬래시 표면에 없습니다. 그 두 가지는 아래의 터미널 CLI(moai todo done, moai todo next) 또는 리더 세션을 통한 선택이 담당합니다.
그 밖의 인자 형태는 설명으로 취급합니다. /moai todo CI 캐시 불안정 해결은 오류가 아니라 항목 추가입니다 — 잘못 알아들었을 때의 대가가 사람이 한 줄 지우는 것뿐이기 때문입니다.
일반적인 프로젝트 디렉터리라면 대기열은 ~/.moai/db/<project-key>/todo/backlog.db 하나의 SQLite 데이터베이스에 저장됩니다. 다만 프로젝트가 임시 디렉터리(os.TempDir(), /tmp, /var/folders 아래)에서 시작된 것이라면 절대 경로의 MOAI_HOME 재정의가 없는 한 홈 대신 <base>/.moai/state/todo/backlog.db에 프로젝트 로컬로 저장됩니다. 프로젝트 키가 연결된 워크트리를 홈의 큐 하나에 묶으며, 데이터베이스는 커밋되지 않습니다. 아래 형태는 moai todo list --json과 moai todo export-json이 내보내는 레코드 모양이며, 데이터베이스도 같은 필드를 담습니다. 이전과 다운그레이드 방법은 프로젝트 안의 .moai/docs/todo-queue-storage.md에 있습니다.
데이터베이스 경로는 추측하지 말고 moai paths로 확인합니다. ~/.moai/db/todo.db처럼 추측한 경로를 sqlite3로 열면 빈 파일이 만들어지므로 열지 않습니다. 직접 읽어야 하면 .db, .db-wal, .db-shm을 함께 복사한 스냅샷에서만 읽고, 평소에는 moai todo list --json, moai factory status 같은 CLI를 우선 씁니다.
{
"version": 1,
"project_uuid": null,
"items": [
{
"id": "t1",
"text": "인증 미들웨어의 오류 경로 정리",
"added_at": "<RFC3339 시각>",
"spec_id": null,
"state": "queued",
"card_uuid": null
}
],
"findings": [
{
"subject_id": "t2",
"related_id": "t1",
"relation": "near-duplicate",
"source": "mechanical",
"score": 0.83,
"note": "",
"at": "<RFC3339 시각>"
}
],
"runtime": {
"runs": [
{
"project_uuid": null,
"run_id": "run-1",
"backend": "claude",
"manifest_json": "{}"
}
],
"assignments": [
{
"project_uuid": null,
"card_uuid": null,
"run_id": "run-1",
"card_id": "t1",
"owner_label": "lane-1",
"reported_state": "picked",
"event_kind": "card.assigned",
"provenance_json": "{}"
}
]
}
}| 필드 | 의미 |
|---|---|
id | 추가 시점에 붙는 짧고 안정적인 식별자. 제거된 뒤에도 재사용하지 않습니다. |
project_uuid / card_uuid | 프로젝트와 카드의 영속 identity입니다. identity가 없는 이전 데이터를 list --json으로 읽을 때도 키는 생략되지 않고 null이며, 이 순수 조회는 UUID를 발급하거나 데이터베이스를 바꾸지 않습니다. 이후 승인된 쓰기가 성공하면 canonical lowercase UUIDv7 문자열로 채워집니다. Git 저장소와 Git 없는 일반 폴더에 같은 계약을 적용합니다. |
spec_id | SPEC 식별자로 가는 선택적 연결고리입니다. 고르는 시점에 --spec으로 알려 주면 그때 채워지고, 모르면 picked 상태에서도 null로 남습니다. |
runtime | 최신 실행 시작과 카드 할당 보고입니다. runs와 assignments는 언제나 배열이며, 각 항목의 UUID는 Todo identity를 논리적으로 투영합니다. runtime 테이블에 UUID 열을 따로 저장하지 않습니다. reported_state는 보고값일 뿐 카드 완료 상태의 권위가 아닙니다. |
findings | 카드 쌍에 대한 기록입니다. 관계는 어느 한 카드가 아니라 둘 사이의 성질이라 항목이 아니라 여기에 있습니다. 언제나 배열입니다 — 이 기능 이전에 쓰인 파일도 빈 배열로 열리므로, “기록이 없다"와 “그런 기능이 없다"를 헷갈릴 일이 없습니다. source는 기계가 잰 mechanical이거나 사람·에이전트가 적은 agent입니다. 카드가 파일에서 빠지면 그 카드를 가리키던 기록도 함께 빠집니다. |
state | 생명주기 판별자입니다. queued · picked · dropped 중 하나이며, “아직 백로그의 항목"인지 “이미 레인으로 넘어간 카드"인지는 이 값이 가립니다. 고른 항목도 파일에 남아 무엇이 진행 중인지 보입니다. 항목을 살아 있는 대기열에서 빼내는 길은 moai todo done 하나뿐이고 사람이 직접 실행합니다 — 일이 끝났다고 저절로 지워지는 경로는 없습니다. done은 카드와 그 카드를 가리키던 모든 기록을 삭제하지 않고 보관소로 옮깁니다: list · next · why · analyze에는 더는 보이지 않지만, moai todo undone <n>이 카드가 있던 위치까지 그대로 되살립니다. 폐기는 보관과 다릅니다: moai todo drop <n> "<이유>"는 카드를 대기열 파일에 그대로 둔 채 dropped로 옮기고 이유를 텍스트 앞에 붙이며, moai todo undrop <n>이 이를 정확히 되돌립니다. dropped 카드는 고를 후보에서 빠집니다. |
변경은 대기열 잠금을 잡은 뒤 WAL 모드의 SQLite 트랜잭션으로 반영합니다. 대기열이 없으면 빈 대기열로 처리하고, 읽을 수 없거나 형식이 깨진 데이터는 오류를 알리고 보존합니다. 웹 콘솔도 읽기 실패를 카드 수 0으로 표시하지 않고, 대기열을 읽지 못했다는 안내를 보여 줍니다.
큐는 카드를 추가할 때마다, 그리고 moai todo analyze를 실행할 때 스스로를 읽어 닮은 카드를 찾아 기록합니다. 기록은 카드를 바꾸지 않습니다 — 텍스트도, 순서도, 상태도.
분석이 실제로 무언가를 막는 경우는 하나뿐입니다. 이미 대기 중이거나 고른 카드와 정규화 후 텍스트가 완전히 같은 카드는 추가 자체가 거절됩니다. 거절은 아무것도 지우지 않고 큐 파일을 바이트 그대로 두며, 사람은 id 대신 에러를 봅니다. 그래도 넣어야 하면 --force가 넣고, 강제된 중복이라는 사실을 기록으로 남깁니다.
닮았지만 같지는 않은 카드(토큰 집합 Jaccard 0.80 이상)는 그대로 추가되고 근접 중복 기록만 붙습니다. 말이 다르면 뜻이 같아도 기계는 알아채지 못하는데, 이것은 의도한 한계입니다. 이 층이 오판하면 사람이 쓴 카드가 사라지지만, 뜻을 판정하는 moai todo relate는 기록만 남기므로 거기서의 오판은 줄 하나로 끝납니다.
contains · absorbs · replaces · conflicts 네 관계는 사람이나 에이전트가 손으로 적습니다. 이름과 달리 아무 일도 하지 않습니다 — absorbs를 적어도 카드는 흡수되지 않습니다. 무엇을 할지는 기록을 읽고 사람이 정하며, 실행은 drop · edit · move로 합니다.
moai todo list는 기록을 해당 카드 아래 들여쓴 줄로 보여 주고, 같은 쌍에 사람이 적은 기록이 하나도 없으면 machine-only를 붙입니다. 이 표시는 “아무도 검토하지 않았다"가 아니라 “기계 기록만 있다"는 사실만 말합니다 — CLI는 자기를 누가 불렀는지 알 수 없기 때문입니다.
선택은 리더 세션의 질문 채널을 통해 사람이 합니다. 리더가 대기열을 선택지로 띄우는데, 오래된 것부터 한 항목에 하나씩, 도구가 허용하는 네 개까지 보여 주고 나머지는 본문에 요약해 아무것도 가려지지 않게 합니다. /clear 뒤 첫 수로 대기열을 제시할 때도 같은 방식이고, 터미널에서 후보만 확인하고 싶을 때는 moai todo next(인자 없음)가 같은 목록을 읽기 전용으로 출력합니다.
주의고르는 주체는 사람입니다. 미리 선택해 두지 않고, 추정한 우선순위로 순서를 바꾸지 않으며, “맨 위 것부터 시작"을 기본값으로 붙이지 않습니다. 대기열이 비었으면 비었다고 말하고 멈춥니다 — 빈 백로그는 정상 상태이지, 일을 지어내라는 신호가 아닙니다.
여러 카드를 한 번에 승인할 수도 있습니다. 카드를 지목하거나, 대기열이 빌 때까지 순서대로 진행하라고 말하는 방식입니다. 이것도 사람의 선택이며, 한 장씩 대신 한 번에 했을 뿐입니다. 리더는 승인된 순서대로 카드를 들이고 다시 묻지 않습니다. 다만 그 승인이 허락하는 범위는 딱 그것뿐입니다 — 대기열에 항목을 더하거나, 순서를 바꾸거나, 승인 범위 밖의 판단이 필요해진 카드를 대신 결정하는 근거가 되지는 않습니다.
카드를 고른 뒤에는 이렇게 이어집니다.
- 고른 항목을
moai todo next <n> [--spec <SPEC-ID>]한 번의 잠긴 쓰기로picked로 표시합니다. 식별자를 이미 알고 있으면 이때 함께 붙입니다. - 카드 클래스를 따릅니다. Class A는 바로 마무리하고, Class B는 SPEC 없이 run → sync, Class C는 plan에서 SPEC을 작성한 뒤 run → sync를 진행합니다.
- SPEC이 필요한 카드에서는 식별자가 정해진 뒤
moai todo next <n> --spec <SPEC-ID>로 연결합니다. 연결은 명시적으로 수행하며, 선택된 카드에 SPEC이 없는 상태도 정상일 수 있습니다.
/moai todo는 평범한 단일 세션에서도 그대로 동작합니다 — 그냥 대기열이기 때문입니다. 다만 디스패치는 하지 않습니다. 레인 세션이 없으면 지시할 상대가 없으므로, 대기열을 읽고 쓰는 것까지가 전부이고 나머지는 사람이 직접 진행합니다.
- 작업 관리 도구가 아닙니다. 우선순위도, 담당자도, 마감도, 의존 관계도 없습니다. 그런 것이 필요한 일은 이슈 트래커나 SPEC의 몫입니다.
- 실행 기록이 아닙니다. 카드가 어느 단계에 있는지는 그 카드를 맡은 레인과 SPEC 상태가 쥐고 있지, 이 파일에 있지 않습니다.
- 진행 중인 일의 원본이 아닙니다. 카드에 SPEC이 생긴 뒤로는 SPEC 산출물이 기준이고, 백로그 항목은 그것을 가리키는 표식일 뿐입니다.
- 저절로 채워지지 않습니다. TODO 주석이나 열린 이슈, 감사 결과를 도구가 알아서 긁어 오지 않습니다. 항목을 넣는 것은 사람입니다.
- 안내 표면은 끌 수 있습니다. 세션 시작 요약 · 상태 표시줄 TODO 세그먼트 · 자동 라우팅은
workflow.yaml의workflow.todo.enabled: false로 끕니다(설정 문서 참조). 명령과 동사는 꺼도 그대로 동작합니다.
같은 대기열을 터미널에서도 조작할 수 있습니다. 슬래시 커맨드 /moai todo는 Claude Code 대화창에서, 터미널 CLI moai todo는 셸에서 부르는 별개의 표면입니다 — 이 둘은 같은 파일을 다루지만 문법이 다릅니다.
# 항목 추가 — 발급된 id와 대기열 위치를 한 줄로 출력
$ moai todo add "인증 미들웨어의 오류 경로 정리"
# 두 단어 이상이면 add 없이도 추가됩니다 (자연어 fallthrough)
$ moai todo rename 힌트가 낡았다
# 대기열 보기 (id · 상태 · 본문) — 동사 없이 bare 호출도 같은 결과
$ moai todo
$ moai todo list
# 구조화된 레코드로 보기
$ moai todo list --json
# 항목을 보관소로 옮깁니다 — 번호(t4)나 명시적 id 둘 다 받습니다
$ moai todo done 4
# 되돌리기: 보관된 카드를 있던 자리 그대로 되살립니다
$ moai todo undone 4
# 텍스트가 접두사로 시작할 때만 처리 — 잘못된 카드를 닫는 사고 방지
$ moai todo done 4 --expect "인증 미들웨어"
# 착지 여부를 물어보고, 아니라는 확답이 나올 때만 거부
$ moai todo done 4 --require-landed
# 착지한 카드를 일괄 마감 (리더 전용, 배치 push 확인 후) — 드라이런 먼저
$ moai todo auto-done --fetch --dry-run
$ moai todo auto-done --fetch
# 대기 중인 항목을 오래된 것부터 출력 (읽기 전용)
$ moai todo next
# 항목 하나를 고른 것으로 기록 — SPEC 식별자도 함께
$ moai todo next 4 --spec SPEC-AUTH-001
# 추가와 선택을 한 번의 잠긴 쓰기로
$ moai todo add "그래프 질의 문서 정리" --pick
# 고른 표시를 되돌립니다 — 아직 plan으로 넘어가지 않은 카드에
$ moai todo unpick 4
# 큐 전체를 다시 분석해 기록만 남깁니다 (카드는 건드리지 않습니다)
$ moai todo analyze
# 정확 중복이라도 넣습니다 — 강제했다는 사실이 기록됩니다
$ moai todo add "인증 미들웨어의 오류 경로 정리" --force
# 두 카드의 관계를 기록합니다 (기록뿐, 카드는 그대로)
$ moai todo relate t2 t1 --relation absorbs --note "t2가 t1을 포함"
# 이 카드에 대해 큐가 아는 것을 전부 출력
$ moai todo why t1
# 기록 하나를 지웁니다 — 번호는 why가 출력합니다
$ moai todo unrelate 2| 명령 | 동작 |
|---|---|
moai todo (bare) | 대기열을 출력합니다. list와 같은 출력입니다. |
moai todo <두 단어 이상> | 자연어 그대로 항목을 추가합니다. 한 단어(오탈자 동사 포함)는 추가가 아니라 에러로 남습니다. 동사처럼 생긴 첫 토큰 뒤에 카드 id가 오면(moai todo pick t151) 오탈자 동사로 보아 에러입니다 — 문장 중간에 id를 언급하는 카드는 그대로 추가됩니다. |
moai todo add "<text>" [--pick] | 항목을 추가하고 발급된 id와 위치를 출력합니다. --pick을 붙이면 추가와 선택 표시가 한 번의 잠긴 쓰기로 일어납니다. |
moai todo list / --json | 대기열을 출력합니다. --json은 레코드 전체를 JSON으로 내보냅니다. |
moai todo done <n> [--expect <prefix>] [--require-landed] | n번 항목을 잠금 아래 살아 있는 대기열에서 빼냅니다. t<n> 형태의 명시적 id를 권장합니다 — 동시 추가로 위치가 움직일 수 있기 때문입니다. 카드와 그 카드를 가리키던 모든 기록은 삭제가 아니라 보관되어, undone이 둘 다 되살릴 수 있습니다. 보관된 행은 list · next · why · analyze와 중복 판정 입력에서 보이지 않습니다. --expect <prefix>는 카드 텍스트가 그 접두사로 시작하지 않으면 거부합니다 — 엉뚱한 카드를 닫는 사고를 막는 안전장치입니다. --require-landed는 착지 판정을 물어 “착지하지 않았다"는 확답이 나올 때만 거부하고, 판정이 불확실하면 통과시킵니다 — 이 판정은 답한 ref 위의 커밋 제목이 여섯 가지 귀속 위치 가운데 하나로 카드를 가리키는지만 봅니다(관례적 커밋 스코프, 끝 괄호 크레딧, 크레딧 뒤 PR 참조, 카드 주도 머지, 통합 머지 끝 괄호 안의 카드 토큰, merge: <card>). 본문 언급, 문장 가운데 언급, 브랜치 이름은 아무것도 세지 않습니다 — 귀속은 메시지 어디든 나타나는 토큰이 아니라 제목 안의 위치입니다. ref는 프로젝트 설정(git_strategy.worktree_base_branch) → refs/remotes/origin/HEAD → 내장 기본값(origin/main) 순서로 정해지며, 설정 없이 아래 단계에서 답했을 때는 그 출처를 표준오류로 알려 줍니다. 플래그가 없으면 착지 질의는 전혀 실행하지 않고 비용도 붙지 않으며, 어느 경로로 거부되든 대기열 기록은 바이트 그대로 남습니다. 성공한 done은 표준출력에 착지 판정 토큰을 정확히 하나 남깁니다 — 플래그가 있으면 `done |
moai todo undone <n> | 보관된 카드를 있던 위치 그대로, 그 카드를 가리키던 모든 기록과 함께 살아 있는 대기열로 되살리고 보관 항목은 비웁니다. done 다음 undone은 대기열 기록을 정확히 같은 바이트로 되돌립니다. id가 그사이 다른 살아 있는 카드에 재발급됐으면 그 충돌을 지목하며 거부하고, 살아 있는 카드는 건드리지 않습니다. |
moai todo next | 대기 중 항목을 오래된 것부터 출력합니다. 읽기 전용입니다. |
moai todo next <n> [--spec <SPEC-ID>] | 항목을 picked로 표시하고, --spec을 주면 식별자를 그대로 기록합니다. 한 번의 잠긴 쓰기로 일어납니다. |
moai todo unpick <n> | picked 표시를 되돌립니다. 선택 자체가 사람의 판단이므로 되돌림도 사람이 직접 합니다. |
moai todo drop <n> "<reason>" [--expect <prefix>] | 대기 중 카드를 dropped로 옮기고 텍스트 앞에 [DROPPED — <reason>] 표식을 붙입니다. 인자 두 개가 모두 필요하며, 이유가 비어 있거나 ]를 포함하면 거부합니다. 카드는 파일에 남고 고를 후보에서만 빠집니다. --expect는 카드 텍스트가 그 접두사로 시작할 때만 실행합니다. |
moai todo undrop <n> [--expect <prefix>] | dropped 카드를 queued로 되돌리고 표식이 있으면 떼어 냅니다. 판단 기준은 표식이 아니라 상태라서, 손으로 dropped라 적어 둔 카드도 텍스트를 그대로 둔 채 되살아납니다. drop과 짝을 이루는 정확한 역연산입니다. |
moai todo edit <n> "<text>" [--expect <prefix>] | 카드의 텍스트만 다시 씁니다. id · added_at · state · spec_id는 그대로라, done 후 재추가처럼 카드의 정체성이 바뀌지 않습니다. 확인 줄에 새 텍스트와 이전 텍스트가 함께 나옵니다. |
moai todo move <n> (--top | --bottom | --before <m> | --after <m>) | 큐 파일의 순서 안에서 카드 위치를 옮깁니다. 목적지 플래그는 정확히 하나만 필요하며, 없거나 둘이면 잘못된 호출로 거부합니다. 항목을 재배열할 뿐 무엇도 지우거나 바꾸지 않으므로, 잘못 옮겼으면 다시 옮겨 되돌립니다. |
moai todo add "<text>" --force | 기계가 정확 중복으로 읽은 카드도 그대로 추가합니다. 강제된 중복이라는 기록이 함께 남아 충돌이 눈에 보입니다. |
moai todo analyze | 큐 전체를 다시 분석해 기록만 남깁니다. 추가·삭제·재정렬·수정은 하지 않으며, 다시 실행해도 같은 기록이 두 번 쌓이지 않습니다. |
moai todo relate <a> <b> --relation (contains | absorbs | replaces | conflicts) [--note <text>] | 두 카드의 관계를 하나 기록합니다. 기록일 뿐이라 두 카드 모두 그대로입니다 — absorbs가 흡수를 실행하지 않습니다. |
moai todo unrelate <index> | 지목한 기록 하나를 지웁니다. 번호는 why가 출력하는 것입니다. 카드는 바뀌지 않습니다. |
moai todo why <n> | 그 카드를 지칭하는 기록을 전부 출력합니다. 없으면 없다고 명시적으로 말합니다 — 아무것도 안 찍히면 고장과 구별되지 않기 때문입니다. |
moai todo export-json | 살아 있는 대기열을 옛 형식의 backlog.json으로 데이터베이스 옆에 써 냅니다. 데이터베이스를 모르는 이전 릴리스가 읽을 수 있게 하려는 것입니다. 실행한 순간의 사본일 뿐 실시간 거울이 아니므로, 바이너리를 바꾸기 직전에 내보내십시오. 보관된 카드는 살아 있는 항목과 달리 이 내보내기에 포함됩니다 — 다만 내보낸 레코드에 보관 카드가 하나라도 있으면, 보관 기능을 모르는 이전 바이너리가 첫 쓰기에서 그 필드를 버린다는 사실을 stderr로 알립니다. 이후의 todo 명령들은 이 파일을 놓아둔 자리에 그대로 둡니다. 읽기 명령인 list·show·why·pr·history는 여기에 더해, 데이터베이스 옆의 이 파일이 대기열이 아니라는 사실을 stderr로 알립니다. 오래된 내보내기를 살아 있는 상태로 착각하지 않게 하려는 것입니다. |
CLI는 프롬프트를 띄우지 않습니다. 인자와 플래그를 받고 한 줄을 출력하며, 오류는 stderr로 — 스크립트와 CI에서 안전하게 쓸 수 있는 형태입니다.
연결된 워크트리 안에서 실행해도 대기열은 프라이머리 체크아웃의 프로젝트 키 하나로 귀속됩니다 — 저장소 하나에 큐 하나라는 계약입니다. 카드 워크트리에서 moai todo add를 하면 리더와 포어맨 루프가 읽는 같은 데이터베이스에 추가됩니다. git 메타데이터가 없는 프로젝트도 같은 홈 구조를 사용합니다 — 다만 임시 디렉터리에서 시작된 프로젝트는 MOAI_HOME 절대 경로 재정의가 없는 한 <base>/.moai/state/todo/backlog.db를 사용합니다.
두 표면은 같은 저장 계층을 공유합니다. 변경은 데이터베이스 옆의 잠금 파일(backlog.lock)을 잡은 뒤 WAL 모드의 SQLite 트랜잭션 하나로 반영되며, 읽기는 잠금을 잡지 않습니다. 항목 id는 파일에 남은 최고 수위 표시(last_seq)에서 발급되는데, 이 값이 삽입과 같은 트랜잭션 안에서 올라가고 id에 UNIQUE 제약이 걸려 있어, 프로세스가 변경 도중에 죽어도 제거된 항목의 id가 다시 쓰이는 일은 없습니다.
정보설치된 바이너리: CLI는 main에 반영된 상태로 배포됩니다. 이미 설치된moai바이너리는 재설치해야 이 명령을 얻습니다.
- 팩토리 모드 — 백로그에서 나간 카드를 넘겨받는 레인
/moai통합 명령 — 서브커맨드 전체 지도/moai plan— 고른 카드가 SPEC이 되는 단계