Skip to content

kaddo init

Terminal window
kaddo init

Creates the architecture/ knowledge tree and .kaddo/config.yml.

architecture/
knowledge.md ← current state of the product
roadmap.md ← intentions and priorities
work-items/ ← one file per work item
.kaddo/
config.yml ← project config

Project context

kaddo init asks three questions and records the answers in .kaddo/config.yml. Other commands read this file to adapt their guidance — Kaddo becomes state-aware.

version: 1
project:
name: "my-app"
state: pre-ai # new | pre-ai | legacy
structure: monorepo # monorepo | multirepo
domains: []
team:
size: indie # indie | small | medium | enterprise

Project state — drives next-step guidance in scan and create:

StateMeaning
newGreenfield project; start defining knowledge from scratch.
pre-aiExisting system without an AI/knowledge baseline yet.
legacyOlder system where risks and unknowns matter most.

Team sizeindie, small, medium, enterprise.

Repository structuremonorepo or multirepo.

Old config files keep working: missing fields fall back to safe defaults (state: pre-ai, structure: monorepo, team.size: indie). Invalid enum values produce a clear validation error listing the valid options.