docs: clarify discovery authoring decisions and validation

2026-10-01 05:31:34 +00:00
parent c50440b81b
commit d8320ef429
3 changed files with 17 additions and 11 deletions
@@ -62,7 +62,7 @@ Repository cache 경로는 고정된 machine-local 절대경로나 현재 작업
 - Linux OS advisory lock을 사용한다. lock file descriptor는 symlink를 따라가지 않는 방식으로 열고 원자적으로 lock을 획득한다.
 - 독립적인 신규 cache 초기화 순서는 `bootstrap.lock → repository.lock`이다.
 - Issue workflow가 기존 cache를 사용할 때의 순서는 `issue-<issue-number>.lock → repository.lock`이다.
- Issue workflow가 cache 초기화까지 수행할 때의 순서는 `issue-<issue-number>.lock → bootstrap.lock → repository.lock`이다. bootstrap 절차는 이미 획득한 Issue lock을 해제하거나 다시 획득하지 않는다.
+- Issue 작업에 사용할 cache가 없으면 Issue lock 획득 전에 신규 cache 초기화 절차를 완료한다. 초기화 중에는 Issue를 변경하지 않는다. Bootstrap의 repository lock과 bootstrap lock을 모두 해제한 뒤 Issue lock을 획득하며, 이후에는 기존 cache 사용 순서인 `issue-<issue-number>.lock → repository.lock`을 따른다. Issue 작업의 기준 snapshot은 Issue lock 획득 후 읽는다.
 - Worktree 생성, 등록, lock, 이동, 제거 또는 repair는 Issue lock을 유지한 채 repository lock을 추가로 획득해서 수행한다. 일반 파일 편집, 테스트와 commit에는 Issue lock만 유지하고 repository lock은 보유하지 않는다.
 - 같은 repository의 다른 Issue worktree를 검사, 변경 또는 제거하지 않는다. 한 Issue workflow는 자신의 exact Issue worktree만 다룬다.
 - 반대 순서로 lock을 획득하거나 이미 잡은 상위 lock을 해제한 뒤 하위 작업을 계속하지 않는다.