relaytask 0.1.0__py3-none-any.whl

relaytask/__init__.py

@@ -0,0 +1 @@
+"""RelayTask standalone scripts package."""

relaytask/__main__.py

@@ -0,0 +1,4 @@
+from .cli import main
+
+if __name__ == "__main__":
+    raise SystemExit(main())

relaytask/assets/AGENTS.md.template

@@ -0,0 +1,26 @@
+# Task Workspace AGENTS
+
+- 기본 언어: 한글
+- 이 디렉터리는 하나의 작업 컨텍스트를 담는다.
+- 작업 시작 전 `PLAN.md`, `STATUS.json`, `DECISIONS.md`를 먼저 읽는다.
+- 각 repo 내부의 `AGENT.md` 또는 `AGENTS.md`를 추가로 확인한다.
+- repo 내부 가이드라인은 구현 규칙의 기준이며, 이 문서는 태스크 운영 규칙의 기준이다.
+- 다음 작업자는 `STATUS.json`만 보고도 바로 직전 작업을 재개할 수 있어야 한다.
+
+## 작업 목표
+- [이 작업의 한 줄 목표]
+
+## 포함 Repo
+- `repo-a`: [포함 이유]
+- `repo-b`: [포함 이유]
+
+## 참조 가이드
+[참조 가이드 경로 목록]
+
+## 작업 규칙
+- 상위 문서는 task 규칙을 담고, repo 내부 문서는 구현 규칙을 담는다.
+- repo 범위 변경 시 `STATUS.json`과 이 문서를 함께 갱신한다.
+- 중요한 판단은 `DECISIONS.md`에 기록한다.
+- 세션 시작 시 `STATUS.json`의 `current_goal`, `in_progress`, `next_actions`, `resume_steps`를 먼저 최신화한다.
+- 세션 종료 전 `STATUS.json`의 `last_work`, `next_actions`, `resume_steps`를 반드시 갱신한다.
+- `재개 절차`에는 다음 작업자가 바로 실행할 명령, 열 파일, 확인 포인트를 남긴다.

relaytask/assets/DECISIONS.md.template

@@ -0,0 +1,5 @@
+# DECISIONS
+
+## YYYY-MM-DD
+- [결정 내용]
+- [이유 또는 영향]

relaytask/assets/PLAN.md.template

@@ -0,0 +1,12 @@
+# PLAN
+
+## 목표
+- [작업 목표]
+
+## 작업 범위
+- [ ] [repo-a 작업]
+- [ ] [repo-b 작업]
+- [ ] 통합 검증
+
+## 완료 조건
+- [완료 기준]

relaytask/assets/REFS.md.template

@@ -0,0 +1,10 @@
+# REFS
+
+## 목적
+- 이 디렉터리는 최신 기준 브랜치의 읽기 전용 참조 worktree 집합이다.
+- 책임 경계, 호출 흐름, 기존 구현 방식을 확인할 때만 사용한다.
+
+## 규칙
+- 여기서 직접 구현하지 않는다.
+- 구현은 각 task 디렉터리의 feature branch worktree에서 한다.
+- 기준 브랜치명은 repo별로 명시한다.

relaytask/assets/STATUS.json.template

@@ -0,0 +1,28 @@
+{
+  "schema_version": 1,
+  "updated_at": "[UPDATED_AT]",
+  "current_goal": [
+    "[CURRENT_GOAL]"
+  ],
+  "completed": [
+    "[COMPLETED]"
+  ],
+  "last_work": [
+    "[LAST_WORK]"
+  ],
+  "in_progress": [
+    "[IN_PROGRESS]"
+  ],
+  "next_actions": [
+    "[NEXT_ACTION_1]",
+    "[NEXT_ACTION_2]"
+  ],
+  "resume_steps": [
+    "[RESUME_STEP_1]",
+    "[RESUME_STEP_2]",
+    "[RESUME_STEP_3]"
+  ],
+  "links": [
+    "[LINK_1]"
+  ]
+}

relaytask/assets/SYSTEM_MAP.md.template

@@ -0,0 +1,15 @@
+# SYSTEM MAP
+
+## 개요
+- [시스템 전체를 한두 문장으로 설명]
+
+## Repo Map
+| Repo | 소유 책임 | 소유하지 않는 것 | 보통 같이 보는 Repo | 포함 트리거 |
+|---|---|---|---|---|
+| repo-a | [책임] | [비책임] | [adjacent repos] | [언제 포함하는지] |
+| repo-b | [책임] | [비책임] | [adjacent repos] | [언제 포함하는지] |
+
+## 선택 규칙
+- 도메인 규칙 변경이면 원천 소유 repo를 우선 포함한다.
+- API 조합/응답 형태 변경이면 aggregation/BFF repo를 포함한다.
+- 배포/런타임 검증이 필요하면 그 레이어 repo를 추가한다.

relaytask/assets/TASKS.md.template

@@ -0,0 +1,12 @@
+# TASKS
+
+| Task | State | Included Repos | Base / Feature / Promote | PR / Deploy | Last Updated |
+|---|---|---|---|---|---|
+
+## State Guide
+- `planned`: task defined, worktrees not ready
+- `ready`: repos selected, worktrees created
+- `in-progress`: implementation active
+- `review`: PR open or validation running
+- `merged`: merged to mainline/develop
+- `deployed`: runtime promotion completed

relaytask/assets/TASK_OVERVIEW.md.template

@@ -0,0 +1,28 @@
+# Task Overview
+
+## Task
+- 이름: [태스크 이름]
+- 상태: [태스크 상태]
+- 요약: [태스크 요약]
+- 브랜치: [태스크 브랜치]
+
+## Selected Repos
+| Repo | Base Branch | Worktree | Guide Snapshot |
+|---|---|---|---|
+[TASK_REPO_ROWS]
+
+## Status Snapshot
+- 현재 목표: [현재 목표]
+- 진행 중: [진행 중]
+- 다음 액션: [다음 액션]
+
+## Files
+- `AGENTS.md`
+- `PLAN.md`
+- `STATUS.json`
+- `DECISIONS.md`
+- `SYSTEM_MAP.md`
+- `.context/repo-guides/`
+
+## Promotion
+- feature -> develop -> main PR

relaytask/assets/WORKSPACE.md.template

@@ -0,0 +1,14 @@
+# WORKSPACE
+
+## 이름
+- [워크스페이스 이름]
+
+## 설명
+- [워크스페이스 설명]
+
+## 구성 원칙
+- 이 워크스페이스는 task-first 멀티레포 작업을 관리한다.
+- 상위 `TASKS.md`는 전체 작업 목록을 담는다.
+- 상위 `SYSTEM_MAP.md`는 repo 책임과 선택 기준을 담는다.
+- `refs/`는 읽기 전용 mainline 참조 레이어다.
+- 각 task 디렉터리는 구현과 상태 기록의 단위다.

relaytask/assets/WORKSPACE_OVERVIEW.md.template

@@ -0,0 +1,35 @@
+# Workspace Overview
+
+## Workspace
+- 이름: [워크스페이스 이름]
+- 설명: [워크스페이스 설명]
+
+## Layout
+```text
+[워크스페이스 루트]
+  TASKS.md
+  WORKSPACE.md
+  SYSTEM_MAP.md
+  OVERVIEW.md
+  refs/
+  .meta/
+  <task-name>/
+```
+
+## Repo Catalog
+| Repo | Base Branch | Summary | Keywords |
+|---|---|---|---|
+[REPO_CATALOG_ROWS]
+
+## Lifecycle
+1. `workspace-init`
+2. `task-new`
+3. `task-list`
+4. `task-continue`
+5. `task-promote`
+6. `task-release`
+
+## Rules
+- `refs/`는 읽기 전용 참조 레이어다.
+- task별 상태는 각 task의 `STATUS.json`이 최신 기준이다.
+- 전체 현황은 상위 `TASKS.md`에서 본다.