tink-harness 1.9.21 → 1.10.0

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.
@@ -2,13 +2,12 @@
2
2
 
3
3
  사람이 빠르게 훑어보기 위한 하네스 요약 모음. `index.json`이 진짜 원본이고, 이 파일은 사람용 색인입니다. 새 작업을 시작하기 전에 먼저 훑어서 기존 하네스를 재사용하거나 여러 하네스의 단계를 조합할 수 있을지 검토하세요.
4
4
 
5
+ ## 기본 절차 (하네스 없음)
6
+
7
+ 일반적인 코드 변경·버그 수정·조사·리뷰·문서 작업은 별도 하네스 없이 **기본 절차**로 진행합니다. 실행 상태 계약(`plan.md`, `checks.md`, `steps.json`, `contract.json`)이 범위·검증·증거를 이미 강제하므로, 범용 하네스는 기본 세트에서 퇴역했습니다. 하네스는 아래처럼 절차가 실제로 특화된 경우에만 선택합니다.
8
+
5
9
  ## 작업용 하네스
6
10
 
7
- - **[code-change](./code-change.md)** (small) — 범위가 명확한 코드 추가·변경·리팩토링. 관련 파일만 손대고 테스트 근거 남기기.
8
- - **[bug-fix](./bug-fix.md)** (small) — 재현 → 근본 원인 → 최소 수정 → 회귀 확인.
9
- - **[research](./research.md)** (small) — 옵션 비교, 문서 읽기, 근거 수집. 추측 분리, 다음 액션 명시.
10
- - **[review](./review.md)** (small) — 변경·위험·PR 검토. 실측 발견점만 기록.
11
- - **[docs](./docs.md)** (tiny) — README, 가이드, PRD. 독자와 다음 행동을 명확히.
12
11
  - **[requirements-interview](./requirements-interview.md)** (small) — 모호한 아이디어를 한 번에 한 질문씩 좁혀 성공 조건과 금지 조건을 명확히.
13
12
  - **[plan-consensus](./plan-consensus.md)** (small) — 큰 설계·리팩토링 계획을 Planner → Architect → Critic → Final 흐름으로 점검.
14
13
  - **[goal-checkpoint](./goal-checkpoint.md)** (small) — 긴 실행을 2-6개 목표와 완료 증거로 쪼개 `.tink/current/goals.json`에 기록.
@@ -1,79 +1,4 @@
1
1
  [
2
- {
3
- "name": "code-change",
4
- "kind": "built-in",
5
- "context": "small",
6
- "use_when": "Add, change, or refactor code with a clear scope.",
7
- "asks": [
8
- "What is the target?",
9
- "What should not change?"
10
- ],
11
- "checks": [
12
- "Related files only",
13
- "Tests or clear reason not run",
14
- "Diff evidence"
15
- ]
16
- },
17
- {
18
- "name": "bug-fix",
19
- "kind": "built-in",
20
- "context": "small",
21
- "use_when": "Something is broken and needs a minimal fix.",
22
- "asks": [
23
- "How can it be reproduced?",
24
- "Expected vs actual?"
25
- ],
26
- "checks": [
27
- "Reproduced or reason stated",
28
- "Root cause identified",
29
- "Regression checked"
30
- ]
31
- },
32
- {
33
- "name": "research",
34
- "kind": "built-in",
35
- "context": "small",
36
- "use_when": "Compare options, read docs, or collect grounded facts.",
37
- "asks": [
38
- "What decision should this support?",
39
- "What sources matter?"
40
- ],
41
- "checks": [
42
- "Decision named",
43
- "Facts separated from guesses",
44
- "Recommendation follows evidence"
45
- ]
46
- },
47
- {
48
- "name": "review",
49
- "kind": "built-in",
50
- "context": "small",
51
- "use_when": "Review changes, risks, or a PR/diff.",
52
- "asks": [
53
- "What is the base?",
54
- "What risks matter most?"
55
- ],
56
- "checks": [
57
- "Correctness/security/data/UX risk addressed",
58
- "Severity labeled per finding",
59
- "No speculative blockers"
60
- ]
61
- },
62
- {
63
- "name": "docs",
64
- "kind": "built-in",
65
- "context": "tiny",
66
- "use_when": "Write or improve README, guides, PRDs, or user-facing docs.",
67
- "asks": [
68
- "Who is the reader?",
69
- "What should they do next?"
70
- ],
71
- "checks": [
72
- "Audience clear",
73
- "Examples included if useful",
74
- "Plain language"
75
- ]
76
- },
77
2
  {
78
3
  "name": "requirements-interview",
79
4
  "kind": "built-in",
@@ -16,34 +16,6 @@
16
16
  "notes": "Rules stay file-based and small. They are not a public index, watcher, generated cache, or database-backed retrieval layer."
17
17
  },
18
18
  "nodes": [
19
- {
20
- "id": "harness:code-change",
21
- "type": "harness",
22
- "target": "code-change",
23
- "load": "retrievable",
24
- "phase": "classification",
25
- "budget_cost": 2,
26
- "keywords": ["code", "refactor", "implementation", "change"],
27
- "when": { "task_type": ["code_change"] },
28
- "select_harnesses": ["code-change"],
29
- "checks": ["Related files only", "Tests or clear reason not run", "Diff evidence"],
30
- "reason": "Code changes need a narrow implementation harness and explicit diff evidence.",
31
- "risk": "A generic docs or research harness can skip implementation checks."
32
- },
33
- {
34
- "id": "harness:bug-fix",
35
- "type": "harness",
36
- "target": "bug-fix",
37
- "load": "retrievable",
38
- "phase": "classification",
39
- "budget_cost": 2,
40
- "keywords": ["bug", "repro", "failure", "regression"],
41
- "when": { "task_type": ["bug_fix"], "has_repro": [true] },
42
- "select_harnesses": ["bug-fix"],
43
- "checks": ["Reproduced or reason stated", "Root cause identified", "Regression checked"],
44
- "reason": "Bug fixes should keep reproduction and regression evidence close to the change.",
45
- "risk": "Skipping reproduction can turn a bug fix into an unverified code edit."
46
- },
47
19
  {
48
20
  "id": "harness:requirements-interview",
49
21
  "type": "harness",
@@ -1,31 +0,0 @@
1
- # bug-fix
2
-
3
- ## When to use
4
- Something is broken and needs a minimal fix.
5
-
6
- ## Ask first
7
- - How can the bug be reproduced?
8
- - What is expected vs actual?
9
- - Is there a failing test, log, or screenshot?
10
-
11
- ## Plan
12
- 1. Reproduce or explain why reproduction is not possible.
13
- 2. Identify the likely root cause.
14
- 3. Make the smallest fix.
15
- 4. Run a regression check.
16
- 5. Report the evidence.
17
-
18
- ## Checks
19
- - Reproduction confirmed, or impossibility is explained.
20
- - Root cause identified, not just symptom.
21
- - Fix is minimal — no unrelated changes included.
22
- - Regression check run, or reason not run is stated.
23
- - Do not repeat questions already answered in `.tink/current/answers.md`.
24
-
25
- ## Done means
26
- - Bug no longer reproduces or risk is stated.
27
- - Root cause is explained.
28
- - Regression check is complete.
29
-
30
- ## If it fails, Tink back
31
- Return to the last safe step. State what failed, the last safe point, and the next single action.
@@ -1,30 +0,0 @@
1
- # code-change
2
-
3
- ## When to use
4
- Add, change, or refactor code with a clear scope.
5
-
6
- ## Ask first
7
- - What is the target behavior?
8
- - What files or areas are in scope?
9
- - What must not change?
10
-
11
- ## Plan
12
- 1. Inspect before editing.
13
- 2. Make the smallest useful change.
14
- 3. Avoid unrelated cleanup.
15
- 4. Run the relevant check.
16
- 5. Report changed files and evidence.
17
-
18
- ## Checks
19
- - Only target files modified; no unrelated changes.
20
- - Tests or build verified, or reason not run is stated.
21
- - Changed lines match stated scope — no unnoticed behavior shift.
22
- - Do not repeat questions already answered in `.tink/current/answers.md`.
23
-
24
- ## Done means
25
- - Only related files changed.
26
- - Tests/build pass, or reason not run is stated.
27
- - Diff evidence is available.
28
-
29
- ## If it fails, Tink back
30
- Return to the last safe step. State what failed, the last safe point, and the next single action.
@@ -1,30 +0,0 @@
1
- # docs
2
-
3
- ## When to use
4
- Write or improve README, guides, PRDs, or user-facing docs.
5
-
6
- ## Ask first
7
- - Who is the reader?
8
- - What should the reader do next?
9
- - What tone should be used?
10
-
11
- ## Plan
12
- 1. Define the reader and goal.
13
- 2. Outline first.
14
- 3. Use plain words.
15
- 4. Add examples only where useful.
16
- 5. Check for missing next steps.
17
-
18
- ## Checks
19
- - Reader and goal are explicitly stated.
20
- - At least one next action is present.
21
- - No jargon left undefined for the stated reader.
22
- - Do not repeat questions already answered in `.tink/current/answers.md`.
23
-
24
- ## Done means
25
- - Reader and action are clear.
26
- - Structure is easy to scan.
27
- - No unnecessary jargon.
28
-
29
- ## If it fails, Tink back
30
- Return to the last safe step. State what failed, the last safe point, and the next single action.
@@ -1,31 +0,0 @@
1
- # research
2
-
3
- ## When to use
4
- Compare options, read docs, or collect grounded facts.
5
-
6
- ## Ask first
7
- - What decision should this support?
8
- - Which sources or constraints matter?
9
- - How current does the answer need to be?
10
-
11
- ## Plan
12
- 1. Define the question.
13
- 2. Collect sources.
14
- 3. Separate facts from guesses.
15
- 4. Summarize tradeoffs.
16
- 5. Recommend the next action.
17
-
18
- ## Checks
19
- - Decision this research supports is named.
20
- - At least two options or sources are compared.
21
- - Facts and guesses are explicitly labeled.
22
- - Recommendation follows from evidence, not preference.
23
- - Do not repeat questions already answered in `.tink/current/answers.md`.
24
-
25
- ## Done means
26
- - Sources are linked.
27
- - Uncertainty is labeled.
28
- - Recommendation follows from evidence.
29
-
30
- ## If it fails, Tink back
31
- Return to the last safe step. State what failed, the last safe point, and the next single action.
@@ -1,31 +0,0 @@
1
- # review
2
-
3
- ## When to use
4
- Review changes, risks, or a PR/diff.
5
-
6
- ## Ask first
7
- - What should be reviewed?
8
- - What is the base or expected behavior?
9
- - Which risks matter most?
10
-
11
- ## Plan
12
- 1. Inspect changed files.
13
- 2. Prioritize correctness, security, data, and UX risks.
14
- 3. Check tests or evidence.
15
- 4. Write actionable findings only.
16
- 5. Avoid unsupported style noise.
17
-
18
- ## Checks
19
- - Correctness, security, data, and UX risk each addressed or noted absent.
20
- - Each finding has a severity label (blocker / major / minor / nit).
21
- - No speculative blockers — each is reproducible or evidence-based.
22
- - No unrelated style or preference noise.
23
- - Do not repeat questions already answered in `.tink/current/answers.md`.
24
-
25
- ## Done means
26
- - Findings are reproducible or evidence-based.
27
- - Severity is clear.
28
- - No speculative blockers.
29
-
30
- ## If it fails, Tink back
31
- Return to the last safe step. State what failed, the last safe point, and the next single action.