qbarev/para-plugin

프로젝트

프로젝트는 정의된 목표와 종료 상태가 있는 활동입니다 — 지속적인 영역(Area)과는 다릅니다. 프로젝트는 보관소의 폴더와 작업 백엔드의 프로젝트가 쌍을 이룹니다: 폴더는 프로젝트의 의미를 담고, 백엔드는 작업(tasks.md)을 관리합니다. 모든 작업 호출은 tasks.md의 작업이며, TASKS용 어댑터에 따라 실행됩니다.

기본 계층

행동하기 전에, 이 스킬의 기본 디렉토리 기준 ../../para/<file>.md를 각각 읽으십시오 — 이 파일들은 공유 규칙을 담고 있으므로 기억에서 다시 진술하지 마십시오:

• ../../para/paths.md — 항상, «Language» 포함: 아래 문자열은 lang/<LANG>.md에서 가져옵니다.
• ../../para/tasks.md — 항상: 작업, 페어링, 작업의 정의.
• ../../para/find-target.md — overview 및 task용.
• ../../para/note-format.md — create용; 모든 하위 명령에 대해 «레거시 필드(Legacy fields)».
• ../../para/project-id.md — create용.
• ../../para/dod.md — create(project.dod 섹션 작성) 및 overview용.
• ../../para/thresholds.md — list 및 overview용: 프로젝트 순서, 부실, 지평선, 작업 개수, 출력 크기.
• ../../para/confirm.md — create 및 task 쓰기(티어 1); list 및 overview는 쓰지 않음.
• ../../para/move.md — create용, 충돌 가능성이 있는 폴더를 쓰기 전에.

하위 명령

$ARGUMENTS의 첫 번째 단어가 하위 명령을 선택합니다: list, create, overview, task. 이 중 하나가 아니면, 표현에서 의미를 파악하여 선택한 내용을 알리십시오. 빈 $ARGUMENTS → list를 실행한 후 무엇을 할지 물으십시오.

모든 하위 명령은 작업 백엔드보다 먼저 만들어진 프로젝트를 처리합니다: status, Tasks/(note-format.md에서 레거시 시점을 명시), tasks_ref 필드 없음. note-format.md «레거시 필드(Legacy fields)»에 따라 읽고 보고하되, 절대 다시 쓰지 마십시오.

---

create <description> — 프로젝트 시작

입력: 프로젝트의 내용, 목표, 마감일, 첫 단계. 비어 있음 → 프로젝트 내용과 목표를 물으십시오.

1. Templates/Project.md 를 디스크에서 있는 그대로 읽습니다.

2. 제목을 도출합니다(note-format.md에 따라). 제목은 세 가지 방식으로 사용됩니다: title 및 H1(접두사 없이), 그리고 — 접두사를 포함하여 — 폴더 이름 및 개요 파일 이름으로. note-format.md에 따라 short를 제안합니다.

3. ID를 발급합니다(project-id.md에 따라).

4. 폴더 구조를 생성합니다(Projects/ 아래):

   PROJ-xxxx <title>/
   ├── PROJ-xxxx <title>.md      ← 개요, Templates/Project.md에서
   ├── Notes/
   ├── Resources/
   └── Results/
   

   세 하위 폴더 모두, 비어 있더라도. Tasks/는 없음(TASKS = files에서 어댑터가 첫 번째 작업과 함께 생성).

5. 머리말(frontmatter)을 채웁니다(note-format.md의 Project 행에 따라). created는 오늘 날짜. deadline은 설명이 제공하는 경우에만. tasks_ref는 7단계까지 비워 둡니다(pairing: none에서는 필드를 생략).

6. 본문을 채웁니다:

   • project.goal 섹션 — 목표 / 원하는 종료 상태. 필수.
   • project.value 섹션 — 사용자가 얻는 이점, 측정 가능하거나 모호하지 않음(note-format.md,