clawker: Skill for Claude Code

wizard-commands

Package contracts: internal/prompter/AGENTS.md, internal/tui/AGENTS.md.

Comprehensive reference for the two prompting layers in clawker: line-based prompter (Scenario 2) and BubbleTea wizard (Scenario 4).

1. Overview & Decision Tree

Clawker has two distinct prompting mechanisms, each living in its own package with separate import boundaries:

Layer	Package	Technology	Scenario
Prompter	internal/prompter	Line-based stdin/stderr	Scenario 2 (static-interactive)
Wizard	internal/tui	BubbleTea alt screen	Scenario 4 (live-interactive)

Decision Tree

Need user input?
  │
  ├── Single y/n confirmation? ──────── f.Prompter().Confirm()
  ├── Single text input? ────────────── f.Prompter().String()
  ├── Single list selection? ────────── f.Prompter().Select()
  ├── Multi-step form with navigation? ─ f.TUI.RunWizard(fields)
  ├── Multi-step form + progress? ───── wizard → f.TUI.RunProgress (init pattern)
  └── No input needed? ─────────────── Direct execution; --yes flag to skip

Key rule: Single prompt → prompter; multi-step form with back-navigation → wizard.

2. Prompter Package (internal/prompter/)

Construction & Factory Wiring

type Prompter struct { ios *iostreams.IOStreams }
func NewPrompter(ios *iostreams.IOStreams) *Prompter

Access via Factory: f.Prompter() (lazy accessor, returns *prompter.Prompter).

Three Methods

String — text input with default/validation:

func (p *Prompter) String(cfg PromptConfig) (string, error)

type PromptConfig struct {
    Message   string
    Default   string
    Required  bool
    Validator func(string) error
}

Confirm — y/n toggle:

func (p *Prompter) Confirm(message string, defaultYes bool) (bool, error)

Select — numbered list, returns 0-based index:

func (p *Prompter) Select(message string, options []SelectOption, defaultIdx int) (int, error)

type SelectOption struct {
    Label       string
    Description string
}