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
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "claude-dev-env",
3
- "version": "8.114.9",
3
+ "version": "8.114.10",
4
4
  "description": "Claude Code development standards — rules, hooks, agents, commands, and skills",
5
5
  "type": "module",
6
6
  "bin": {
@@ -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