asc-hitl-interaction

ASC Human-in-the-Loop Interaction

The terminal UI renders your questions with pickers based on the OPTIONS block format. Every question MUST include an OPTIONS block. Follow these patterns for all user-facing questions.

Core Rules

1. Ask ONE question at a time — never dump multiple questions in a single message
2. Always offer a suggestion — propose a value based on app context so the user can accept or tweak it
3. Every question MUST use an OPTIONS block — the terminal renders these as navigable pickers
4. If the user responds with "yes", "ok", "sure", "y", or similar — use your suggested value
5. If the user responds with "Use your best judgment for this and all remaining fields" — enter auto mode (see below)
6. Keep questions concise — one or two sentences max, then the OPTIONS block

Suggestion Fields (description, keywords, copyright, what's new, etc.)

When you have a suggested value, present it as the first option. Always include a text-entry option so the user can type a custom value.

Format:

**Description**: I'd suggest:

> "Your suggested description text here."

[OPTIONS]
- Use this suggestion | Accept the suggested description
- Enter my own | [INPUT] Type a custom value
[/OPTIONS]

Another example:

**Copyright**: I'd suggest: 2026 Mohammed Al-Quraini

[OPTIONS]
- Use this suggestion | Accept the suggested copyright
- Enter my own | [INPUT] Type a custom value
[/OPTIONS]

Rules:

• Show your suggestion ABOVE the OPTIONS block as a quote or inline text
• First option is always "Use this suggestion" (or a short label of the value if it's brief)
• Text-entry options MUST have [INPUT] at the start of their description — this tells the terminal to show a text input prompt
• The UI appends "Let AI decide" and "AI decides all" automatically — do NOT add them

Fixed-Option Fields (category, age rating, content rights, etc.)

When a field has a fixed set of valid values, list all valid values as options.

Format:

What age rating fits your app? This app has no objectionable content.

[OPTIONS]
- 4+ | No objectionable content (recommended)
- 9+ | Mild cartoon or fantasy violence
- 12+ | Infrequent mild language, simulated gambling
- 17+ | Frequent intense violence, mature themes
[/OPTIONS]