Skip to content

feat(onboarding): interactive AI-skills-first setup flow #397

@christso

Description

@christso

Objective

Design and implement an AI-skills-first interactive onboarding flow for AgentV, replacing current manual agentv init usage with guided setup in agent clients.

Why

Current onboarding still relies on a CLI command path and static instructions. We want a first-class interactive flow that runs through agent clients (Claude/Copilot/allagents-compatible surfaces), validates environment state, and guides users through setup decisions.

Scope

  • Add an interactive TUI-style onboarding experience (or equivalent guided interactive flow) for AgentV setup.
  • Integrate with plugin-manager-first install path:
    • npx allagents plugin marketplace add EntityProcess/agentv
    • npx allagents plugin install agentv-dev@agentv
  • Ensure onboarding can:
    • detect/install AgentV CLI when missing
    • initialize bootstrap files (.env.example, .agentv/config.yaml, .agentv/targets.yaml)
    • verify setup and report next steps
  • Align docs with the new interactive flow once implemented.

Acceptance Signals

  • New users can complete setup from an interactive agent-driven onboarding path without needing to know agentv init first.
  • Onboarding handles missing CLI and verification failures with actionable remediation.
  • Flow is compatible with allagents/Claude/Copilot command surfaces.
  • Documentation reflects the interactive onboarding as canonical.

Non-Goals

  • Evaluator/runtime behavior changes in packages/core.
  • New evaluator primitives.

Related

Metadata

Metadata

Assignees

No one assigned

    Labels

    No labels
    No labels

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions