-
Notifications
You must be signed in to change notification settings - Fork 6
Open
Description
Summary
Redesign aegis init interactive mode to offer two paths:
- Quick setup ("Ron Swanson mode") - Current direct approach, cleaned up
- Guided wizard - Explanatory flow for newcomers
Problem
The current interactive flow jumps straight into asking questions without context. It assumes users already understand:
- What components vs services are
- What each option does
- How things combine together
This works for power users but creates friction for first-timers.
Proposed Solution
Opening Choice
How would you like to set up your project?
> Quick setup I know what I want
Guided tour Show me the options
Wizard Mode Features
Context panels - Rich terminal UI explaining each choice:
┌─────────────────────────────────────────────────┐
│ DATABASE │
│ │
│ PostgreSQL with SQLModel ORM, migrations via │
│ Alembic, and connection pooling. │
│ │
│ Pairs well with: Auth, AI, Scheduler │
└─────────────────────────────────────────────────┘
[ Add ] [ Skip ] [ Learn more ]
Combination hints - Surface the emergent power:
- "You picked AI - most users also add Database for conversation history"
- "Auth + Database enables user-specific data and sessions"
Progressive disclosure - Basics first, details on demand
Quick Setup Mode
- Clean up current flow
- Minimal prompts, fast path
- For repeat users or those who've read docs
Technical Considerations
- Could use Textual or rich panels for the UI
- Wizard explanations could pull from component/service metadata
- Consider showing a "build preview" as selections are made
Value
- Lower barrier to entry for new users
- Better showcases what Aegis can do
- Power users unaffected (quick path remains)
Reactions are currently unavailable
Metadata
Metadata
Assignees
Labels
No labels