Summary
netscript ui:add page/island --query scaffolds the exact page + island + query-loader triad that
both wave-four agents assembled by hand. Neither ran it. ui:add data-table would have given
one of them the settled-incidents table it hand-wrote.
Run 1 lists it under "what I should have used and did not":
"netscript ui:add page/island --query scaffolds the page + island + query-loader triad I
assembled by hand, and ui:add data-table would have given the settled list a real table."
The problem
The command exists, is documented, and is invisible at the moment of need. An agent about to write a
data screen has no prompt to consider it — it is not surfaced by the scaffold, not named in the
generated app, and not reachable from the point where the decision is made.
This is the CLI mirror of the docs-sequencing problem: capability present, activation absent.
Proposal
- Name
ui:add in the generated app-scoped conventions file (see the app-scoped AGENTS.md issue),
at the point where "do not hand-write Button/Input/Card equivalents" is stated.
- Consider a hint from adjacent commands: after
netscript service generate, or on first run of a
route-creating command, mention the ui:add triad once.
- Ensure
ui:add --help states what the triad is — page, island, query loader — rather than
listing flags, so an agent that runs --help once learns the shape.
Acceptance
Notes
Wave-four run-1 self-review (https://github.com/rickylabs/vigil/blob/main/self-review.md).
Summary
netscript ui:add page/island --queryscaffolds the exact page + island + query-loader triad thatboth wave-four agents assembled by hand. Neither ran it.
ui:add data-tablewould have givenone of them the settled-incidents table it hand-wrote.
Run 1 lists it under "what I should have used and did not":
The problem
The command exists, is documented, and is invisible at the moment of need. An agent about to write a
data screen has no prompt to consider it — it is not surfaced by the scaffold, not named in the
generated app, and not reachable from the point where the decision is made.
This is the CLI mirror of the docs-sequencing problem: capability present, activation absent.
Proposal
ui:addin the generated app-scoped conventions file (see the app-scopedAGENTS.mdissue),at the point where "do not hand-write Button/Input/Card equivalents" is stated.
netscript service generate, or on first run of aroute-creating command, mention the
ui:addtriad once.ui:add --helpstates what the triad is — page, island, query loader — rather thanlisting flags, so an agent that runs
--helponce learns the shape.Acceptance
ui:addis named in generated app conventions where hand-rolling is discouragedui:add --helpdescribes the generated triad and when to use itA follow-up agent run building a data screen either runs— relocated to verify(wave-five): does the shipped agent surface actually change agent behaviour? #1090 (0.0.5). This is an observation of a future agent run andui:addor records why it did notcannot be satisfied by the PR that builds the capability. Implementation landed in feat(cli,mcp): scaffold agent surface — app-scoped conventions and an evidence-gated diagnostic surface #1078.
Notes
Wave-four run-1 self-review (https://github.com/rickylabs/vigil/blob/main/self-review.md).