add lil peek to in/output

docs/wf_mcp_end_to_end_runbook.md

@@ -162,6 +162,9 @@ arguments:
 }
 ```
 
+The list response is intentionally compact. It includes `source_id`, outcomes,
+and top-level `input_fields` / `output_fields`, but not full JSON schemas.
+
 Then inspect its full contract:
 
 ```yaml

docs/wf_mcp_operator_manual.md

@@ -174,6 +174,11 @@ only when you need its full owned-capability list. The compact response includes
 counts plus small preview lists and `has_more` flags, so clients can usually
 choose the next source to inspect without loading every schema.
 
+Use `wf.workflow.list_capabilities` after that when you need workflow-ready
+nodes rather than source ownership. Its rows include `source_id`, outcomes, and
+top-level input/output field names, while full JSON schemas stay behind
+`wf.workflow.inspect_capability`.
+
 ### 4. Manage Saved Workflows
 
 Use `wf.workflow.*` for artifacts and deployments:

docs/workflow_capabilities.md

@@ -262,6 +262,8 @@ authoring loop:
 - `wf.workflow.list_capabilities`
   - lists compact paged enabled planner-visible workflow-ready node spec
     summaries, with optional query/source filtering
+  - includes the owning `source_id`, outcomes, and top-level input/output field
+    names, but not full schemas
 - `wf.workflow.inspect_capability`
   - returns one full workflow capability contract with schemas and outcomes
 - `wf.workflow.call_capability`
@@ -271,6 +273,15 @@ These are authoring-plane tools. They do not replace the privileged
 `wf.admin.list_sources` source inventory, and older planner-catalog projections
 may remain while callers migrate to the workflow-facing surface.
 
+Recommended discovery order:
+
+1. Use `wf.admin.list_sources` to find capability owners and preview source
+   contents.
+2. Use `wf.workflow.list_capabilities` with `source_id` or `query` to find
+   workflow-ready node specs.
+3. Use `wf.workflow.inspect_capability` only for the selected capability's full
+   schema contract.
+
 ## Relationship To Capability Sources
 
 Sources own capability kinds: