clarification

An interactive review of a change ticket that finds unclear or missing implementation details. An architectural decision record is a written record of an important technical choice.

In plain words
What is it for?
Use it before implementation planning to answer specific questions about the artifacts a change should affect, then save those answers in the ticket.
Why use it?
It resolves ambiguity before detailed planning, reducing the chance that developers build the wrong files, components, or interfaces.

Command

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add commands/andkirby/markdown-ticket/clarification
Clone the repo
git clone --depth 1 https://github.com/andkirby/markdown-ticket
Per session 0 Only the description is in the session, so the agent can decide to use it. The body loads when it is invoked.
When invoked 2,778 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00000 $0.02778
Opus 5 $0.00000 $0.01389
Sonnet 5 $0.00000 $0.00556
Haiku 4.5 $0.00000 $0.00278

Measured 2d ago against content hash a76b3e715132, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

clarification scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

prompts/mdt/commands/clarification.md · 273 lines

How it starts

The opening of the file, as written. The whole thing — 273 lines — stays where its author put it; the contents beside it link to each section on GitHub.

MDT Ticket Clarification Workflow (v2)

Interactive clarification workflow for MDT architectural decision records (ADRs) using MCP mdt-all ticket system. Identifies underspecified areas in CR tickets and encodes answers directly into the ticket content.

Core Principle: Ensure concrete artifact specifications exist before implementation. Every ambiguity must be resolved with specific file/component/endpoint references, not behavioral descriptions.

User Input

$ARGUMENTS

Session Context

Use {TICKETS_PATH} in all file path templates below (if it's not defined read ticketsPath key from .mdt-config.toml).

You MUST consider the user input before proceeding (if not empty).

Outline

Goal: Detect and reduce ambiguity or missing artifact specifications in the active CR ticket using an interactive questioning interface and record clarifications directly in the ticket.

Note: This clarification workflow should run BEFORE detailed implementation planning. If the user explicitly states they are skipping clarification (e.g., exploratory spike), you may proceed, but must warn that downstream rework risk increases.

Execution steps:

  1. Load the CR ticket using mdt-all:get_cr with mode="full" to retrieve both attributes and markdown content.

    • Parse CR key, project code, current status from response
    • If ticket doesn't exist, abort and instruct user to create CR first
    • If ticket status is "Implemented" or "Rejected", warn that clarification may not be appropriate
  2. Perform structured artifact-specification scan using this taxonomy. For each category, mark status: Clear / Partial / Missing. Produce internal coverage map for prioritization (do not output raw map unless no questions will be asked).

    Artifact Identification:

    • Files, components, modules explicitly named
    • Endpoints/APIs with concrete paths
    • Methods/functions with signatures
    • Configuration files and their structure
    • Database entities and schema elements

Read the full file on GitHub · 273 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 2d ago First seen · 273 lines · 0 tokens per session scan A a76b3e715132

Subscribe to this mod's changes

clarification is a command published in the GitHub repository andkirby/markdown-ticket (5 stars, last pushed 16d ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 2,778 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.