Title: build-workflow: bind resources through the selector, not the manual twin by mzxchandra · Pull Request #4 · simstudioai/skills · GitHub
Open Graph Title: build-workflow: bind resources through the selector, not the manual twin by mzxchandra · Pull Request #4 · simstudioai/skills
X Title: build-workflow: bind resources through the selector, not the manual twin by mzxchandra · Pull Request #4 · simstudioai/skills
Description: What
Adds a ## Bind a resource through its selector field section to the build-workflow skill, plus two reference-safety notes in the naming section.
Why
Canonical selector/manual pairs (tableSelector/manualTableId, writeFolderPath/manualWriteFolderPath, workflowId/manualWorkflowId) are the most expensive thing to get wrong when authoring a graph from the CLI, and the skill said nothing about them.
The costly assumption is that the advanced "manual" member is the one that takes a dynamic value. It is not. On the File block's write operation, the writeFolderPath selector resolves a folder path - percent-encoded form included - while manualWriteFolderPath fails for every value. Testing only the manual member, because "advanced" reads like "the dynamic one", cost most of a session before the selector was tried.
Three behaviours around the pair are documented alongside it. Each was measured against live workspaces while building Sim-native products (ask-rvt across ten workspaces, BlueOps, RVT-finops), and each is already carried in those repos' CLAUDE.md files - this PR moves them to where the agent will actually read them.
Mode follows the key, not the value. handleEditOperation calls updateCanonicalModesForInputs with the edit's input keys, so naming a member sets the group's mode to that member's side; when one edit names both, advanced wins. The practical consequence is sharp: {"manualTableId": null} on a selector-bound block reads like clearing inert residue and actually flips the block to advanced with an empty id. Ten table blocks were broken this way in one edit, and the next run failed on a missing required field. The safe remediation is two ops in sequence, which the section spells out.
A manual id survives a copy verbatim. A copied workspace remaps a bound selector but carries a manual id across unchanged, silently repointing the copy at the source workspace's table or workflow. Measured across sandbox/uat/prod on one desk: every broken block in the promoted environments was advanced-mode, and every advanced-mode block was broken.
An edit merges inputs. Fields an edit does not name keep their previous values, so a block configured over several edits can still carry a stale value on the member that is no longer active.
The two naming notes come from the same sessions: a block renamed to getP&L left
Open Graph Description: What Adds a ## Bind a resource through its selector field section to the build-workflow skill, plus two reference-safety notes in the naming section. Why Canonical selector/manual pairs (tableSelec...
X Description: What Adds a ## Bind a resource through its selector field section to the build-workflow skill, plus two reference-safety notes in the naming section. Why Canonical selector/manual pairs (tableSelec...
Opengraph URL: https://github.com/simstudioai/skills/pull/4
X: @github
Domain: github.com
| react-profiling | 0 |
| react-import-map | react,react-dom,react-dom/client,react-dom/profiling,react-is,react-reconciler,react/compiler-runtime,react/jsx-dev-runtime,react/jsx-runtime,scheduler@d5750093facf |
| route-pattern | /:user_id/:repository/pull/:id/files(.:format) |
| route-controller | pull_requests |
| route-action | files |
| fetch-nonce | v2:3d2f57fc-51d2-933b-440a-e064928d9483 |
| current-catalog-service-hash | ae870bc5e265a340912cde392f23dad3671a0a881730ffdadd82f2f57d81641b |
| request-id | D4F2:11E6AB:3B369E:540314:6AFB58F2 |
| html-safe-nonce | 7a5c159ed8e4922b68ed70b698c9a0ecf4d8bfc53d7f7c59eb34e34237ba238c |
| visitor-payload | eyJyZWZlcnJlciI6IiIsInJlcXVlc3RfaWQiOiJENEYyOjExRTZBQjozQjM2OUU6NTQwMzE0OjZBRkI1OEYyIiwidmlzaXRvcl9pZCI6IjU5NDAzNTAzNDQyNDAzOTY2NiIsInJlZ2lvbl9lZGdlIjoiaWFkIiwicmVnaW9uX3JlbmRlciI6ImlhZCJ9 |
| visitor-hmac | fb12a1fc8f630ae7b7ee5d3f4e5583dc45dd3fc5e5e3bf23c8e6b7f3cd5fa662 |
| hovercard-subject-tag | pull_request:4447839975 |
| github-keyboard-shortcuts | repository,pull-request-list,pull-request-conversation,pull-request-files-changed,copilot |
| google-site-verification | Apib7-x98H0j5cPqHWwSMm6dNU4GmODRoqxLiDzdx9I |
| octolytics-url | https://collector.github.com/github/collect |
| analytics-location | / |
| fb:app_id | 1401488693436528 |
| apple-itunes-app | app-id=1477376905, app-argument=https://github.com/simstudioai/skills/pull/4/files |
| twitter:image | https://avatars.githubusercontent.com/u/129460234?s=400&v=4 |
| twitter:card | summary_large_image |
| og:image | https://avatars.githubusercontent.com/u/129460234?s=400&v=4 |
| og:image:alt | What Adds a ## Bind a resource through its selector field section to the build-workflow skill, plus two reference-safety notes in the naming section. Why Canonical selector/manual pairs (tableSelec... |
| og:site_name | GitHub |
| og:type | object |
| hostname | github.com |
| expected-hostname | github.com |
| None | ea33d13c96d0ff66bd8fa906b193d2213536b78cb06b0c50a4632c58b1418f94 |
| turbo-cache-control | no-preview |
| diff-view | unified |
| go-import | github.com/simstudioai/skills git https://github.com/simstudioai/skills.git |
| octolytics-dimension-user_id | 199344406 |
| octolytics-dimension-user_login | simstudioai |
| octolytics-dimension-repository_id | 1348964237 |
| octolytics-dimension-repository_nwo | simstudioai/skills |
| octolytics-dimension-repository_public | true |
| octolytics-dimension-repository_is_fork | false |
| octolytics-dimension-repository_network_root_id | 1348964237 |
| octolytics-dimension-repository_network_root_nwo | simstudioai/skills |
| turbo-body-classes | logged-out env-production page-responsive |
| disable-turbo | true |
| browser-stats-url | https://api.github.com/_private/browser/stats |
| browser-errors-url | https://api.github.com/_private/browser/errors |
| release | 59ef97164c52cf59bd10558ddec9c4f482763988 |
| ui-target | full |
| theme-color | #1e2327 |
| color-scheme | light dark |
Links:
Viewport: width=device-width