Writes Logseq pages following conventions. Use when creating namespace pages (troubleshoot, decision, qa, spec, incident), writing journal entries, promoting journal to pages, or editing existing Logseq pages. Do NOT use for reading/searching (use qmd directly).
#pj-{name} 태그와 함께 한 줄로 기술[[링크]]로 연결 — 페이지가 없으면 생성 검토alias:: + description:: 최상단, 내용은 outliner[[링크]]로 그래프 연결 — #태그는 저널 TODO 행에서만 사용[[]]로 감싼다 (예: alias:: [[Single Page Application]])((block-uuid)) — 원본 블록 인라인 참조{{embed ((block-uuid))}} — 원본 + 하위 자식 펼침id:: 프로퍼티(UUID v4) 부여하면 참조 대상- TODO/DONE {설명} #pj-{프로젝트}, 회의 메모pj-{name}.md에 로 TODO 집계{{query}}qmd search로 관련 기존 페이지를 찾아 [[링크]]로 연결-> [[{type}/{제목}]] 링크 추가- DONE {설명} #pj-{project} + -> [[링크]]project::, date:: 프로퍼티 자체가 프로젝트 허브와 저널로의 연결[[link]] 형태로 — plain text는 그래프 엣지를 만들지 않는다TODO → DOING → DONE
[#A] / [#B] / [#C] (예: TODO [#A] 긴급 수정)SCHEDULED: <YYYY-MM-DD> / DEADLINE: <YYYY-MM-DD>DONE (취소: {사유}){{query}} 문법Simple query (Logseq 내장). Datalog 기반 advanced query와 별개.
{{query (and (task TODO DOING) [[pj-{name}]])}}
논리 연산자: and, or, not — 중첩 가능
필터:
(task TODO DOING DONE) — 태스크 상태 (공백 구분, 쉼표 아님)(priority A B) — 우선순위(page <이름>) — 특정 페이지 내 블록(namespace <이름>) — 네임스페이스 하위 페이지(property <키> <값>) — 프로퍼티 필터(between <시작> <끝>) — 날짜 범위 (저널 기준)[[페이지]] — 백링크/태그 필터 (쿼리 내에서는 [[]]만 사용)자주 쓰는 패턴:
;; 프로젝트 TODO 집계
{{query (and (task TODO DOING) [[pj-{name}]])}}
;; 우선순위별
{{query (and (task TODO DOING) (priority A) [[pj-{name}]])}}
;; 네임스페이스 하위 전체
{{query (namespace sphere)}}
;; 프로퍼티 필터
{{query (and (property status draft) [[pj-{name}]])}}
;; 최근 7일 저널
{{query (between -7d today)}}
주의: 텍스트 검색은 대소문자 구분
| 상황 | 위치 |
|---|---|
| TODO, 간단한 메모, 회의 메모 | 당일 저널 |
| 트러블슈팅 완료 (조사+결론 있음) | pages/pj-{name}___troubleshoot___{제목}.md |
| 중요 결정 확정 | pages/pj-{name}___decision___{제목}.md |
| QA 체크리스트/결과 | pages/pj-{name}___qa___{제목}.md |
| 기능 스펙/요구사항 정리 | pages/pj-{name}___spec___{제목}.md |
| 배포 실패/인프라 이슈 | pages/pj-{name}___incident___{제목}.md |
| 새 도메인 개념 | pages/{개념명}.md (기존 방식) |
| 기타 필요 시 | 새 namespace 자유 생성 |
저널에서 시작한 이슈가 깊어지면 별도 페이지로 승격하고 저널에서 링크:
- DONE {설명} #pj-{project}
- -> [[{type}/{제목}]]
승격 시 기존 TODO를 DONE으로 변경한다.
회의록이나 슬랙 대화가 붙여넣어지면:
spec/으로 승격decision/으로 승격| 기준 | namespace | 예시 |
|---|---|---|
| 특정 프로젝트에 종속 | pj-{name}/{type}/{제목} | pj-sphere/decision/배포 전략 |
| 프로젝트 무관 범용 | {type}/{제목} | decision/Git worktree 운용 원칙 |
| 순수 개념 | 루트 {개념명} | 스테이블코인, 온오프램프 |
판단 기준: 이 문서가 특정 프로젝트 없이 의미가 있는가?
pj-{name}/{type}/{제목} (대부분의 decision, troubleshoot, debrief, qa, spec, incident){type}/{제목} (루트)안정도: 개념(L0) > 결정/스펙(L1) > 이벤트(L2) > 저널/세션(L3)
[[링크]]로 참조 → OKpj-{name}/{type}/{제목} (3 segment)pj-{name}/{type}/{sub-type}/{제목} 같은 4단 이상 금지pj-{name}.md는 {{query (namespace pj-{name})}} 로 하위 집계pages/pj-{name}___{type}___{제목}.md → Logseq에서 pj-{name}/{type}/{제목}로 표시pages/{type}___{제목}.md → Logseq에서 {type}/{제목}로 표시- prefix) 으로 작성TODO/DONE 키워드 사용. [ ]/[x] 마크다운 체크박스 사용 금지 (Logseq TODO 시스템과 통합되지 않음)페이지 최상단에 Logseq 네이티브 문법: