lee-spec-kit 0.4.3 → 0.4.5
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/package.json
CHANGED
|
@@ -30,6 +30,22 @@ Keep `tasks.md` aligned with reality.
|
|
|
30
30
|
- Do not mark `[DONE]` without actually completing the work and verifying criteria.
|
|
31
31
|
- If you need to change a completed task, add a new task instead of rewriting history.
|
|
32
32
|
|
|
33
|
+
### Step 3.5: Record decisions (strongly recommended, effectively required)
|
|
34
|
+
|
|
35
|
+
To avoid “why did we implement it like this?” losing context, **record any non-obvious or tradeoff-heavy implementation choice** in `decisions.md`.
|
|
36
|
+
|
|
37
|
+
Record a decision if any of these apply:
|
|
38
|
+
|
|
39
|
+
- There was a tradeoff (performance / reliability / security / maintainability)
|
|
40
|
+
- You introduced a new rule/heuristic/state transition (e.g., context detection logic, exception criteria)
|
|
41
|
+
- The user asked “why did you do it this way?” (requested rationale/justification)
|
|
42
|
+
- The user explicitly asked to change behavior (requirements/policy/criteria changes)
|
|
43
|
+
- You changed behavior for compatibility or as a workaround
|
|
44
|
+
- You changed data shape, file structure, or CLI output rules
|
|
45
|
+
- You expect future readers to ask “why this way?”
|
|
46
|
+
|
|
47
|
+
Use the feature’s `decisions.md` template format. (Context/Options/Decision/Rationale/Consequences)
|
|
48
|
+
|
|
33
49
|
### Step 4: Repeat
|
|
34
50
|
|
|
35
51
|
After finishing a meaningful chunk of work, run `context` again.
|
|
@@ -28,6 +28,24 @@ CLI가 가리키는 **Active Task** 또는 **Next Action**을 수행합니다.
|
|
|
28
28
|
|
|
29
29
|
### 3단계: 기록 및 반복 (Record & Loop)
|
|
30
30
|
|
|
31
|
+
#### 3-1) Decision 기록 (매우 권장, 사실상 필수)
|
|
32
|
+
|
|
33
|
+
에이전트가 “왜 이렇게 구현했지?” 라는 질문에 답할 수 있도록, **비직관적이거나 선택의 여지가 있었던 구현**이 들어갔다면 `decisions.md`에 반드시 기록합니다.
|
|
34
|
+
|
|
35
|
+
다음 중 하나라도 해당되면 기록하세요:
|
|
36
|
+
|
|
37
|
+
- 구현 방식에 대한 **트레이드오프(성능/안정성/보안/유지보수성)** 가 있었다
|
|
38
|
+
- **새로운 규칙/휴리스틱/상태 전이**가 추가되었다 (예: context 판단 로직, 예외 처리 기준)
|
|
39
|
+
- 사용자가 “왜 이렇게 했나요?” 라고 **이유/근거**를 물었다
|
|
40
|
+
- 사용자가 “이렇게 바꿔주세요” 처럼 **직접 변경을 요청**했다 (요구사항/정책/기준 변경 포함)
|
|
41
|
+
- 기존 동작을 **호환성/버그 회피** 목적으로 변경했다
|
|
42
|
+
- 데이터 구조/파일 구조/CLI 출력 규칙이 바뀌었다
|
|
43
|
+
- “나중에 보면 헷갈릴 것 같은” 결정이 있었다
|
|
44
|
+
|
|
45
|
+
작성 형식은 Feature의 `decisions.md` 템플릿을 따르세요. (Context/Options/Decision/Rationale/Consequences)
|
|
46
|
+
|
|
47
|
+
#### 3-2) 태스크/체크리스트 업데이트 + 커밋
|
|
48
|
+
|
|
31
49
|
1. 작업이 끝나면 해당 태스크의 상태를 `[DONE]`으로 변경하고, `Acceptance/Checklist` 항목을 `[x]`로 체크합니다.
|
|
32
50
|
2. 커밋을 생성합니다 (코드 커밋 + 문서 커밋).
|
|
33
51
|
3. **즉시 1단계로 돌아가** 다음 할 일을 CLI에게 물어봅니다.
|