From 264021f6b3d7173047326f2680905d6fe3f81186 Mon Sep 17 00:00:00 2001 From: Chris Mucciolo Date: Sat, 27 Jun 2026 01:16:35 -0400 Subject: [PATCH] Document dn land replacing dn archive. Users now finish plan-backed work with dn land; --single covers the former archive one-shot commit path. Co-authored-by: Cursor --- src/content/docs/dn-cli/filesystem-context.md | 5 ++-- src/content/docs/dn-cli/installation.md | 2 +- src/content/docs/dn-cli/opencode.md | 2 +- src/content/docs/dn-cli/workflows.md | 27 ++++++++++++++----- 4 files changed, 25 insertions(+), 11 deletions(-) diff --git a/src/content/docs/dn-cli/filesystem-context.md b/src/content/docs/dn-cli/filesystem-context.md index 9951490..6872492 100644 --- a/src/content/docs/dn-cli/filesystem-context.md +++ b/src/content/docs/dn-cli/filesystem-context.md @@ -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 diff --git a/src/content/docs/dn-cli/installation.md b/src/content/docs/dn-cli/installation.md index 55e0393..6d6cf9d 100644 --- a/src/content/docs/dn-cli/installation.md +++ b/src/content/docs/dn-cli/installation.md @@ -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/) | diff --git a/src/content/docs/dn-cli/opencode.md b/src/content/docs/dn-cli/opencode.md index c9e521e..3589230 100644 --- a/src/content/docs/dn-cli/opencode.md +++ b/src/content/docs/dn-cli/opencode.md @@ -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 diff --git a/src/content/docs/dn-cli/workflows.md b/src/content/docs/dn-cli/workflows.md index 5c26a2e..902e7ba 100644 --- a/src/content/docs/dn-cli/workflows.md +++ b/src/content/docs/dn-cli/workflows.md @@ -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 @@ -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 @@ -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`: