Builder Guidance v2
Builder Guidance is the authoritative authoring procedure exposed by Builder MCP. It describes to an external agent how to discover contracts, author valid Runtime YAML, Debug safely, and persist revisions without overwriting concurrent changes.
Load once
Prefer the MCP Resource:
flowgear://builder/guidance
Load it once before the first Builder Tool call. If a client cannot read MCP Resources and the guidance is not already in context, call GetBuilderGuidance once as the fallback. Note that this is normally handled automatically by your agent.
Authority order
Use this order when sources disagree:
- The schema and description returned by the current Tool.
- Current Node, Method, template, mapping-function, and inferred-schema discovery results.
- Builder Guidance.
- Examples and remembered patterns.
Never preserve an example's Node version, Property, identifier, or schema field when current discovery returns a different contract.
Required working loop
The guidance requires the agent to confirm context, discover exact contracts, create the smallest runnable slice, persist a blank identity for a new Workflow, Debug with its key, repair the latest gating failure, and save the tested YAML with the latest FileHash.
It also requires explicit handling of side effects, exact DSL casing, consuming-Property mappings, matched HTTP/MCP response Steps, and protected Connection values.