> ## Documentation Index
> Fetch the complete documentation index at: https://docs.kombify.io/llms.txt
> Use this file to discover all available pages before exploring further.

# stackkit resolve

> Resolve Architecture v2 intent into a canonical deployment plan

Resolve Architecture v2 intent into a canonical deployment plan.

Resolve a StackSpec v2 document and optional observed Inventory into the canonical ResolvedPlan consumed by generators and runtimes.

The command is read-only unless `--output` is supplied. File output stays beneath the working directory and can replace only an existing valid ResolvedPlan; it shares the lifecycle mutation lock. StackSpec v1 is never silently upgraded or compiled: it returns the shared typed migration report and requires an explicit migration workflow.

```bash theme={null}
stackkit resolve [spec-file] [flags]
```

| Flag            | Type   | Default | Description                                                                       |
| --------------- | ------ | ------- | --------------------------------------------------------------------------------- |
| `--inventory`   | string | —       | Path to an optional observed Inventory document                                   |
| `--module-root` | string | —       | Architecture authority root containing cue.mod, base, and all kit definitions     |
| `--output, -o`  | string | —       | Write canonical ResolvedPlan JSON beneath the working directory instead of stdout |

**Examples**

```bash theme={null}
# Print the canonical ResolvedPlan for a StackSpec
stackkit resolve --spec stack-spec.yaml

# Resolve against an observed Inventory
stackkit resolve stack-spec.yaml --inventory inventory.yaml

# Replace the existing plan file beneath the working directory
stackkit resolve stack-spec.yaml --output deploy/.stackkit/resolved-plan.json
```