Skip to content
Closed
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
5 changes: 3 additions & 2 deletions src/content/docs/dn-cli/filesystem-context.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,8 +80,9 @@ plan file with the full history and remaining work.

Plan files are kept after local (`--publish none`) runs for review and handoff.
In `--publish pr` or `--publish direct` mode, `dn` deletes the plan file when
all acceptance criteria are complete. Archive landed work with `dn archive` when
you no longer need the plan in the tree.
all acceptance criteria are complete. Land completed work with `dn land` (or
`dn land --single` for one deterministic commit) when you no longer need the plan
in the tree.

## AGENTS.md

Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/dn-cli/installation.md
Original file line number Diff line number Diff line change
Expand Up @@ -241,7 +241,7 @@ without `--skill` — see

| Need | Commands | Reference |
| ------------------- | ------------------------------------------------------- | ----------------------------------------------- |
| Orchestrate Agents | `kickstart`, `prep`, `loop`, `meld`, `fixup`, `archive` | [Orchestrate Agents](/dn-cli/workflows/) |
| Orchestrate Agents | `kickstart`, `prep`, `loop`, `meld`, `fixup`, `land` | [Orchestrate Agents](/dn-cli/workflows/) |
| Working with GitHub | `init stack`, `issue`, `glance` | [Working with GitHub](/dn-cli/github-commands/) |
| Headless Use | `init workflows`, `workflows` | [Headless Use](/dn-cli/headless-use/) |
| Experimental | `context`, `peek`, `todo`, `tidy`, `sync` | [Experimental](/dn-cli/task-list-and-sync/) |
Expand Down
2 changes: 1 addition & 1 deletion src/content/docs/dn-cli/opencode.md
Original file line number Diff line number Diff line change
Expand Up @@ -4,7 +4,7 @@ description: Configure OpenCode for dn locally and in GitHub Actions — phase c
---

OpenCode is the **default agent** for `dn`. Agent-backed commands (`kickstart`,
`prep`, `loop`, `fixup`, `meld`, and scoring in `tidy`) invoke the OpenCode CLI
`prep`, `loop`, `fixup`, `meld`, `land`, and scoring in `tidy`) invoke the OpenCode CLI
unless you pass `--agent` or set another harness in `.github/dn/config.json`.

This page covers OpenCode configuration for local development and for installed
Expand Down
27 changes: 20 additions & 7 deletions src/content/docs/dn-cli/workflows.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,6 @@
---
title: Orchestrate Agents
description: Plan, implement, archive plans, and address PR feedback with dn
description: Plan, implement, land changes, and address PR feedback with dn
---

Workflow commands turn issues, pull requests, or local markdown into durable
Expand All @@ -14,7 +14,7 @@ syntax. Instead of building with the agent one prompt at a time, source context
durable artifacts — plans, branches, commits — at each boundary.

This creates a **shared workflow** between you, your agent, your team, and their
agents. Each step in the flow — plan, implement, review, fix up, archive — can
agents. Each step in the flow — plan, implement, review, fix up, land — can
be picked up by contributor or agent. Run `prep` to flesh out a plan and let
another contributor `loop`, review, and land the implementation. Kick off
`kickstart` and step in when the plan has unfinished work that needs a human
Expand Down Expand Up @@ -118,17 +118,30 @@ dn --agent codex fixup https://github.com/owner/repo/pull/123
The PR URL can also be provided with `PR_URL`. If you are already on the right
branch, no VCS checkout command is run.

## `dn archive`
## `dn land`

Derives a commit message from a plan file:
Commits completed implementation work using plan context. Default mode discovers
the plan file, uses an agent to group workspace changes into logical commits with
conventional-commit messages, and deletes the plan file on success.

```bash
dn archive plans/issue-123.plan.md
dn land
dn land plans/issue-123.plan.md
dn land plans/issue-123.plan.md --dry-run
```

Use `--single` for one deterministic commit (no agent): derives a message from
the plan title and overview, stages the workspace, commits, and deletes the plan
file. This replaces the former `dn archive` command.

# Commit staged files with the derived message, then delete the plan file
dn archive plans/issue-123.plan.md --yolo
```bash
dn land --single plans/issue-123.plan.md
dn land --single plans/issue-123.plan.md --dry-run
```

After a local (`--publish none`) kickstart or loop run, review the diff and run
`dn land` to create commits before `dn sync` or opening a pull request.

## Milestone queues

Milestone queues are generated by `dn init stack` and consumed by `kickstart`:
Expand Down
Loading