Imported from mvanhorn/printing-press-library (library/travel/visit-detroit-blog/AGENTS.md). Install upstream with npx skills add mvanhorn/printing-press-library --skill visit-detroit-blog. Copyright stays with the author.

Inside the D Printed CLI Agent Guide

This directory is a generated visit-detroit-blog-pp-cli printed CLI. It was produced by CLI Printing Press, so treat systemic fixes as upstream Printing Press fixes first. Keep local edits narrow and document why a generated-tree patch belongs here.

Local Operating Contract

Start by asking the generated CLI for current runtime truth:

visit-detroit-blog-pp-cli doctor --json
visit-detroit-blog-pp-cli agent-context --pretty

Use runtime discovery instead of relying on a copied command list:

visit-detroit-blog-pp-cli which "<capability>" --json
visit-detroit-blog-pp-cli <command> --help

Add --agent to command invocations for JSON, compact output, non-interactive defaults, no color, and confirmation-safe scripting:

visit-detroit-blog-pp-cli <command> --agent

Before running an unfamiliar command that may mutate remote state, inspect its help and prefer a dry run:

visit-detroit-blog-pp-cli <command> --help
visit-detroit-blog-pp-cli <command> --dry-run --agent

Use --yes --no-input only after the target, arguments, and side effects are clear.

For install, auth, examples, and longer product guidance, read README.md and SKILL.md. This file intentionally stays small so repo-local agents get invariant local guidance without duplicating the generated docs.

Local Customizations

This directory is generated output -- a fresh print can overwrite the whole tree, so ad-hoc hand-edits don't survive on their own. If you modify the generated code, record each change under .printing-press-patches/ (parallel to .printing-press.json) so a regen carries the intent forward instead of silently dropping it.

The entry shape, and the altitude to write it at -- a durable reprint-guard, not a changelog -- live in the source catalog's AGENTS.md, which is the single source of truth; this guide intentionally doesn't duplicate them.