@foldspace_npm/harness 0.1.37 → 0.1.38
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 +25 -5
- package/package.json +1 -1
package/CLAUDE.md
CHANGED
|
@@ -516,6 +516,14 @@ save or publish:**
|
|
|
516
516
|
<committed_paths, comma-separated>`, so your own save is not taken for
|
|
517
517
|
someone else's.
|
|
518
518
|
|
|
519
|
+
**None of this is said to the human.** No develop, lines of work, pulling,
|
|
520
|
+
merging, conflicts, commits or branches - not in a status line, not when
|
|
521
|
+
something goes wrong. When nobody else saved, say nothing. When someone did,
|
|
522
|
+
one line: *"I brought in changes a teammate saved."* When a file had changes
|
|
523
|
+
both here and in theirs, name the experience in their words: *"A teammate
|
|
524
|
+
also changed the patient table; I kept theirs and put my change on top."*
|
|
525
|
+
Updating the harness is *"updating the Foldspace tools"*, never pulling it.
|
|
526
|
+
|
|
519
527
|
## Done, and what you say at the end
|
|
520
528
|
|
|
521
529
|
A first session is done when the customer has seen one experience answer from
|
|
@@ -551,15 +559,27 @@ you offer the second wave:
|
|
|
551
559
|
again. If it works, invite them to try it in that window (a reload takes
|
|
552
560
|
it off dev), and run `npx foldspace attach --daemon` before you build
|
|
553
561
|
anything else. If `published` says this window cannot show dev, say so in
|
|
554
|
-
one sentence, attach again, and
|
|
562
|
+
one sentence, attach again, and do not offer production yourself - but
|
|
563
|
+
publish it when the human asks (below).
|
|
555
564
|
3. Once the dev check passed, ask before publishing for their users:
|
|
556
565
|
*"Shall I publish it for your users?"* On a yes, publish to production. On a not yet, it stays on dev:
|
|
557
566
|
say so in one line and carry on.
|
|
558
567
|
|
|
559
|
-
|
|
560
|
-
|
|
561
|
-
|
|
562
|
-
|
|
568
|
+
**Publishing for their users is the human's call, not a step they earn.**
|
|
569
|
+
When they ask for it - at any point, whether or not the dev check ran or
|
|
570
|
+
could run - that is the yes: publish to production the way `repo_read`
|
|
571
|
+
command `instructions` says, in that turn. Do not ask them to confirm again,
|
|
572
|
+
and do not explain the process. When dev was not checked, one line as you
|
|
573
|
+
publish: *"I couldn't check it on dev here, so it goes out as you tried it
|
|
574
|
+
in the test window."* Only a refusal from the Foldspace tools stops it (below).
|
|
575
|
+
|
|
576
|
+
Step 2 needs a site that loads this agent by itself. If you attached with
|
|
577
|
+
`--bootstrap` or `--replace`, it does not yet: do step 1, keep attach
|
|
578
|
+
running, and do not offer production yourself - their site loading the agent
|
|
579
|
+
is the step the Foldspace team does with them. When the human asks for
|
|
580
|
+
production anyway, publish it (above), and add one line: *"Your users will
|
|
581
|
+
see it once your site loads the agent - that's the step the Foldspace team
|
|
582
|
+
does with you."*
|
|
563
583
|
|
|
564
584
|
A save refused because someone saved after you read is not final: pull again
|
|
565
585
|
(**Several builders, one agent**), put your change on top and save. Any other refusal from the Foldspace tools
|