Skip to content

Commit 5da2d2a

Browse files
Clarify exact Jacobian contract inspection (#786)
* Clarify exact contract inspection * Clarify exact contract inspection * Clarify exact contract inspection
1 parent 0cbf3e3 commit 5da2d2a

3 files changed

Lines changed: 10 additions & 4 deletions

File tree

.agents/skills/jacobian-math/SKILL.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -40,8 +40,10 @@ stable built-in contracts; replace examples but preserve JSON types:
4040
4141
For other outcomes or unfamiliar payloads, use `math.find` with a specific
4242
plain-language outcome and implied domain or mode; no capability ID is required.
43-
Use low `limit` values. Inspect `CONTRACT` only when the typed schema is needed.
44-
A card's `invocation_example`, or required top-level fields, may be enough.
43+
Use low `limit` values. For a selected operation's schema, call
44+
`math.find({"capability_id":"<exact-id>","view":"CONTRACT"})`; never send
45+
`mode: "CONTRACT"` to `math.run` or put `CONTRACT` in a query. A card's
46+
`invocation_example`, or required top-level fields, may be enough.
4547
4648
Do not add a discovery domain filter unless its exact installed spelling is
4749
known. When discovery exposes recovery paths, follow those fields (for example,

npm/skills/jacobian-math/SKILL.md

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -40,8 +40,10 @@ stable built-in contracts; replace examples but preserve JSON types:
4040
4141
For other outcomes or unfamiliar payloads, use `math.find` with a specific
4242
plain-language outcome and implied domain or mode; no capability ID is required.
43-
Use low `limit` values. Inspect `CONTRACT` only when the typed schema is needed.
44-
A card's `invocation_example`, or required top-level fields, may be enough.
43+
Use low `limit` values. For a selected operation's schema, call
44+
`math.find({"capability_id":"<exact-id>","view":"CONTRACT"})`; never send
45+
`mode: "CONTRACT"` to `math.run` or put `CONTRACT` in a query. A card's
46+
`invocation_example`, or required top-level fields, may be enough.
4547
4648
Do not add a discovery domain filter unless its exact installed spelling is
4749
known. When discovery exposes recovery paths, follow those fields (for example,

tests/unit/tooling/test_codex_visibility.py

Lines changed: 2 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -194,6 +194,8 @@ def test_codex_skill_routes_exact_outcomes_without_catalog_projection() -> None:
194194
skill_flat = re.sub(r"\s+", " ", skill)
195195
assert "Do not enumerate, filter, or print `ALL_TOOLS`" in skill_flat
196196
assert "text(r.structuredContent ?? r)" in skill
197+
assert 'math.find({"capability_id":"<exact-id>","view":"CONTRACT"})' in skill
198+
assert 'never send `mode: "CONTRACT"` to `math.run`' in skill_flat
197199
assert "never reconstruct or paraphrase such a record" in skill_flat
198200
assert "required task authorization and bindings are preserved" in skill_flat
199201
for guidance in (

0 commit comments

Comments
 (0)