New project

Bootstrap a greenfield project end-to-end — from empty directory to first committed feature. The full vikit engineering loop for when you are starting from scratch.

Overview

**Goal**: a new project with a reviewed, tested first feature on git.
**Time**: 1–2 hours (vs. a full day manual).
**Skills used**: brainstorm, specify, plan, implement, test, code-review, git.

Prerequisites

vikit-cli installed and authenticated (GitHub PAT with repo scope).
An empty directory (or a freshly git init-ed one).

Step 1: Explore the design space

Brainstorm the approach and lock the trade-offs before any code.

/vk:eng:brainstorm "<project goal>"

Step 2: Turn the design into a spec

Transform the brainstorm output into formal FR/SC/NF requirements.

/vk:eng:specify --from "<brainstorm-report>"

Step 3: Plan the implementation

Generate a phased plan with TODO tasks in ./plans.

/vk:eng:plan --spec specs/<module>/spec.md

Step 4: Clear context, then implement

Clear between planning and implementation so the plan is loaded fresh (each skill works from a clean context window).

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

Step 5: Test, review, and ship

Run the suite, adversarially review, then commit.

/vk:eng:test
/vk:eng:code-review
/vk:eng:git cp

Next steps

Add a feature — The loop for every feature after the first.
Documentation — Seed the ./docs folder for the new project.