Existing project

Add vikit to a codebase that already exists. Scout first so every plan and implementation respects the project's real structure and conventions.

Overview

**Goal**: vikit installed and its first change merged into an existing repo.
**Time**: 30–60 minutes.
**Skills used**: scout, plan, implement, test.

Prerequisites

The existing repo checked out locally.
vikit-cli installed and authenticated.
Read ./CLAUDE.md and ./README.md if present — vikit honors project rules.

Step 1: Scout the codebase

Map the architecture, conventions, and the files your change will touch. Scout runs parallel agents and reports back so planning is grounded in reality.

/vk:eng:scout "<area of the codebase>"

Step 2: Plan the change

Turn the goal into a phased plan that fits the existing structure.

/vk:eng:plan "<change description>"

Step 3: Clear context, then implement

Implement fresh against the plan, picking up the generated tasks.

/clear
/vk:eng:implement "from latest plan"

Step 4: Test

Run the existing suite plus any new tests the plan added.

/vk:eng:test

Next steps

Add a feature — Continue with a reviewed feature loop.
Refactor code — Safely restructure what you just touched.