domain-knowledge-kit 0.1.0 → 0.2.8

package/README.md

@@ -1,265 +1,147 @@
 # Domain Knowledge Kit
 
-A structured, YAML-based domain model with Architecture Decision Records (ADRs), full-text search, and generated Markdown documentation.
+Define, validate, search, and document your domain model — all from YAML.
 
-Domain Knowledge Kit lets you define bounded contexts, events, commands, policies, aggregates, read models, and glossary terms in YAML — then validate, render, and search them from the CLI.
+## What Is This?
+
+Domain Knowledge Kit (DKK) is a CLI tool for teams practicing Domain-Driven Design. Instead of scattering domain knowledge across wikis, diagrams, and tribal memory, you define your **bounded contexts**, **events**, **commands**, **policies**, **aggregates**, **read models**, and **glossary** in structured YAML files. DKK then:
+
+- **Validates** schema conformance and referential integrity across your entire model
+- **Generates** browsable Markdown documentation from your YAML definitions
+- **Builds** a full-text search index (SQLite FTS5) for instant domain queries
+- **Links** Architecture Decision Records (ADRs) bidirectionally to domain items
+- **Integrates** with AI coding agents so they understand your domain, not just your code
 
 ## Quick Start
 
 ```bash
-# Install globally from npm
+# Install
 npm install -g domain-knowledge-kit
 
-# Or run without installing
-npx dkk --help
-
-# Validate the domain model
+# Create a bounded context (per-item directory format)
+mkdir -p .dkk/domain/contexts/ordering/{events,commands,aggregates}
+
+# Context metadata
+cat > .dkk/domain/contexts/ordering/context.yml << 'EOF'
+name: ordering
+description: Handles customer order lifecycle.
+EOF
+
+# One file per domain item
+cat > .dkk/domain/contexts/ordering/events/OrderPlaced.yml << 'EOF'
+name: OrderPlaced
+description: Raised when a customer order is confirmed.
+raised_by: Order
+EOF
+
+cat > .dkk/domain/contexts/ordering/commands/PlaceOrder.yml << 'EOF'
+name: PlaceOrder
+description: Submit a new customer order.
+handled_by: Order
+EOF
+
+cat > .dkk/domain/contexts/ordering/aggregates/Order.yml << 'EOF'
+name: Order
+description: Manages order state and invariants.
+handles:
+  commands:
+    - PlaceOrder
+emits:
+  events:
+    - OrderPlaced
+EOF
+
+# Register it in .dkk/domain/index.yml
+# Add "- name: ordering" to the contexts array
+
+# Validate and render
 dkk validate
-
-# Render generated documentation
 dkk render
 
-# Search domain items
+# Explore
 dkk search "order"
+dkk show ordering.OrderPlaced
+dkk related ordering.Order
 ```
 
-### Contributing / local development
+→ **[Full Getting Started Guide](docs/getting-started.md)** — step-by-step walkthrough with examples.
 
-```bash
-npm install
+## Documentation
 
-# Run directly via tsx (no build step needed)
-npm run dev -- validate
-npm run dev -- render
+| Guide | What You'll Learn |
+|-------|-------------------|
+| **[Getting Started](docs/getting-started.md)** | Install, create your first context, run quality gates, search and explore |
+| **[Domain Modeling](docs/domain-modeling.md)** | All item types, YAML structure, cross-references, naming conventions, ID formats |
+| **[CLI Reference](docs/cli-reference.md)** | Every command and flag: `list`, `show`, `search`, `related`, `validate`, `render`, `init`, `prime`, `adr show`, `adr related` |
+| **[ADR Guide](docs/adr-guide.md)** | Architecture Decision Records: format, bidirectional linking, querying, best practices |
+| **[AI Agent Integration](docs/ai-agent-integration.md)** | `dkk init`, `dkk prime`, Copilot integration, reusable prompts, portable skills |
 
-# Or build first and use the compiled binary
-npm run build
-npx dkk validate
-```
-
-## Directory Layout
+## Key Commands
 
+```bash
+dkk validate              # Schema + cross-reference validation
+dkk render                # Validate → render docs → rebuild search index
+dkk search "payment"      # Full-text search with ranking
+dkk show ordering.Order   # Display full item definition
+dkk related ordering.Order  # Graph traversal of connected items
+dkk list --type event     # List all events across contexts
+dkk init                  # Set up AI agent onboarding
+dkk prime                 # Output agent context to stdout
 ```
-domain/
-  index.yml              # Registered contexts + cross-context flows
-  actors.yml             # Global actors (human | system | external)
-  contexts/
-    <name>.yml           # Bounded context definition
-
-docs/
-  adr/                   # Architecture Decision Records (Markdown + YAML frontmatter)
-  domain/                # Generated documentation (do not edit by hand)
-
-src/
-  cli.ts                 # Slim CLI entry point (registers commands)
-  features/              # Vertical feature slices
-    query/               # List, show, search, related commands
-      commands/          #   CLI command handlers
-      searcher.ts        #   FTS5 search logic
-      tests/             #   Co-located unit tests
-    adr/                 # ADR show & related commands
-      commands/          #   CLI command handlers
-    pipeline/            # Validate, render, index pipeline
-      commands/          #   CLI command handlers
-      validator.ts       #   Schema + cross-ref validation
-      renderer.ts        #   Handlebars doc generation
-      indexer.ts          #   Search index builder
-      tests/             #   Co-located unit tests
-  shared/                # Cross-cutting infrastructure
-    types/               #   DomainModel, SearchIndexRecord, etc.
-    loader.ts            #   YAML model loading
-    graph.ts             #   BFS graph traversal
-    item-visitor.ts      #   Generic item iteration utility
-    adr-parser.ts        #   ADR frontmatter parsing
-    paths.ts             #   Path resolution helpers
-    errors.ts            #   Error formatting
-    yaml.ts              #   YAML I/O helpers
-    tests/               #   Co-located unit tests
-
-tools/
-  domain-pack/
-    schema/              # JSON Schemas for domain YAML validation
-    templates/           # Handlebars templates for doc generation
-
-test/
-  cli-integration.ts     # End-to-end CLI integration tests
-
-.github/
-  copilot-instructions.md  # Copilot integration instructions
-```
-
-### Architecture: Vertical Feature Slices
-
-The source code is organized into **vertical feature slices** rather than horizontal layers. Each feature slice (`query`, `adr`, `pipeline`) owns its commands, core logic, and tests. The `shared/` module contains cross-cutting infrastructure used by all slices (loader, graph traversal, type definitions, etc.).
-
-This structure ensures that adding a new domain item type or feature requires changes localized to one slice, reducing coupling and making the codebase easier to navigate.
-
-## Adding a Bounded Context
-
-1. Create a new file `domain/contexts/<name>.yml`:
-
-   ```yaml
-   name: <name>
-   description: A short description of this bounded context.
-   events: []
-   commands: []
-   policies: []
-   aggregates: []
-   read_models: []
-   glossary: []
-   ```
-
-2. Register it in `domain/index.yml`:
-
-   ```yaml
-   contexts:
-     - name: <name>
-   ```
-
-3. Run quality gates:
-
-   ```bash
-   dkk validate
-   dkk render
-   ```
-
-## Adding an ADR and Linking It
-
-1. Create a Markdown file in `docs/adr/` following the naming convention `adr-NNNN.md` (e.g. `adr-0002.md`):
-
-   ```markdown
-   ---
-   id: adr-NNNN
-   title: Short Title
-   status: proposed
-   date: YYYY-MM-DD
-   domain_refs:
-     - <context>.<ItemName>
-   ---
-
-   ## Context
-   ...
-
-   ## Decision
-   ...
-
-   ## Consequences
-   ...
-   ```
-
-2. Link back from domain items by adding the ADR id to their `adr_refs`:
 
-   ```yaml
-   # In domain/contexts/<name>.yml, on the relevant item:
-   adr_refs:
-     - adr-NNNN
-   ```
+→ **[Full CLI Reference](docs/cli-reference.md)**
 
-3. Run quality gates:
+## AI Agent Integration
 
-   ```bash
-   dkk validate
-   dkk render
-   ```
+DKK has first-class support for AI coding agents. Two commands get you set up:
 
-## CLI Command Reference
-
-All commands below use `dkk` (the installed CLI). During local development, substitute `npm run dev --` or `npx tsx src/cli.ts` for `dkk`.
-
-### `list`
-
-List all domain items.
-
-| Flag | Default | Description |
-|------|---------|-------------|
-| `-c, --context <name>` | — | Filter by bounded context |
-| `-t, --type <type>` | — | Filter by item type (`event`, `command`, `policy`, `aggregate`, `read_model`, `glossary`, `actor`, `adr`, `flow`, `context`) |
-| `--json` | — | Output as JSON |
-| `-r, --root <path>` | repo root | Override repository root |
-
-### `show <id>`
-
-Display the full YAML of a single domain item.
-
-| Flag | Default | Description |
-|------|---------|-------------|
-| `--json` | — | Output as JSON |
-| `-r, --root <path>` | repo root | Override repository root |
-
-### `search <query>`
-
-FTS5 full-text search with ranking. Requires a pre-built index — run `render` first.
-
-| Flag | Default | Description |
-|------|---------|-------------|
-| `-c, --context <name>` | — | Filter results to a bounded context |
-| `-t, --type <type>` | — | Filter by item type |
-| `--tag <tag>` | — | Filter by tag/keyword |
-| `--limit <n>` | `20` | Maximum number of results |
-| `--expand` | — | Expand top results with graph neighbours |
-| `--json` | — | Output as JSON |
-| `-r, --root <path>` | repo root | Override repository root |
-
-### `related <id>`
-
-BFS graph traversal of related items.
-
-| Flag | Default | Description |
-|------|---------|-------------|
-| `-d, --depth <n>` | `1` | Maximum BFS traversal depth |
-| `--json` | — | Output as JSON |
-| `-r, --root <path>` | repo root | Override repository root |
-
-### `validate`
-
-Schema + cross-reference validation.
-
-| Flag | Default | Description |
-|------|---------|-------------|
-| `--warn-missing-fields` | — | Warn about events/commands with no `fields` defined |
-| `--json` | — | Output as JSON |
-| `-r, --root <path>` | repo root | Override repository root |
-
-### `render`
-
-Validate → render Handlebars Markdown docs → rebuild FTS5 SQLite search index.
-
-| Flag | Default | Description |
-|------|---------|-------------|
-| `--skip-validation` | — | Skip the schema + cross-ref validation step |
-| `--json` | — | Output as JSON |
-| `-r, --root <path>` | repo root | Override repository root |
-
-### `adr show <id>`
+```bash
+dkk init    # Add a DKK section to AGENTS.md (idempotent)
+dkk prime   # Output full domain context for AI consumption
+```
 
-Display ADR frontmatter as YAML.
+Agents can then search, show, and traverse your domain model — making domain-aware decisions when writing, reviewing, or refactoring code. DKK also ships with GitHub Copilot instructions, reusable agent prompts, and a portable agent skill.
 
-| Flag | Default | Description |
-|------|---------|-------------|
-| `--json` | — | Output as JSON |
-| `-r, --root <path>` | repo root | Override repository root |
+→ **[AI Agent Integration Guide](docs/ai-agent-integration.md)**
 
-### `adr related <id>`
+## Directory Layout
 
-Show bidirectional ADR ↔ domain links. Given an ADR id, lists domain items that reference it; given a domain item id, lists ADRs that reference it.
+```
+.dkk/                           # Domain model + generated + managed
+  domain/                         #   Domain model (YAML)
+    index.yml                     #     Contexts + flows
+    actors.yml                    #     Global actors
+    contexts/                     #     Bounded contexts (one dir each)
+      <name>/                     #       Context directory
+        context.yml               #         Context metadata + glossary
+        events/                   #         One .yml file per event
+        commands/                 #         One .yml file per command
+        aggregates/               #         One .yml file per aggregate
+        policies/                 #         One .yml file per policy
+        read-models/              #         One .yml file per read model
+  adr/                            #   Architecture Decision Records
+  docs/                           #   Generated docs (do not edit)
+src/                            # Source code (vertical slices)
+tools/dkk/                      # Schemas + templates
+  schema/                       #   JSON Schemas for validation
+  templates/                    #   Handlebars templates for rendering
+```
 
-| Flag | Default | Description |
-|------|---------|-------------|
-| `-r, --root <path>` | repo root | Override repository root |
+## Contributing / Local Development
 
-## ID Conventions
+```bash
+npm install
 
-| Item Type    | Format                     | Example                  |
-|--------------|----------------------------|--------------------------|
-| Context item | `<context>.<ItemName>`     | `ordering.OrderPlaced`   |
-| Actor        | `actor.<Name>`             | `actor.Customer`         |
-| ADR          | `adr-NNNN`                 | `adr-0001`               |
-| Flow         | `flow.<Name>`              | `flow.OrderFulfillment`  |
-| Context      | `context.<name>`           | `context.ordering`       |
+# Run directly via tsx (no build step needed)
+npm run dev -- validate
+npm run dev -- render
 
-## Copilot Integration
+# Or build first
+npm run build
+npx dkk validate
+```
 
-[.github/copilot-instructions.md](.github/copilot-instructions.md) configures GitHub Copilot to understand the domain model structure and use domain-first retrieval (search → show → related → adr related).
+The source code uses **vertical feature slices** — each feature (`query`, `adr`, `pipeline`, `agent`) owns its commands, logic, and tests. Cross-cutting infrastructure lives in `shared/`.
 
 ## License
 

package/dist/cli.js

@@ -8,6 +8,12 @@ import { registerValidate } from "./features/pipeline/commands/validate.js";
 import { registerRender } from "./features/pipeline/commands/render.js";
 import { registerAdrShow } from "./features/adr/commands/adr-show.js";
 import { registerAdrRelated } from "./features/adr/commands/adr-related.js";
+import { registerInit } from "./features/agent/commands/init.js";
+import { registerPrime } from "./features/agent/commands/prime.js";
+import { registerNewDomain } from "./features/scaffold/commands/new-domain.js";
+import { registerNewContext } from "./features/scaffold/commands/new-context.js";
+import { registerNewAdr } from "./features/scaffold/commands/new-adr.js";
+import { registerAddItem } from "./features/scaffold/commands/add-item.js";
 import { formatCliError } from "./shared/errors.js";
 /** Whether to show full stack traces (set DEBUG=1 in env). */
 const DEBUG = Boolean(process.env.DEBUG);
@@ -24,12 +30,23 @@ registerSearch(program);
 registerRelated(program);
 registerValidate(program);
 registerRender(program);
+registerInit(program);
+registerPrime(program);
 // ADR sub-command group
 const adrCmd = program
     .command("adr")
     .description("ADR-related commands");
 registerAdrShow(adrCmd);
 registerAdrRelated(adrCmd);
+// "new" sub-command group
+const newCmd = program
+    .command("new")
+    .description("Scaffold new domain structures");
+registerNewDomain(newCmd);
+registerNewContext(newCmd);
+registerNewAdr(newCmd);
+// Top-level "add" command for individual domain items
+registerAddItem(program);
 program.parseAsync().catch((err) => {
     console.error(`Error: ${formatCliError(err)}`);
     if (DEBUG && err instanceof Error && err.stack) {

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,8DAA8D;AAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAEzC,yEAAyE;AAEzE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CAAC,2BAA2B,CAAC;KACxC,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,qBAAqB;AACrB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAC1B,cAAc,CAAC,OAAO,CAAC,CAAC;AAExB,wBAAwB;AACxB,MAAM,MAAM,GAAG,OAAO;KACnB,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,sBAAsB,CAAC,CAAC;AAEvC,eAAe,CAAC,MAAM,CAAC,CAAC;AACxB,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAE3B,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC1C,OAAO,CAAC,KAAK,CAAC,UAAU,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/C,IAAI,KAAK,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAC/C,OAAO,CAAC,KAAK,CAAC,mBAAmB,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACpC,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,cAAc,EAAE,MAAM,qCAAqC,CAAC;AACrE,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,0CAA0C,CAAC;AAC5E,OAAO,EAAE,cAAc,EAAE,MAAM,wCAAwC,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,MAAM,qCAAqC,CAAC;AACtE,OAAO,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAC5E,OAAO,EAAE,YAAY,EAAE,MAAM,mCAAmC,CAAC;AACjE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,4CAA4C,CAAC;AAC/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,6CAA6C,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,yCAAyC,CAAC;AACzE,OAAO,EAAE,eAAe,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAEpD,8DAA8D;AAC9D,MAAM,KAAK,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;AAEzC,yEAAyE;AAEzE,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,KAAK,CAAC;KACX,WAAW,CAAC,2BAA2B,CAAC;KACxC,OAAO,CAAC,OAAO,CAAC,CAAC;AAEpB,qBAAqB;AACrB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,eAAe,CAAC,OAAO,CAAC,CAAC;AACzB,gBAAgB,CAAC,OAAO,CAAC,CAAC;AAC1B,cAAc,CAAC,OAAO,CAAC,CAAC;AACxB,YAAY,CAAC,OAAO,CAAC,CAAC;AACtB,aAAa,CAAC,OAAO,CAAC,CAAC;AAEvB,wBAAwB;AACxB,MAAM,MAAM,GAAG,OAAO;KACnB,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,sBAAsB,CAAC,CAAC;AAEvC,eAAe,CAAC,MAAM,CAAC,CAAC;AACxB,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAE3B,0BAA0B;AAC1B,MAAM,MAAM,GAAG,OAAO;KACnB,OAAO,CAAC,KAAK,CAAC;KACd,WAAW,CAAC,gCAAgC,CAAC,CAAC;AAEjD,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAC1B,kBAAkB,CAAC,MAAM,CAAC,CAAC;AAC3B,cAAc,CAAC,MAAM,CAAC,CAAC;AAEvB,sDAAsD;AACtD,eAAe,CAAC,OAAO,CAAC,CAAC;AAEzB,OAAO,CAAC,UAAU,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC1C,OAAO,CAAC,KAAK,CAAC,UAAU,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC/C,IAAI,KAAK,IAAI,GAAG,YAAY,KAAK,IAAI,GAAG,CAAC,KAAK,EAAE,CAAC;QAC/C,OAAO,CAAC,KAAK,CAAC,mBAAmB,GAAG,CAAC,KAAK,EAAE,CAAC,CAAC;IAChD,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/features/agent/commands/init.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `dkk init` command — create or update AGENTS.md with a DKK section.
+ *
+ * Inserts a Domain Knowledge Kit section delimited by HTML comment markers.
+ * Idempotent: replaces the section between markers on re-run, appends if
+ * markers are absent, creates the file if it does not exist.
+ */
+import type { Command as Cmd } from "commander";
+/** Register the `init` subcommand. */
+export declare function registerInit(program: Cmd): void;
+//# sourceMappingURL=init.d.ts.map

package/dist/features/agent/commands/init.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.d.ts","sourceRoot":"","sources":["../../../../src/features/agent/commands/init.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AA8ChD,sCAAsC;AACtC,wBAAgB,YAAY,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAmC/C"}

package/dist/features/agent/commands/init.js

@@ -0,0 +1,77 @@
+import { readFileSync, writeFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { repoRoot } from "../../../shared/paths.js";
+const START_MARKER = "<!-- dkk:start -->";
+const END_MARKER = "<!-- dkk:end -->";
+/** The DKK section content (without markers). */
+function dkkSection() {
+    return `
+## Domain Knowledge Kit
+
+This project uses a structured, YAML-based domain model managed by **dkk** (Domain Knowledge Kit).
+
+Run \`dkk prime\` to get full agent context including domain structure, CLI commands, and workflows.
+
+### Quick Reference
+
+\`\`\`bash
+dkk prime             # Output full agent context
+dkk list              # List all domain items
+dkk show <id>         # Display a domain item
+dkk search "<query>"  # Full-text search
+dkk related <id>      # Graph traversal of related items
+dkk validate          # Schema + cross-reference validation
+dkk render            # Validate, render docs, rebuild search index
+\`\`\`
+
+### Quality Gates
+
+Before committing domain changes, run:
+
+\`\`\`bash
+dkk render              # Validates → renders docs → rebuilds search index
+\`\`\`
+
+\`dkk validate\` is available as a quick dry-run check (no rendering).
+`.trimStart();
+}
+/** Build the full delimited block. */
+function delimitedSection() {
+    return `${START_MARKER}\n${dkkSection()}${END_MARKER}\n`;
+}
+/** Register the `init` subcommand. */
+export function registerInit(program) {
+    program
+        .command("init")
+        .description("Create or update AGENTS.md with DKK onboarding section")
+        .option("-r, --root <path>", "Override repository root")
+        .action((opts) => {
+        const root = repoRoot(opts.root);
+        const agentsPath = join(root, "AGENTS.md");
+        const section = delimitedSection();
+        if (!existsSync(agentsPath)) {
+            // Create new file with the DKK section
+            writeFileSync(agentsPath, `# Agent Instructions\n\n${section}`, "utf-8");
+            console.log(`Created ${agentsPath}`);
+            return;
+        }
+        const existing = readFileSync(agentsPath, "utf-8");
+        const startIdx = existing.indexOf(START_MARKER);
+        const endIdx = existing.indexOf(END_MARKER);
+        if (startIdx !== -1 && endIdx !== -1 && endIdx > startIdx) {
+            // Replace existing section between markers (include trailing newline if present)
+            const markerEnd = endIdx + END_MARKER.length;
+            const before = existing.slice(0, startIdx);
+            const after = existing.slice(existing[markerEnd] === "\n" ? markerEnd + 1 : markerEnd);
+            writeFileSync(agentsPath, `${before}${section}${after}`, "utf-8");
+            console.log(`Updated DKK section in ${agentsPath}`);
+        }
+        else {
+            // Append section at the end
+            const separator = existing.endsWith("\n") ? "\n" : "\n\n";
+            writeFileSync(agentsPath, `${existing}${separator}${section}`, "utf-8");
+            console.log(`Appended DKK section to ${agentsPath}`);
+        }
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/features/agent/commands/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../../../../src/features/agent/commands/init.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAClE,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AACjC,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEpD,MAAM,YAAY,GAAG,oBAAoB,CAAC;AAC1C,MAAM,UAAU,GAAG,kBAAkB,CAAC;AAEtC,iDAAiD;AACjD,SAAS,UAAU;IACjB,OAAO;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4BR,CAAC,SAAS,EAAE,CAAC;AACd,CAAC;AAED,sCAAsC;AACtC,SAAS,gBAAgB;IACvB,OAAO,GAAG,YAAY,KAAK,UAAU,EAAE,GAAG,UAAU,IAAI,CAAC;AAC3D,CAAC;AAED,sCAAsC;AACtC,MAAM,UAAU,YAAY,CAAC,OAAY;IACvC,OAAO;SACJ,OAAO,CAAC,MAAM,CAAC;SACf,WAAW,CAAC,wDAAwD,CAAC;SACrE,MAAM,CAAC,mBAAmB,EAAE,0BAA0B,CAAC;SACvD,MAAM,CAAC,CAAC,IAAuB,EAAE,EAAE;QAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACjC,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;QAC3C,MAAM,OAAO,GAAG,gBAAgB,EAAE,CAAC;QAEnC,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC5B,uCAAuC;YACvC,aAAa,CAAC,UAAU,EAAE,2BAA2B,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;YACzE,OAAO,CAAC,GAAG,CAAC,WAAW,UAAU,EAAE,CAAC,CAAC;YACrC,OAAO;QACT,CAAC;QAED,MAAM,QAAQ,GAAG,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC;QACnD,MAAM,QAAQ,GAAG,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QAChD,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;QAE5C,IAAI,QAAQ,KAAK,CAAC,CAAC,IAAI,MAAM,KAAK,CAAC,CAAC,IAAI,MAAM,GAAG,QAAQ,EAAE,CAAC;YAC1D,iFAAiF;YACjF,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,CAAC,MAAM,CAAC;YAC7C,MAAM,MAAM,GAAG,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;YAC3C,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;YACvF,aAAa,CAAC,UAAU,EAAE,GAAG,MAAM,GAAG,OAAO,GAAG,KAAK,EAAE,EAAE,OAAO,CAAC,CAAC;YAClE,OAAO,CAAC,GAAG,CAAC,0BAA0B,UAAU,EAAE,CAAC,CAAC;QACtD,CAAC;aAAM,CAAC;YACN,4BAA4B;YAC5B,MAAM,SAAS,GAAG,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC;YAC1D,aAAa,CAAC,UAAU,EAAE,GAAG,QAAQ,GAAG,SAAS,GAAG,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;YACxE,OAAO,CAAC,GAAG,CAAC,2BAA2B,UAAU,EAAE,CAAC,CAAC;QACvD,CAAC;IACH,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/features/agent/commands/prime.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `dkk prime` command — output full agent context to stdout.
+ *
+ * Prints a comprehensive DKK usage guide for AI agent consumption,
+ * followed by a dynamic "Current Domain Summary" section generated
+ * from the live domain model on disk.
+ *
+ * Hardcoded template covering project overview, core principles,
+ * domain structure, retrieval workflow, change workflow, ID conventions,
+ * CLI reference, and file conventions.
+ */
+import type { Command as Cmd } from "commander";
+/** Register the `prime` subcommand. */
+export declare function registerPrime(program: Cmd): void;
+//# sourceMappingURL=prime.d.ts.map

package/dist/features/agent/commands/prime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prime.d.ts","sourceRoot":"","sources":["../../../../src/features/agent/commands/prime.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,EAAE,OAAO,IAAI,GAAG,EAAE,MAAM,WAAW,CAAC;AA8ahD,uCAAuC;AACvC,wBAAgB,aAAa,CAAC,OAAO,EAAE,GAAG,GAAG,IAAI,CAYhD"}