Get Started

Get your first aDNA project running in about 5 minutes.

1. Clone the template

git clone https://github.com/LatticeProtocol/Agentic-DNA.git my-project
cd my-project

This gives you the base .adna/ template with governance files, skills, and context structure.

2. Open in your editor

Open the project in Obsidian, VS Code, or any Markdown editor. The CLAUDE.md file at the root is your starting point — it tells AI agents how to navigate the project.

3. Run your first session

Start a session with Claude Code (or your preferred AI agent). The agent will read CLAUDE.md, detect a fresh project, and walk you through onboarding.

$ claude

╭─────────────────────────────────────╮
│ Claude Code                         │
╰─────────────────────────────────────╯

✓  Loaded CLAUDE.md (project instructions)

I can see this is a fresh aDNA project — your governance files
are in place and the triad structure (who/ what/ how/) is ready.

This looks like an uncustomized fork. I'll walk you through
onboarding: let's set your project identity, confirm the triad
structure, and create your first session file.

What is this project called, and what problem does it solve?

> _

The agent reads your CLAUDE.md before asking a single question. You start every session with a collaborator that already knows the project — not one you have to brief from scratch.

See it live

The aDNA.aDNA/ repository is a working aDNA project — open it alongside this tutorial to see every concept in action:

  • aDNA.aDNA/CLAUDE.md — the root governance file your agent reads first
  • aDNA.aDNA/STATE.md — live operational snapshot: current phase, blockers, next steps
  • aDNA.aDNA/how/sessions/active/ — active session files, one per working session

Next steps