Skip to content

cli: ui:add solves the exact problem agents hand-roll around, and is invisible at the moment of need #1073

Description

@rickylabs

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).

Metadata

Metadata

Assignees

No one assigned

    Projects

    No projects

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions