claude-dev-env 1.92.0 → 1.92.1
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/CLAUDE.md +1 -39
- package/bin/install.mjs +1 -1
- package/package.json +1 -1
- package/rules/CLAUDE.md +5 -0
- package/rules/testing.md +0 -2
- package/skills/CLAUDE.md +2 -2
- package/skills/{team-advisor → orchestrator}/SKILL.md +9 -9
- package/skills/{team-advisor-refresh → orchestrator-refresh}/SKILL.md +5 -5
package/CLAUDE.md
CHANGED
|
@@ -6,15 +6,7 @@ The user delegates execution to you and expects zero manual steps unless strictl
|
|
|
6
6
|
|
|
7
7
|
## Timeless Documentation (all `.md` files)
|
|
8
8
|
|
|
9
|
-
|
|
10
|
-
|
|
11
|
-
- No historical/transitional language (`previously`, `now uses`, `instead of`, `migrated from`, `used to`, `no longer`, `as of`, `originally`, version-transition narration).
|
|
12
|
-
- No references to the conversation that produced the doc (`as discussed`, `Option A`, `after Round 3`).
|
|
13
|
-
|
|
14
|
-
Full banned-pattern set + enforcement: `~/.claude/rules/no-historical-clutter.md` (hook `state-description-blocker`) and `~/.claude/rules/self-contained-docs.md`.
|
|
15
|
-
|
|
16
|
-
## GOTCHAS
|
|
17
|
-
ALWAYS start each session with a /loop 15m populate or update the task list based on remaining todos.
|
|
9
|
+
Docs describe the current state only. Full rule set and enforcement: `~/.claude/rules/no-historical-clutter.md` (hook `state-description-blocker`) and `~/.claude/rules/self-contained-docs.md`.
|
|
18
10
|
|
|
19
11
|
## Choosing Edit vs Write
|
|
20
12
|
|
|
@@ -63,8 +55,6 @@ When changing how skills, rules, or hooks install or sync in this repo (for exam
|
|
|
63
55
|
|
|
64
56
|
## Additional Non-overlapping Rules
|
|
65
57
|
|
|
66
|
-
- **task_scope:** Match every action to what was explicitly requested. When intent is ambiguous, research official docs and present options via AskUserQuestion before making any changes. Proceed with edits only on explicit instruction.
|
|
67
|
-
- **confirm_implementation_forks:** When two or more viable paths would satisfy the goal and the choice changes the deliverable — its scope, completeness, deferred work, dependencies, or a hard-to-reverse contract — stop and ask which path via AskUserQuestion before implementing. A path that defers work or leaves a placeholder creating a follow-up task is itself a fork to surface, not a default to take silently. Phrase the question in plain language with only the detail needed to decide. See [`confirm-implementation-forks`](rules/confirm-implementation-forks.md).
|
|
68
58
|
- **disambiguate_overloaded_terms:** When a word in the request has two different technical meanings — "conflict" (git-merge versus functional/behavioral), "sync" (fast-forward versus commit), and the like — confirm which one is meant via AskUserQuestion before analyzing or acting.
|
|
69
59
|
|
|
70
60
|
## Serena (Code Intelligence MCP)
|
|
@@ -87,31 +77,3 @@ Before any coding task, call the `initial_instructions` tool to load the Serena
|
|
|
87
77
|
1. **Serena** — symbol-level navigation (declarations, references, implementations, rename)
|
|
88
78
|
2. **es.exe** — file-system search by name/path/extension/size/date (Everything CLI)
|
|
89
79
|
3. **Grep/Glob** — content and pattern matching
|
|
90
|
-
|
|
91
|
-
## Everything Search (es.exe CLI)
|
|
92
|
-
|
|
93
|
-
Search files by name, path, extension, size, or date with the Everything command-line tool `es.exe`. It reads the same live index the desktop app keeps, so results return instantly.
|
|
94
|
-
|
|
95
|
-
### Invocation and scope tokens
|
|
96
|
-
Run `es.exe` with a scoped query — a project path, an `ext:`/`dm:`/`size:` filter, or a name pattern. The `es_exe_path_rewriter` hook resolves a `{project-name}` placeholder or a bare registry key from `~/.claude/project-paths.json` into its quoted absolute path before the command runs (it allows and rewrites, never blocks).
|
|
97
|
-
|
|
98
|
-
### Hard limits
|
|
99
|
-
- Scope every search. A bare whole-drive scan or a network-share sweep is out of bounds.
|
|
100
|
-
|
|
101
|
-
### Fallback order
|
|
102
|
-
1. **es.exe** — file-system search by name/path/extension/size/date
|
|
103
|
-
2. **Debug** — try to find out why es.exe isn't working, and then prompt user for next-steps if you can't self-heal.
|
|
104
|
-
3. **Grep** — file-content search (Grep owns content)
|
|
105
|
-
4. **Glob** — relative-path pattern matching within the current project
|
|
106
|
-
|
|
107
|
-
### Search syntax quick reference
|
|
108
|
-
- `ext:py` — find by extension (multiple: `ext:ts | ext:js`)
|
|
109
|
-
- `path:src\components` — match against full path
|
|
110
|
-
- `*.config.*` — wildcards
|
|
111
|
-
- `size:>10mb` — size filter
|
|
112
|
-
- `dm:today` / `dm:thisweek` — date modified filter
|
|
113
|
-
- `-n 50` — limit results; `-sort dm` — sort by date modified
|
|
114
|
-
- `foo bar` — AND, `foo | bar` — OR, `!foo` — NOT
|
|
115
|
-
- `"exact phrase"` — literal match
|
|
116
|
-
|
|
117
|
-
Full operator reference: `skills/everything-search/SKILL.md`.
|
package/bin/install.mjs
CHANGED
|
@@ -147,7 +147,7 @@ const INSTALL_GROUPS = {
|
|
|
147
147
|
core: {
|
|
148
148
|
description: 'Development standards, hooks, agents, commands',
|
|
149
149
|
skills: [
|
|
150
|
-
'
|
|
150
|
+
'orchestrator', 'orchestrator-refresh',
|
|
151
151
|
'anthropic-plan', 'everything-search',
|
|
152
152
|
'pr-review-responder',
|
|
153
153
|
'recall', 'remember', 'task-build', 'verified-build'
|
package/package.json
CHANGED
package/rules/CLAUDE.md
CHANGED
|
@@ -1,3 +1,8 @@
|
|
|
1
|
+
---
|
|
2
|
+
paths:
|
|
3
|
+
- "**/rules/**"
|
|
4
|
+
---
|
|
5
|
+
|
|
1
6
|
# rules
|
|
2
7
|
|
|
3
8
|
Rule files installed into `~/.claude/rules/` by `bin/install.mjs`. Claude Code loads these as always-on behavioral constraints for every session. Each `.md` file covers one named rule; hook-enforced rules are also backed by a Python hook in `hooks/`.
|
package/rules/testing.md
CHANGED
package/skills/CLAUDE.md
CHANGED
|
@@ -26,8 +26,8 @@ Skills install to `~/.claude/skills/<skill-name>/` via `packages/claude-dev-env/
|
|
|
26
26
|
- `implement` — structured implementation from an existing plan packet
|
|
27
27
|
- `bdd-protocol` — BDD depth: Example Mapping, scenario quality, outside-in layout
|
|
28
28
|
- `verified-build` — build + test loop that gates on a verifier verdict
|
|
29
|
-
- `
|
|
30
|
-
- `
|
|
29
|
+
- `orchestrator` — turns the session into the advisor-orchestrator: it spawns executor subagents to do the code edits and test runs, and answers a blocked executor with a plan, correction, or stop
|
|
30
|
+
- `orchestrator-refresh` — sub-skill fired by the `/orchestrator` loop to re-assert the executor-advisor discipline mid-run
|
|
31
31
|
|
|
32
32
|
**PR review and convergence**
|
|
33
33
|
- `autoconverge` — autonomous single-run workflow that drives a PR to ready
|
|
@@ -1,5 +1,5 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: orchestrator
|
|
3
3
|
description: >-
|
|
4
4
|
Turns the session into the advisor-orchestrator — the user's sole interface,
|
|
5
5
|
to plan
|
|
@@ -10,14 +10,14 @@ description: >-
|
|
|
10
10
|
brief signals — a plan, a correction, or a stop. The advisor never edits
|
|
11
11
|
code or runs tests itself. Caps consultations per task (default 5), reuses
|
|
12
12
|
warm workflow agents before spawning new ones, and re-asserts the
|
|
13
|
-
discipline every 20 minutes through the /
|
|
13
|
+
discipline every 20 minutes through the /orchestrator-refresh loop. Adapts
|
|
14
14
|
Anthropic's coordinator pattern (plan big, execute small) to Claude Code.
|
|
15
|
-
Triggers: '/
|
|
16
|
-
|
|
15
|
+
Triggers: '/orchestrator', 'orchestrator strategy', 'run with an
|
|
16
|
+
orchestrator', 'executor-advisor mode', 'orchestrator enforcement', 'agent
|
|
17
17
|
routing', 'orchestrate'.
|
|
18
18
|
---
|
|
19
19
|
|
|
20
|
-
#
|
|
20
|
+
# Orchestrator Strategy
|
|
21
21
|
|
|
22
22
|
## Principle
|
|
23
23
|
|
|
@@ -42,7 +42,7 @@ drives the plan and answers the executors when they get stuck.
|
|
|
42
42
|
|
|
43
43
|
## Gotchas
|
|
44
44
|
|
|
45
|
-
- **Double invocation duplicates the reminder loop.** A second `/
|
|
45
|
+
- **Double invocation duplicates the reminder loop.** A second `/orchestrator`
|
|
46
46
|
in the same session schedules a second refresh loop. Check whether the loop
|
|
47
47
|
is already running before you schedule one (see the invocation guard in
|
|
48
48
|
Process step 1).
|
|
@@ -71,10 +71,10 @@ drives the plan and answers the executors when they get stuck.
|
|
|
71
71
|
second loop.
|
|
72
72
|
|
|
73
73
|
2. **Register the discipline reminder.** By default, schedule it with
|
|
74
|
-
`ScheduleWakeup` at `delaySeconds: 1200`, prompt `/
|
|
74
|
+
`ScheduleWakeup` at `delaySeconds: 1200`, prompt `/orchestrator-refresh`,
|
|
75
75
|
where each refresh re-schedules the next one — a 1200-second wakeup costs
|
|
76
76
|
one prompt-cache miss per firing and nothing more (see Gotchas). The loop
|
|
77
|
-
mechanism (`/loop 20m /
|
|
77
|
+
mechanism (`/loop 20m /orchestrator-refresh`) is the escape hatch when
|
|
78
78
|
`ScheduleWakeup` is not available. Either way the reminder is the
|
|
79
79
|
enforcement surface: each firing re-asserts the discipline while the run is
|
|
80
80
|
in flight.
|
|
@@ -167,7 +167,7 @@ Routing rules:
|
|
|
167
167
|
|
|
168
168
|
## Constraints
|
|
169
169
|
|
|
170
|
-
- One `/
|
|
170
|
+
- One `/orchestrator` per session; the invocation guard blocks a second
|
|
171
171
|
reminder loop.
|
|
172
172
|
- The advisor orchestrates and advises but never edits code or runs a build or
|
|
173
173
|
test itself — executors do that.
|
|
@@ -1,14 +1,14 @@
|
|
|
1
1
|
---
|
|
2
|
-
name:
|
|
2
|
+
name: orchestrator-refresh
|
|
3
3
|
description: >-
|
|
4
|
-
Fired by the /
|
|
4
|
+
Fired by the /orchestrator loop reminder about every 20 minutes to
|
|
5
5
|
re-assert the advisor discipline mid-run. A compressed restatement of
|
|
6
|
-
/
|
|
6
|
+
/orchestrator: orchestrate rather than execute, answer a blocked executor
|
|
7
7
|
with a plan, correction, or stop, and reuse warm agents before spawning new
|
|
8
|
-
ones. Triggers: '/
|
|
8
|
+
ones. Triggers: '/orchestrator-refresh'.
|
|
9
9
|
---
|
|
10
10
|
|
|
11
|
-
#
|
|
11
|
+
# Orchestrator Refresh
|
|
12
12
|
|
|
13
13
|
1. **You are the advisor.** Orchestrate and hold the user conversation; spawn
|
|
14
14
|
executor subagents to do all the work — every code edit and build or test
|