show-me

Show Me

Explain $ARGUMENTS visually. Pick the smallest view that makes the point, and keep the prose around it short.

Arguments

With no argument, show the current topic of conversation.

Formats

Pick one format or several, rarely all.

Types and Signatures

The shape of code before an implementation exists, showing the interface and the seam:

interface Skill {
  name: string
  body: string
}

interface SkillSource {
  read(name: string): Promise<Skill>
}

function expand(command: string, source: SkillSource): Promise<string>

Pseudocode

Logic or an algorithm:

on(save)
  if content is unchanged
    return cached result
  write new content
  return fresh result

Call Tree

Runtime control flow inside one process:

submitForm
  createSession
    persistPrompt
    launchAgent
  navigateToSession

Component Tree

UI structure:

<SessionPage> (apps/example/src/routes/session.tsx)
  useSessionEvents()
  <SessionToolbar> (packages/ui)
  <SessionTimeline>

File Tree

File responsibility or the shape of a refactor:

src/
├── commands/       # parses user actions
├── sessions/       # owns session state
└── transport.ts    # sends API requests

Diff

A change against a shape that already exists:

Component tree:

 <SessionPage>
   useSessionEvents()
   <SessionToolbar>
+    <RunSkillButton />
   <SessionTimeline>
+    <SkillResultCard />

File tree:

 src/
 ├── commands/
+│   └── show-me.ts       # expands the slash command
 ├── sessions/
-└── transport.ts
+└── transport/
+    ├── client.ts
+    └── stream.ts

Call tree:

 submitForm
   createSession
     persistPrompt
+    expandSkillMention
     launchAgent
   navigateToSession
+    subscribeToEvents

State and control flow:

 on(save)
-  write content
-  return result
+  if content is unchanged
+    return cached result
+  write new content
+  return fresh result