claude-dev-env 8.114.9 → 8.114.10
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.
|
@@ -11,7 +11,7 @@ User-level rule: applies to **every** git repo that uses GitHub with `gh`. Small
|
|
|
11
11
|
|
|
12
12
|
### Workflow decision tree
|
|
13
13
|
|
|
14
|
-
**When to use stacked PRs:** Feature B depends on Feature A's implementation
|
|
14
|
+
**When to use stacked PRs:** Feature B depends on Feature A's implementation. See the Delivery section of `~/.claude/docs/rule-guides/verified-work.md`.
|
|
15
15
|
|
|
16
16
|
**When to extract shared infrastructure first:** Multiple features need same utilities/helpers
|
|
17
17
|
|
|
@@ -6,7 +6,7 @@ Back to the [rules index](../../rules/index.md).
|
|
|
6
6
|
|
|
7
7
|
Research, plan, and build; a fresh `verifier` agent checks each step and reproduces the issue before it confirms the fix. Report only verified results. Ask before new scope.
|
|
8
8
|
|
|
9
|
-
Every piece of work runs in six steps: research, verify the research, plan, verify the plan, implement, verify the fix. A separate `verifier` agent runs each verify step. The fix check reproduces the issue on the old state first, then confirms it is gone on the new state. The user gets only results a verifier passed. New scope goes to the user as one question before it is built.
|
|
9
|
+
Every piece of work runs in six steps: research, verify the research, plan, verify the plan, implement, verify the fix. A separate `verifier` agent runs each verify step. The fix check reproduces the issue on the old state first, then confirms it is gone on the new state. The user gets only results a verifier passed. New scope goes to the user as one question before it is built. Each piece a verifier passes is committed alone, as its own stack level.
|
|
10
10
|
|
|
11
11
|
**When this applies:** Any task: a change to code, configuration, rules, or a document, and any finding, cause, or fix reported to the user.
|
|
12
12
|
|
|
@@ -19,6 +19,14 @@ Every piece of work runs in six steps: research, verify the research, plan, veri
|
|
|
19
19
|
5. **Implement.** Build the in-scope pieces.
|
|
20
20
|
6. **Verify the fix.** Spawn a fresh `verifier` in fix mode. It reproduces the issue on the old state, confirms the issue is gone on the new state, and confirms an undo of the fix fails again. When no scratch copy can revert the fix, such as an installed setting, it reports UNDO NOT RUN with the reason, and REPRODUCED plus FIXED still pass. A fix whose issue did not reproduce does not pass.
|
|
21
21
|
|
|
22
|
+
## Delivery
|
|
23
|
+
|
|
24
|
+
When a piece's verifier passes, commit that piece alone, as its own stack level. The subject names that one behaviour. Start the next piece on top of it. A piece that depends on nothing earlier goes on its own branch from trunk.
|
|
25
|
+
|
|
26
|
+
Stack with `gt create` where Graphite is installed. Without Graphite, use a plain branch from the previous level, made with `git switch -c <branch>`. The pieces in the plan set the levels, so a reviewer reads one purpose at a time.
|
|
27
|
+
|
|
28
|
+
This applies where the brief and the user allow commits. A worker whose brief bars git writes hands the piece back uncommitted and says so.
|
|
29
|
+
|
|
22
30
|
## The verifier
|
|
23
31
|
|
|
24
32
|
- The verifier is never the agent that did the work. The spawner is the owner of the work. A fresh agent at each verify step keeps the check apart from the author.
|
package/package.json
CHANGED
|
@@ -5,6 +5,7 @@ from pathlib import Path
|
|
|
5
5
|
PACKAGE_ROOT = Path(__file__).resolve().parents[2]
|
|
6
6
|
INDEX_PATH = PACKAGE_ROOT / "rules" / "index.md"
|
|
7
7
|
GUIDE_PATH = PACKAGE_ROOT / "docs" / "rule-guides" / "verified-work.md"
|
|
8
|
+
PR_LIFECYCLE_PATH = PACKAGE_ROOT / ".agents" / "skills" / "pr-lifecycle" / "SKILL.md"
|
|
8
9
|
|
|
9
10
|
|
|
10
11
|
def test_the_index_points_every_session_at_the_verified_work_guide() -> None:
|
|
@@ -38,3 +39,51 @@ def test_the_guide_keeps_the_verifier_apart_and_asks_before_new_scope() -> None:
|
|
|
38
39
|
assert "A fix whose issue did not reproduce does not pass." in guide_text
|
|
39
40
|
assert "New scope goes to the user as one question before any of it is built" in guide_text
|
|
40
41
|
assert "In-scope work runs with no ask." in guide_text
|
|
42
|
+
|
|
43
|
+
|
|
44
|
+
def _delivery_section(guide_text: str) -> str:
|
|
45
|
+
return guide_text.split("## Delivery", 1)[1].split("\n## ", 1)[0]
|
|
46
|
+
|
|
47
|
+
|
|
48
|
+
def test_the_guide_delivers_each_passed_piece_as_its_own_stack_level() -> None:
|
|
49
|
+
delivery_text = _delivery_section(GUIDE_PATH.read_text(encoding="utf-8"))
|
|
50
|
+
assert "When a piece's verifier passes, commit that piece alone, as its own stack level." in delivery_text
|
|
51
|
+
assert "The subject names that one behaviour." in delivery_text
|
|
52
|
+
assert "Start the next piece on top of it." in delivery_text
|
|
53
|
+
assert "A piece that depends on nothing earlier goes on its own branch from trunk." in delivery_text
|
|
54
|
+
|
|
55
|
+
|
|
56
|
+
def test_the_guide_names_the_stacking_command_for_each_setup() -> None:
|
|
57
|
+
delivery_text = _delivery_section(GUIDE_PATH.read_text(encoding="utf-8"))
|
|
58
|
+
assert "`gt create`" in delivery_text
|
|
59
|
+
assert "a plain branch from the previous level" in delivery_text
|
|
60
|
+
|
|
61
|
+
|
|
62
|
+
def test_the_guide_keeps_six_steps_and_sets_delivery_after_them() -> None:
|
|
63
|
+
guide_text = GUIDE_PATH.read_text(encoding="utf-8")
|
|
64
|
+
assert "## The six steps" in guide_text
|
|
65
|
+
assert guide_text.index("6. **Verify the fix.**") < guide_text.index("## Delivery")
|
|
66
|
+
assert guide_text.index("## Delivery") < guide_text.index("## The verifier")
|
|
67
|
+
|
|
68
|
+
|
|
69
|
+
def test_the_guide_sets_no_line_or_file_count_on_a_level() -> None:
|
|
70
|
+
delivery_text = _delivery_section(GUIDE_PATH.read_text(encoding="utf-8")).lower()
|
|
71
|
+
assert "lines" not in delivery_text
|
|
72
|
+
assert "files" not in delivery_text
|
|
73
|
+
|
|
74
|
+
|
|
75
|
+
def test_the_guide_limits_delivery_commits_to_where_the_brief_and_user_allow_them() -> None:
|
|
76
|
+
delivery_text = _delivery_section(GUIDE_PATH.read_text(encoding="utf-8"))
|
|
77
|
+
assert "This applies where the brief and the user allow commits." in delivery_text
|
|
78
|
+
assert "A worker whose brief bars git writes hands the piece back uncommitted and says so." in delivery_text
|
|
79
|
+
|
|
80
|
+
|
|
81
|
+
def test_the_pull_request_skill_points_its_decision_tree_at_the_delivery_section() -> None:
|
|
82
|
+
skill_text = PR_LIFECYCLE_PATH.read_text(encoding="utf-8")
|
|
83
|
+
decision_tree = skill_text.split("### Workflow decision tree", 1)[1].split("\n### ", 1)[0]
|
|
84
|
+
assert "Feature B depends on Feature A's implementation." in decision_tree
|
|
85
|
+
assert "Delivery section of `~/.claude/docs/rule-guides/verified-work.md`" in decision_tree
|
|
86
|
+
assert "its own stack level" not in decision_tree
|
|
87
|
+
assert "independent piece" not in decision_tree
|
|
88
|
+
assert "`gt create`" not in decision_tree
|
|
89
|
+
assert "a plain branch from the previous level" not in decision_tree
|