done-agent-pack

Done Agent Pack CLI — turn any folder into a Done-style agentic workspace for Claude Code, Cursor, Codex, Antigravity, and any agent that reads AGENTS.md.

Install

# Global install
npm install -g done-agent-pack

# Or run without installing
npx done-agent-pack init my-project

The CLI binary is named donepack to avoid colliding with the legacy done npm package.

Commands

donepack init [target]

Initialize a Done Agent Pack workspace.

donepack init                # initialize current directory
donepack init my-project     # create new dir and initialize it
donepack init --dry-run      # preview without writing
donepack init --force        # overwrite existing .done/
donepack init --mode EXISTING_REPO_MODE   # force a mode
donepack init --json         # JSON output

donepack status [target]

Print the current workspace state: detected mode, active phase, active ticket, open gates and risks.

donepack status              # status of current dir
donepack status my-project   # status of a specific dir
donepack status --json       # JSON output

donepack align [target]

Audit an existing repo against the Done methodology and generate a remediation backlog.

donepack align               # read-only alignment audit
donepack align --write       # write .done/reports/ADOPTION_AUDIT.md and seed BUILD_STATE if empty
donepack align --write --force  # replace an existing BUILD_STATE with the generated remediation backlog
donepack align --json        # JSON output

donepack workspace [target]

Inspect or install a multi-repo Done workspace from the container folder.

donepack workspace                         # inspect repos, contracts and release order
donepack workspace --write                 # write .done/workspace/WORKSPACE.md if missing
donepack workspace --write --install       # install Done in root + writable child repos
donepack workspace --install --dry-run     # preview installs without writing
donepack workspace --install --force       # overwrite existing Done files intentionally
donepack workspace --json                  # JSON output

Use this when the current folder contains sibling repos like backend/, web/, mobile/ and admin/. The install path is conservative: existing .done//AGENTS.md files are preserved unless --force is set.

donepack doctor [target]

Validate that the workspace contains a complete, well-formed pack.

donepack doctor              # health check of current dir
donepack doctor --json       # JSON output

Exits with code 1 if blocking issues (critical or high) are found.

donepack --version

Show CLI and pack versions.

donepack --version
# donepack v0.33.2
# pack v2.20.1

donepack check-server [target]

Verify server-side correctness: validation, auth/authz, service-role safety, webhook signatures, rate limits, idempotency and status mapping.

donepack check-server
donepack check-server --json

donepack check-design [target]

Verify LEY 3: a product-specific Design Intake and BRAND.md exist before roadmap/build.

donepack check-design
donepack check-design --json

donepack check-architecture [target]

Verify LEY 4: platform architecture, backoffice, permissions, env/deploy plan and server contracts are closed before roadmap/build.

donepack check-architecture
donepack check-architecture --json

Compatibility

• Node 20 or higher.
• macOS, Linux, Windows.
• Designed for Claude Code first, but works with any agent that reads AGENTS.md.

Quick start

mkdir my-project
cd my-project
npx done-agent-pack init
# Open with your coding agent and start your first prompt:
# "Build <your idea>."
# Done activates from the workspace files; no magic phrase required.

License

MIT