Skip to content

Commit 21fc1f0

Browse files
BrettNyeclaude
andcommitted
docs(known-issues): 19 — revise the relationship to 17 after 17a's correction
17a corrected 17's central premise while 19 was being written: the placeholder digest gates nothing, dev shapes dispatch today, and `contextShape` is free text no code reads. 19 referenced 17's framing, so the reference is now wrong even though the entry's own claim — the workspace is a tar with no `.git` — was verified independently and stands. The correction STRENGTHENS this entry. 17 asked for the last mile of something it believed nearly built; 17a establishes the staged context is unimplemented and asks for it to be specified. History is one of the dimensions that specification has to settle, alongside the three 17a already names: materialized tree, patch application order relative to overlayCapabilities, and toolchain presence. States which agent needs which, since they are independent: an implementer needs the tree; a verifier needs tree plus patch plus toolchain; a planner needs the commit graph and neither of the others. And answers the question 17a leaves open for this consumer — if the staged context is opt-in dimensions, history alone without a toolchain is what unblocks a dispatched planner. Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
1 parent f16b153 commit 21fc1f0

1 file changed

Lines changed: 23 additions & 7 deletions

File tree

deploy/serve-stack/KNOWN-ISSUES.md

Lines changed: 23 additions & 7 deletions
Original file line numberDiff line numberDiff line change
@@ -2274,13 +2274,29 @@ do if this is not wanted. It is worse in a specific way: the consumer then CHOOS
22742274
what history the agent sees, which biases the decision the agent is being asked to
22752275
make. A checkout lets the agent ask its own questions.
22762276
2277-
### Relationship to 17
2278-
2279-
Independent, and both are needed for different agents. 17 unblocks a verifier that
2280-
can run gates against the patch. This unblocks a planner that can see what came
2281-
before. Neither implies the other: a workspace with `node_modules` and no history
2282-
still cannot answer "what changed since last cycle", and a workspace with history
2283-
and no toolchain still cannot run a test.
2277+
### Relationship to 17, revised after 17a
2278+
2279+
17a corrected 17's central premise — the placeholder digest gates nothing, dev
2280+
shapes dispatch today, and `contextShape` is free text no code reads. This entry
2281+
was written before that correction landed and **is strengthened by it**, not
2282+
weakened.
2283+
2284+
17 asked for the last mile of something it believed was nearly built. 17a
2285+
establishes that the staged context is unimplemented and asks for it to be
2286+
specified. **History is one of the dimensions that specification has to settle**,
2287+
alongside the three 17a already names: materialized tree, patch application order
2288+
relative to `overlayCapabilities`, and toolchain presence.
2289+
2290+
The four are independent and serve different agents. A workspace with
2291+
`node_modules` and no history still cannot answer "what changed since last
2292+
cycle". A workspace with history and no toolchain still cannot run a test. An
2293+
implementer needs the tree; a verifier needs the tree plus the patch plus a
2294+
toolchain; a planner needs the commit graph and needs neither of the others.
2295+
2296+
If the staged context is specified as a single fixed shape, it should say which
2297+
of these it includes. If it is specified as opt-in dimensions, history should be
2298+
one of them — and this consumer would take history alone, without a toolchain,
2299+
as the thing that unblocks a dispatched planner.
22842300

22852301
## Related: CRLF on shell scripts
22862302

0 commit comments

Comments
 (0)