sisyphi 1.2.11 → 1.2.13
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/dist/daemon.js +1 -1
- package/dist/daemon.js.map +1 -1
- package/dist/templates/agent-plugin/agents/operator.md +1 -1
- package/dist/templates/agent-plugin/agents/problem.md +6 -6
- package/dist/templates/agent-plugin/hooks/ask-background-guard.sh +1 -1
- package/dist/templates/agent-plugin/hooks/operator-user-prompt.sh +2 -2
- package/dist/templates/agent-plugin/skills/operator/SKILL.md +1 -1
- package/dist/templates/orchestrator-base.md +1 -1
- package/dist/templates/orchestrator-completion.md +1 -1
- package/dist/templates/orchestrator-discovery.md +5 -5
- package/dist/templates/orchestrator-plugin/commands/sisyphus/strategize.md +1 -1
- package/package.json +1 -1
- package/templates/agent-plugin/agents/operator.md +1 -1
- package/templates/agent-plugin/agents/problem.md +6 -6
- package/templates/agent-plugin/hooks/ask-background-guard.sh +1 -1
- package/templates/agent-plugin/hooks/operator-user-prompt.sh +2 -2
- package/templates/agent-plugin/skills/operator/SKILL.md +1 -1
- package/templates/orchestrator-base.md +1 -1
- package/templates/orchestrator-completion.md +1 -1
- package/templates/orchestrator-discovery.md +5 -5
- package/templates/orchestrator-plugin/commands/sisyphus/strategize.md +1 -1
|
@@ -38,7 +38,7 @@ Don't guess the target. The product might be a browser page, an Electron app, or
|
|
|
38
38
|
|
|
39
39
|
You have a memory file at `.sisyphus/agent-plugin/skills/operator/SKILL.md`, plus per-task-family reference files alongside it. **Read it now** — it's accumulated knowledge from prior operator runs in this project (auth flow, db reset, common surfaces, known footguns). It scaffolds itself on first use; if it looks like a stub, you're the first.
|
|
40
40
|
|
|
41
|
-
**Before submitting your final report**, run `
|
|
41
|
+
**Before submitting your final report**, run `crtr skill read sisyphus/operator-memory` (`.content`) — it covers when and how to update the memory so the next operator starts ahead of where you started. For generic skill-authoring conventions (frontmatter, length, structure), defer to `crtr skill read claude-authoring/skills` (`.content`).
|
|
42
42
|
|
|
43
43
|
## Unblock Yourself
|
|
44
44
|
|
|
@@ -71,7 +71,7 @@ Naturally shift lenses as you explore. Weave them into conversation rather than
|
|
|
71
71
|
- **Precedent** — Has this kind of problem been faced before? In this codebase, in open source, in a different domain entirely?
|
|
72
72
|
|
|
73
73
|
Cycle through these as the conversation unfolds. Each lens reveals something different.
|
|
74
|
-
t MEDIUM+ effort, lenses can also be spawned as parallel sub-agents — run `
|
|
74
|
+
t MEDIUM+ effort, lenses can also be spawned as parallel sub-agents — run `crtr skill read sisyphus/perspective-fanout` (`.content`) for two distinct purposes:
|
|
75
75
|
|
|
76
76
|
- **Idea generation (early)** — when you want a wide spread of candidate framings unbiased by the conversation so far. Use *before* convergence to seed options. Most of fanout's value lives here, not at the end.
|
|
77
77
|
- **Convergence challenge (late)** — when a framing is solidifying and you want to stress-test it before it locks in.
|
|
@@ -225,12 +225,12 @@ Inspect `(choice, notes)` after each turn:
|
|
|
225
225
|
|
|
226
226
|
| Signal | Detection | Next action |
|
|
227
227
|
|---|---|---|
|
|
228
|
-
| Ready to draft | `notes` contains any of: `"ready to draft"`, `"looks good"`, `"write it up"`, `"good to go"`, `"let's draft"`, `"draft it"` (case-insensitive substring; multi-word phrases only) | Run `
|
|
229
|
-
| Stuck / different angle | `notes` contains any of: `"different angle"`, `"going nowhere"`, `"circles back"`, `"in circles"`, `"feels stuck"`, `"need a reframe"` (case-insensitive substring; multi-word phrases only) | Run `
|
|
228
|
+
| Ready to draft | `notes` contains any of: `"ready to draft"`, `"looks good"`, `"write it up"`, `"good to go"`, `"let's draft"`, `"draft it"` (case-insensitive substring; multi-word phrases only) | Run `crtr skill read sisyphus/problem-document` (`.content`), draft, run sign-off |
|
|
229
|
+
| Stuck / different angle | `notes` contains any of: `"different angle"`, `"going nowhere"`, `"circles back"`, `"in circles"`, `"feels stuck"`, `"need a reframe"` (case-insensitive substring; multi-word phrases only) | Run `crtr skill read sisyphus/problem-plateau-breakers` (`.content`) |
|
|
230
230
|
| Substantive response | `notes` non-empty AND adds new framing/info; OR `choice` engages a content option with implicit forward motion | Increment `N`, issue next turn deck — preferring root-drilling or candidate-generation over solution-discussion |
|
|
231
231
|
| Mid-turn knowledge gap | A turn surfaces a question you can't answer from what you've read | See "Mid-conversation exploration" below |
|
|
232
|
-
| Idea generation desired | Agent assessment: option space feels narrow, or framings are converging too early — want fresh framings unbiased by the conversation | (medium+ only) run `
|
|
233
|
-
| Convergence forming | Agent assessment: `N >= 4`, framing solidifying, want to stress-test before locking in | (medium+ only) run `
|
|
232
|
+
| Idea generation desired | Agent assessment: option space feels narrow, or framings are converging too early — want fresh framings unbiased by the conversation | (medium+ only) run `crtr skill read sisyphus/perspective-fanout` (`.content`) for early idea generation |
|
|
233
|
+
| Convergence forming | Agent assessment: `N >= 4`, framing solidifying, want to stress-test before locking in | (medium+ only) run `crtr skill read sisyphus/perspective-fanout` (`.content`) for convergence challenge |
|
|
234
234
|
| Drifting into HOW | Three or more consecutive turns spent on implementation/approach rather than problem definition | Self-correct: next turn returns to "what's the actual problem we're addressing, and is it the right one?" |
|
|
235
235
|
| Bifurcation recognized | The conversation has revealed independent sub-problems, not sub-parts of one problem | Use the bifurcation exit (see `<bifurcation>` below) |
|
|
236
236
|
|
|
@@ -258,7 +258,7 @@ This pattern is what keeps the conversation grounded as it deepens. Without it,
|
|
|
258
258
|
|
|
259
259
|
### 5. Drafting
|
|
260
260
|
|
|
261
|
-
When the routing matrix signals "ready to draft", run `
|
|
261
|
+
When the routing matrix signals "ready to draft", run `crtr skill read sisyphus/problem-document` (`.content`) for design principles and the anchor example. Write `$SISYPHUS_SESSION_DIR/context/problem.draft.md`, render it for review, and issue the sign-off deck.
|
|
262
262
|
|
|
263
263
|
```bash
|
|
264
264
|
printf '{"path":"%s"}' "$SISYPHUS_SESSION_DIR/context/problem.draft.md" | crtr human show >/dev/null
|
|
@@ -50,7 +50,7 @@ if [ "$RIB" = "1" ]; then
|
|
|
50
50
|
exit 0
|
|
51
51
|
fi
|
|
52
52
|
|
|
53
|
-
REASON=$'`sis ask <deck>` blocks until the user resolves the deck (potentially 10+ minutes). Re-issue this Bash tool call with `run_in_background: true` and end your turn — the bash completion notification will wake you with stdout ready to parse. Run `
|
|
53
|
+
REASON=$'`sis ask <deck>` blocks until the user resolves the deck (potentially 10+ minutes). Re-issue this Bash tool call with `run_in_background: true` and end your turn — the bash completion notification will wake you with stdout ready to parse. Run `crtr skill read sisyphus/humanloop` (`.content`) for the full pattern.'
|
|
54
54
|
|
|
55
55
|
ESCAPED=$(python3 -c "import json,sys; print(json.dumps(sys.stdin.read()))" <<< "$REASON")
|
|
56
56
|
echo "{\"decision\":\"block\",\"reason\":$ESCAPED}"
|
|
@@ -23,13 +23,13 @@ fi
|
|
|
23
23
|
if [ "$SCAFFOLDED" = "1" ]; then
|
|
24
24
|
cat <<'HINT'
|
|
25
25
|
<operator-memory-scaffolded>
|
|
26
|
-
Project-local operator memory was just scaffolded at .sisyphus/agent-plugin/skills/operator/ — read it now (it's a stub; you're the first operator in this project). Before submitting your final report, run `
|
|
26
|
+
Project-local operator memory was just scaffolded at .sisyphus/agent-plugin/skills/operator/ — read it now (it's a stub; you're the first operator in this project). Before submitting your final report, run `crtr skill read sisyphus/operator-memory` (`.content`) and update the memory with whatever future operators should not have to rediscover.
|
|
27
27
|
</operator-memory-scaffolded>
|
|
28
28
|
HINT
|
|
29
29
|
else
|
|
30
30
|
cat <<'HINT'
|
|
31
31
|
<operator-memory>
|
|
32
|
-
Project-local operator memory is at .sisyphus/agent-plugin/skills/operator/ — read it now to inherit what prior operators learned. Before submitting your final report, run `
|
|
32
|
+
Project-local operator memory is at .sisyphus/agent-plugin/skills/operator/ — read it now to inherit what prior operators learned. Before submitting your final report, run `crtr skill read sisyphus/operator-memory` (`.content`) and update the memory with anything new you discovered.
|
|
33
33
|
</operator-memory>
|
|
34
34
|
HINT
|
|
35
35
|
fi
|
|
@@ -35,4 +35,4 @@ One line per file in this directory. Add an entry here when you create a new ref
|
|
|
35
35
|
|
|
36
36
|
---
|
|
37
37
|
|
|
38
|
-
For guidance on what to capture, where to put it (SKILL.md vs new reference file), and naming conventions, run `
|
|
38
|
+
For guidance on what to capture, where to put it (SKILL.md vs new reference file), and naming conventions, run `crtr skill read sisyphus/operator-memory` (`.content`) before submitting.
|
|
@@ -103,7 +103,7 @@ goal.md is a plain statement of what "done" looks like — scope boundaries and
|
|
|
103
103
|
|
|
104
104
|
strategy.md defines **how to approach this problem** — the stages, gates, backtrack edges, and behavioral style for this session. It is generated during discovery and progressively updated as the goal crystallizes or shifts.
|
|
105
105
|
|
|
106
|
-
When writing or substantially revising strategy.md, run `
|
|
106
|
+
When writing or substantially revising strategy.md, run `crtr skill read sisyphus/orchestration` for stage patterns, process shapes, and format guidance (output JSON has `.content`). The `strategy.md` sibling file (get its directory with `crtr skill read sisyphus/orchestration --no-body`, output JSON has `.path`) holds the stage patterns, process shapes, and strategy.md format reference.
|
|
107
107
|
|
|
108
108
|
strategy.md tells you:
|
|
109
109
|
- What stages exist and their process flows (detailed for current, sketched for future)
|
|
@@ -79,7 +79,7 @@ If a single deck round surfaces multiple moderate items, capture them all in `$n
|
|
|
79
79
|
These change the goal itself:
|
|
80
80
|
|
|
81
81
|
1. Update goal.md with the revised scope (record the pivot, per goal.md conventions)
|
|
82
|
-
2. Run `
|
|
82
|
+
2. Run `crtr skill read sisyphus/orchestration` (output JSON has `.content`) and revise strategy.md with the new direction
|
|
83
83
|
3. Yield to discovery mode:
|
|
84
84
|
|
|
85
85
|
```bash
|
|
@@ -84,11 +84,11 @@ The default path is **spawn `sisyphus:problem`**. Override that default only whe
|
|
|
84
84
|
- The user gave acceptance criteria (or they're trivially derivable) AND
|
|
85
85
|
- You can complete this sentence without hand-waving: "Dialogue isn't needed because ___"
|
|
86
86
|
|
|
87
|
-
When all three hold, write `goal.md` and run the **clarity-confirmation deck** (below). On approval, run `
|
|
87
|
+
When all three hold, write `goal.md` and run the **clarity-confirmation deck** (below). On approval, run `crtr skill read sisyphus/orchestration` (output JSON has `.content`), write `strategy.md`, initialize `roadmap.md`, transition to planning.
|
|
88
88
|
|
|
89
89
|
**Default — spawn problem** for anything else: vague prompts ("improve X", "fix the auth"), prompts that name a direction without a destination, prompts where multiple valid framings exist, or any case where you can't complete the override sentence above.
|
|
90
90
|
|
|
91
|
-
For broad scope, spawn explore agents in parallel first to feed problem with grounded context. Yield `--mode discovery` while problem runs. When problem submits with `context/problem.md`, read it and proceed to write `goal.md`, run `
|
|
91
|
+
For broad scope, spawn explore agents in parallel first to feed problem with grounded context. Yield `--mode discovery` while problem runs. When problem submits with `context/problem.md`, read it and proceed to write `goal.md`, run `crtr skill read sisyphus/orchestration` (output JSON has `.content`), and transition to planning.
|
|
92
92
|
|
|
93
93
|
When problem submits with `context/problem-bifurcation.md` instead, follow the `<bifurcation-reentry>` flow above — re-enter discovery on the chosen sub-problem.
|
|
94
94
|
|
|
@@ -120,7 +120,7 @@ sis ask deck submit "$confirm_deck"
|
|
|
120
120
|
```
|
|
121
121
|
|
|
122
122
|
**Branching:**
|
|
123
|
-
- `proceed` → run `
|
|
123
|
+
- `proceed` → run `crtr skill read sisyphus/orchestration` (output JSON has `.content`), write `strategy.md`, initialize `roadmap.md`, transition to planning
|
|
124
124
|
- `minor-clarify` → update `goal.md` per `notes`, re-issue this deck
|
|
125
125
|
- `explore-deeper` → spawn `sisyphus:problem`, yield `--mode discovery`
|
|
126
126
|
|
|
@@ -142,7 +142,7 @@ Pick the tier by **novelty of behavior**, not file count:
|
|
|
142
142
|
|
|
143
143
|
Apply the tier with `sis session config effort <low|medium|high|xhigh>` — this filters mode templates and agent prompts on subsequent cycles so you only see the guidance that applies. The user can override at any point.
|
|
144
144
|
|
|
145
|
-
If you change the tier mid-session because scope shifted, the next cycle's prompts adjust automatically; don't manually patch `strategy.md` to match — for strategy guidance run `
|
|
145
|
+
If you change the tier mid-session because scope shifted, the next cycle's prompts adjust automatically; don't manually patch `strategy.md` to match — for strategy guidance run `crtr skill read sisyphus/orchestration` (output JSON has `.content`).
|
|
146
146
|
|
|
147
147
|
</effort-tier>
|
|
148
148
|
|
|
@@ -150,7 +150,7 @@ If you change the tier mid-session because scope shifted, the next cycle's promp
|
|
|
150
150
|
|
|
151
151
|
## Write the strategy
|
|
152
152
|
|
|
153
|
-
Once the goal is clear and the tier is set, run `
|
|
153
|
+
Once the goal is clear and the tier is set, run `crtr skill read sisyphus/orchestration` for guidance on writing `strategy.md` (output JSON has `.content`). The skill provides stage patterns, the tier-specific default pipeline shape, and the strategy.md format.
|
|
154
154
|
|
|
155
155
|
Strategy generation is usually fast — the shape of the work is often obvious once the goal and tier are settled. Don't overthink it. A wrong strategy gets revised; a missing strategy leaves the orchestrator directionless.
|
|
156
156
|
|
|
@@ -11,7 +11,7 @@ The user wants to redirect this session's strategy.
|
|
|
11
11
|
## Steps
|
|
12
12
|
|
|
13
13
|
1. If the session is completed (`sis session inspect status`), reactivate it with `sis session lifecycle continue`.
|
|
14
|
-
2. Run `
|
|
14
|
+
2. Run `crtr skill read sisyphus/orchestration` (`.content` field), then annotate `strategy.md` with the pivot — what changed, new focus, which existing artifacts still apply. Don't rewrite the whole strategy.
|
|
15
15
|
3. Yield to discovery mode:
|
|
16
16
|
```bash
|
|
17
17
|
sis orch yield --mode discovery --prompt "<concise description of the new direction>"
|
package/package.json
CHANGED
|
@@ -38,7 +38,7 @@ Don't guess the target. The product might be a browser page, an Electron app, or
|
|
|
38
38
|
|
|
39
39
|
You have a memory file at `.sisyphus/agent-plugin/skills/operator/SKILL.md`, plus per-task-family reference files alongside it. **Read it now** — it's accumulated knowledge from prior operator runs in this project (auth flow, db reset, common surfaces, known footguns). It scaffolds itself on first use; if it looks like a stub, you're the first.
|
|
40
40
|
|
|
41
|
-
**Before submitting your final report**, run `
|
|
41
|
+
**Before submitting your final report**, run `crtr skill read sisyphus/operator-memory` (`.content`) — it covers when and how to update the memory so the next operator starts ahead of where you started. For generic skill-authoring conventions (frontmatter, length, structure), defer to `crtr skill read claude-authoring/skills` (`.content`).
|
|
42
42
|
|
|
43
43
|
## Unblock Yourself
|
|
44
44
|
|
|
@@ -71,7 +71,7 @@ Naturally shift lenses as you explore. Weave them into conversation rather than
|
|
|
71
71
|
- **Precedent** — Has this kind of problem been faced before? In this codebase, in open source, in a different domain entirely?
|
|
72
72
|
|
|
73
73
|
Cycle through these as the conversation unfolds. Each lens reveals something different.
|
|
74
|
-
t MEDIUM+ effort, lenses can also be spawned as parallel sub-agents — run `
|
|
74
|
+
t MEDIUM+ effort, lenses can also be spawned as parallel sub-agents — run `crtr skill read sisyphus/perspective-fanout` (`.content`) for two distinct purposes:
|
|
75
75
|
|
|
76
76
|
- **Idea generation (early)** — when you want a wide spread of candidate framings unbiased by the conversation so far. Use *before* convergence to seed options. Most of fanout's value lives here, not at the end.
|
|
77
77
|
- **Convergence challenge (late)** — when a framing is solidifying and you want to stress-test it before it locks in.
|
|
@@ -225,12 +225,12 @@ Inspect `(choice, notes)` after each turn:
|
|
|
225
225
|
|
|
226
226
|
| Signal | Detection | Next action |
|
|
227
227
|
|---|---|---|
|
|
228
|
-
| Ready to draft | `notes` contains any of: `"ready to draft"`, `"looks good"`, `"write it up"`, `"good to go"`, `"let's draft"`, `"draft it"` (case-insensitive substring; multi-word phrases only) | Run `
|
|
229
|
-
| Stuck / different angle | `notes` contains any of: `"different angle"`, `"going nowhere"`, `"circles back"`, `"in circles"`, `"feels stuck"`, `"need a reframe"` (case-insensitive substring; multi-word phrases only) | Run `
|
|
228
|
+
| Ready to draft | `notes` contains any of: `"ready to draft"`, `"looks good"`, `"write it up"`, `"good to go"`, `"let's draft"`, `"draft it"` (case-insensitive substring; multi-word phrases only) | Run `crtr skill read sisyphus/problem-document` (`.content`), draft, run sign-off |
|
|
229
|
+
| Stuck / different angle | `notes` contains any of: `"different angle"`, `"going nowhere"`, `"circles back"`, `"in circles"`, `"feels stuck"`, `"need a reframe"` (case-insensitive substring; multi-word phrases only) | Run `crtr skill read sisyphus/problem-plateau-breakers` (`.content`) |
|
|
230
230
|
| Substantive response | `notes` non-empty AND adds new framing/info; OR `choice` engages a content option with implicit forward motion | Increment `N`, issue next turn deck — preferring root-drilling or candidate-generation over solution-discussion |
|
|
231
231
|
| Mid-turn knowledge gap | A turn surfaces a question you can't answer from what you've read | See "Mid-conversation exploration" below |
|
|
232
|
-
| Idea generation desired | Agent assessment: option space feels narrow, or framings are converging too early — want fresh framings unbiased by the conversation | (medium+ only) run `
|
|
233
|
-
| Convergence forming | Agent assessment: `N >= 4`, framing solidifying, want to stress-test before locking in | (medium+ only) run `
|
|
232
|
+
| Idea generation desired | Agent assessment: option space feels narrow, or framings are converging too early — want fresh framings unbiased by the conversation | (medium+ only) run `crtr skill read sisyphus/perspective-fanout` (`.content`) for early idea generation |
|
|
233
|
+
| Convergence forming | Agent assessment: `N >= 4`, framing solidifying, want to stress-test before locking in | (medium+ only) run `crtr skill read sisyphus/perspective-fanout` (`.content`) for convergence challenge |
|
|
234
234
|
| Drifting into HOW | Three or more consecutive turns spent on implementation/approach rather than problem definition | Self-correct: next turn returns to "what's the actual problem we're addressing, and is it the right one?" |
|
|
235
235
|
| Bifurcation recognized | The conversation has revealed independent sub-problems, not sub-parts of one problem | Use the bifurcation exit (see `<bifurcation>` below) |
|
|
236
236
|
|
|
@@ -258,7 +258,7 @@ This pattern is what keeps the conversation grounded as it deepens. Without it,
|
|
|
258
258
|
|
|
259
259
|
### 5. Drafting
|
|
260
260
|
|
|
261
|
-
When the routing matrix signals "ready to draft", run `
|
|
261
|
+
When the routing matrix signals "ready to draft", run `crtr skill read sisyphus/problem-document` (`.content`) for design principles and the anchor example. Write `$SISYPHUS_SESSION_DIR/context/problem.draft.md`, render it for review, and issue the sign-off deck.
|
|
262
262
|
|
|
263
263
|
```bash
|
|
264
264
|
printf '{"path":"%s"}' "$SISYPHUS_SESSION_DIR/context/problem.draft.md" | crtr human show >/dev/null
|
|
@@ -50,7 +50,7 @@ if [ "$RIB" = "1" ]; then
|
|
|
50
50
|
exit 0
|
|
51
51
|
fi
|
|
52
52
|
|
|
53
|
-
REASON=$'`sis ask <deck>` blocks until the user resolves the deck (potentially 10+ minutes). Re-issue this Bash tool call with `run_in_background: true` and end your turn — the bash completion notification will wake you with stdout ready to parse. Run `
|
|
53
|
+
REASON=$'`sis ask <deck>` blocks until the user resolves the deck (potentially 10+ minutes). Re-issue this Bash tool call with `run_in_background: true` and end your turn — the bash completion notification will wake you with stdout ready to parse. Run `crtr skill read sisyphus/humanloop` (`.content`) for the full pattern.'
|
|
54
54
|
|
|
55
55
|
ESCAPED=$(python3 -c "import json,sys; print(json.dumps(sys.stdin.read()))" <<< "$REASON")
|
|
56
56
|
echo "{\"decision\":\"block\",\"reason\":$ESCAPED}"
|
|
@@ -23,13 +23,13 @@ fi
|
|
|
23
23
|
if [ "$SCAFFOLDED" = "1" ]; then
|
|
24
24
|
cat <<'HINT'
|
|
25
25
|
<operator-memory-scaffolded>
|
|
26
|
-
Project-local operator memory was just scaffolded at .sisyphus/agent-plugin/skills/operator/ — read it now (it's a stub; you're the first operator in this project). Before submitting your final report, run `
|
|
26
|
+
Project-local operator memory was just scaffolded at .sisyphus/agent-plugin/skills/operator/ — read it now (it's a stub; you're the first operator in this project). Before submitting your final report, run `crtr skill read sisyphus/operator-memory` (`.content`) and update the memory with whatever future operators should not have to rediscover.
|
|
27
27
|
</operator-memory-scaffolded>
|
|
28
28
|
HINT
|
|
29
29
|
else
|
|
30
30
|
cat <<'HINT'
|
|
31
31
|
<operator-memory>
|
|
32
|
-
Project-local operator memory is at .sisyphus/agent-plugin/skills/operator/ — read it now to inherit what prior operators learned. Before submitting your final report, run `
|
|
32
|
+
Project-local operator memory is at .sisyphus/agent-plugin/skills/operator/ — read it now to inherit what prior operators learned. Before submitting your final report, run `crtr skill read sisyphus/operator-memory` (`.content`) and update the memory with anything new you discovered.
|
|
33
33
|
</operator-memory>
|
|
34
34
|
HINT
|
|
35
35
|
fi
|
|
@@ -35,4 +35,4 @@ One line per file in this directory. Add an entry here when you create a new ref
|
|
|
35
35
|
|
|
36
36
|
---
|
|
37
37
|
|
|
38
|
-
For guidance on what to capture, where to put it (SKILL.md vs new reference file), and naming conventions, run `
|
|
38
|
+
For guidance on what to capture, where to put it (SKILL.md vs new reference file), and naming conventions, run `crtr skill read sisyphus/operator-memory` (`.content`) before submitting.
|
|
@@ -103,7 +103,7 @@ goal.md is a plain statement of what "done" looks like — scope boundaries and
|
|
|
103
103
|
|
|
104
104
|
strategy.md defines **how to approach this problem** — the stages, gates, backtrack edges, and behavioral style for this session. It is generated during discovery and progressively updated as the goal crystallizes or shifts.
|
|
105
105
|
|
|
106
|
-
When writing or substantially revising strategy.md, run `
|
|
106
|
+
When writing or substantially revising strategy.md, run `crtr skill read sisyphus/orchestration` for stage patterns, process shapes, and format guidance (output JSON has `.content`). The `strategy.md` sibling file (get its directory with `crtr skill read sisyphus/orchestration --no-body`, output JSON has `.path`) holds the stage patterns, process shapes, and strategy.md format reference.
|
|
107
107
|
|
|
108
108
|
strategy.md tells you:
|
|
109
109
|
- What stages exist and their process flows (detailed for current, sketched for future)
|
|
@@ -79,7 +79,7 @@ If a single deck round surfaces multiple moderate items, capture them all in `$n
|
|
|
79
79
|
These change the goal itself:
|
|
80
80
|
|
|
81
81
|
1. Update goal.md with the revised scope (record the pivot, per goal.md conventions)
|
|
82
|
-
2. Run `
|
|
82
|
+
2. Run `crtr skill read sisyphus/orchestration` (output JSON has `.content`) and revise strategy.md with the new direction
|
|
83
83
|
3. Yield to discovery mode:
|
|
84
84
|
|
|
85
85
|
```bash
|
|
@@ -84,11 +84,11 @@ The default path is **spawn `sisyphus:problem`**. Override that default only whe
|
|
|
84
84
|
- The user gave acceptance criteria (or they're trivially derivable) AND
|
|
85
85
|
- You can complete this sentence without hand-waving: "Dialogue isn't needed because ___"
|
|
86
86
|
|
|
87
|
-
When all three hold, write `goal.md` and run the **clarity-confirmation deck** (below). On approval, run `
|
|
87
|
+
When all three hold, write `goal.md` and run the **clarity-confirmation deck** (below). On approval, run `crtr skill read sisyphus/orchestration` (output JSON has `.content`), write `strategy.md`, initialize `roadmap.md`, transition to planning.
|
|
88
88
|
|
|
89
89
|
**Default — spawn problem** for anything else: vague prompts ("improve X", "fix the auth"), prompts that name a direction without a destination, prompts where multiple valid framings exist, or any case where you can't complete the override sentence above.
|
|
90
90
|
|
|
91
|
-
For broad scope, spawn explore agents in parallel first to feed problem with grounded context. Yield `--mode discovery` while problem runs. When problem submits with `context/problem.md`, read it and proceed to write `goal.md`, run `
|
|
91
|
+
For broad scope, spawn explore agents in parallel first to feed problem with grounded context. Yield `--mode discovery` while problem runs. When problem submits with `context/problem.md`, read it and proceed to write `goal.md`, run `crtr skill read sisyphus/orchestration` (output JSON has `.content`), and transition to planning.
|
|
92
92
|
|
|
93
93
|
When problem submits with `context/problem-bifurcation.md` instead, follow the `<bifurcation-reentry>` flow above — re-enter discovery on the chosen sub-problem.
|
|
94
94
|
|
|
@@ -120,7 +120,7 @@ sis ask deck submit "$confirm_deck"
|
|
|
120
120
|
```
|
|
121
121
|
|
|
122
122
|
**Branching:**
|
|
123
|
-
- `proceed` → run `
|
|
123
|
+
- `proceed` → run `crtr skill read sisyphus/orchestration` (output JSON has `.content`), write `strategy.md`, initialize `roadmap.md`, transition to planning
|
|
124
124
|
- `minor-clarify` → update `goal.md` per `notes`, re-issue this deck
|
|
125
125
|
- `explore-deeper` → spawn `sisyphus:problem`, yield `--mode discovery`
|
|
126
126
|
|
|
@@ -142,7 +142,7 @@ Pick the tier by **novelty of behavior**, not file count:
|
|
|
142
142
|
|
|
143
143
|
Apply the tier with `sis session config effort <low|medium|high|xhigh>` — this filters mode templates and agent prompts on subsequent cycles so you only see the guidance that applies. The user can override at any point.
|
|
144
144
|
|
|
145
|
-
If you change the tier mid-session because scope shifted, the next cycle's prompts adjust automatically; don't manually patch `strategy.md` to match — for strategy guidance run `
|
|
145
|
+
If you change the tier mid-session because scope shifted, the next cycle's prompts adjust automatically; don't manually patch `strategy.md` to match — for strategy guidance run `crtr skill read sisyphus/orchestration` (output JSON has `.content`).
|
|
146
146
|
|
|
147
147
|
</effort-tier>
|
|
148
148
|
|
|
@@ -150,7 +150,7 @@ If you change the tier mid-session because scope shifted, the next cycle's promp
|
|
|
150
150
|
|
|
151
151
|
## Write the strategy
|
|
152
152
|
|
|
153
|
-
Once the goal is clear and the tier is set, run `
|
|
153
|
+
Once the goal is clear and the tier is set, run `crtr skill read sisyphus/orchestration` for guidance on writing `strategy.md` (output JSON has `.content`). The skill provides stage patterns, the tier-specific default pipeline shape, and the strategy.md format.
|
|
154
154
|
|
|
155
155
|
Strategy generation is usually fast — the shape of the work is often obvious once the goal and tier are settled. Don't overthink it. A wrong strategy gets revised; a missing strategy leaves the orchestrator directionless.
|
|
156
156
|
|
|
@@ -11,7 +11,7 @@ The user wants to redirect this session's strategy.
|
|
|
11
11
|
## Steps
|
|
12
12
|
|
|
13
13
|
1. If the session is completed (`sis session inspect status`), reactivate it with `sis session lifecycle continue`.
|
|
14
|
-
2. Run `
|
|
14
|
+
2. Run `crtr skill read sisyphus/orchestration` (`.content` field), then annotate `strategy.md` with the pivot — what changed, new focus, which existing artifacts still apply. Don't rewrite the whole strategy.
|
|
15
15
|
3. Yield to discovery mode:
|
|
16
16
|
```bash
|
|
17
17
|
sis orch yield --mode discovery --prompt "<concise description of the new direction>"
|