@tablation/crew 0.117.0 → 0.117.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/package.json
CHANGED
|
@@ -93,6 +93,11 @@ available only in a repository whose hooks table declares `preview`.
|
|
|
93
93
|
the URL. Tell them where it is once, early: the URL always, and, when you
|
|
94
94
|
are the operator's own session on this ship (not a Passenger's chat), the
|
|
95
95
|
worktree path as well, so they can open the files directly.
|
|
96
|
+
- **When the person refers to something on the page** ("this", "here",
|
|
97
|
+
"that heading"), read the newest line of `.crew/pointed-at.jsonl` in the
|
|
98
|
+
periscope's worktree before searching; it names the file and line they
|
|
99
|
+
clicked. If the file is empty, ask them to point at it with the inspector
|
|
100
|
+
or paste the location.
|
|
96
101
|
- **When a dev lane is mid-flight on the same files** (visible from the
|
|
97
102
|
roster and the board), say so, so the person knows a merge is coming.
|
|
98
103
|
- **Before keep,** read back the ticket title and a one-paragraph summary of
|
|
@@ -424,6 +424,26 @@ before going further, and never change a ticket's `report_type` yourself.
|
|
|
424
424
|
sets the ticket back to `in_progress` instead of passing it to QA. A ticket
|
|
425
425
|
with no Acceptance section is unaffected.
|
|
426
426
|
|
|
427
|
+
### Finding where something lives
|
|
428
|
+
|
|
429
|
+
Before you read or edit, locate the code once, in this order:
|
|
430
|
+
|
|
431
|
+
1. **The map.** Read the "Repository map" section of this brief (when the
|
|
432
|
+
repository has one) and the repository's own instructions file, which may
|
|
433
|
+
also say where things live.
|
|
434
|
+
2. **The symbol tools.** When the Environment section lists code tools, use
|
|
435
|
+
them for code questions before searching text: find a symbol by name, list
|
|
436
|
+
its references, read its definition, outline a file. Text search is for
|
|
437
|
+
strings that are not symbols.
|
|
438
|
+
3. **One broad search.** To find a visible string, search for it once across
|
|
439
|
+
the whole relevant tree, excluding tests, and prefer registries over
|
|
440
|
+
components. A search that found only a test file is widened, not
|
|
441
|
+
narrowed.
|
|
442
|
+
|
|
443
|
+
Count the calls: if more than three searches have not found the location, say
|
|
444
|
+
so in your progress comment and ask for the map or the person's pointer
|
|
445
|
+
rather than continuing to search.
|
|
446
|
+
|
|
427
447
|
## Step 4 — you never merge, and you never deploy
|
|
428
448
|
|
|
429
449
|
**Nothing you do touches the base branch.** The release phase takes every
|
|
@@ -93,6 +93,11 @@ available only in a repository whose hooks table declares `preview`.
|
|
|
93
93
|
the URL. Tell them where it is once, early: the URL always, and, when you
|
|
94
94
|
are the operator's own session on this ship (not a Passenger's chat), the
|
|
95
95
|
worktree path as well, so they can open the files directly.
|
|
96
|
+
- **When the person refers to something on the page** ("this", "here",
|
|
97
|
+
"that heading"), read the newest line of `.crew/pointed-at.jsonl` in the
|
|
98
|
+
periscope's worktree before searching; it names the file and line they
|
|
99
|
+
clicked. If the file is empty, ask them to point at it with the inspector
|
|
100
|
+
or paste the location.
|
|
96
101
|
- **When a dev lane is mid-flight on the same files** (visible from the
|
|
97
102
|
roster and the board), say so, so the person knows a merge is coming.
|
|
98
103
|
- **Before keep,** read back the ticket title and a one-paragraph summary of
|
|
@@ -419,6 +419,26 @@ before going further, and never change a ticket's `report_type` yourself.
|
|
|
419
419
|
sets the ticket back to `in_progress` instead of passing it to QA. A ticket
|
|
420
420
|
with no Acceptance section is unaffected.
|
|
421
421
|
|
|
422
|
+
### Finding where something lives
|
|
423
|
+
|
|
424
|
+
Before you read or edit, locate the code once, in this order:
|
|
425
|
+
|
|
426
|
+
1. **The map.** Read the "Repository map" section of this brief (when the
|
|
427
|
+
repository has one) and the repository's own instructions file, which may
|
|
428
|
+
also say where things live.
|
|
429
|
+
2. **The symbol tools.** When the Environment section lists code tools, use
|
|
430
|
+
them for code questions before searching text: find a symbol by name, list
|
|
431
|
+
its references, read its definition, outline a file. Text search is for
|
|
432
|
+
strings that are not symbols.
|
|
433
|
+
3. **One broad search.** To find a visible string, search for it once across
|
|
434
|
+
the whole relevant tree, excluding tests, and prefer registries over
|
|
435
|
+
components. A search that found only a test file is widened, not
|
|
436
|
+
narrowed.
|
|
437
|
+
|
|
438
|
+
Count the calls: if more than three searches have not found the location, say
|
|
439
|
+
so in your progress comment and ask for the map or the person's pointer
|
|
440
|
+
rather than continuing to search.
|
|
441
|
+
|
|
422
442
|
## Step 4 — you never merge, and you never deploy
|
|
423
443
|
|
|
424
444
|
**Nothing you do touches the base branch.** The release phase takes every
|