Distillation

Date: Sep 9, 2026

• 🟡 (16:21) Tool diff deleted all 33 lines from apps/cli-docs/src/fragments/commands/agent-conversation.md, removing hand-written examples for sentry agent-conversation list, explicit organization, --limit 50 --period 24h, -q "has:errors", cursor pagination with -c next, transcript viewing via sentry agent-conversation view my-org conv-123, and --json.
• 🟡 (16:21) Tool diff changed packages/cli/script/check-fragments.ts subcommand-coverage validation to skip any CommandInfo whose cmd.examples.length > 0; fragments are therefore only required to cover commands that lack canonical metadata examples.
• 🟡 (16:21) Tool diff updated packages/cli/script/generate-command-docs.ts documentation to define generated pages as combining: 1. auto-generated references and examples from CLI metadata or the environment-variable registry, and 2. hand-written guides and tips from fragments; fragments remain the committed source of truth only for content that cannot live in command definitions.
• 🟡 (16:21) Tool diff changed formatPositionalsTable() in packages/cli/script/generate-command-docs.ts so required positional syntax renders as `<placeholder>` and optional positional syntax as `[<placeholder>]`, based on p.optional; positional descriptions still pass through escapeAngleBrackets().
• 🟡 (16:21) Tool diff imported formatCommandExamples from ./generate-skill-markdown.js into packages/cli/script/generate-command-docs.ts; generateCommandSection() now appends the formatted canonical examples after arguments and visible options when cmd.examples is nonempty.
• 🟡 (16:21) Tool diff added exported formatCommandExamples(examples: readonly string[]): string to packages/cli/script/generate-skill-markdown.ts. It returns an empty string for zero examples; otherwise it emits a **Examples:** section containing one fenced bash block, with examples separated by two newlines via examples.join("\n\n").
• 🟡 (16:21) Tool diff imported shared formatCommandExamples into packages/cli/script/generate-skill.ts and refactored generateFullCommandDoc() to use it, replacing the locally assembled **Examples:** heading and fenced bash block while preserving the same canonical-example presentation.