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.
npx agentmods add instructions/wate/md-ticket/agents-mdgit clone --depth 1 https://github.com/wate/MD-TicketWhat 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.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5 | $0.02073 | $0.02073 |
| Opus 5 | $0.01037 | $0.01037 |
| Sonnet 5 | $0.00415 | $0.00415 |
| Haiku 4.5 | $0.00207 | $0.00207 |
Grade A, and why
MD-Ticket AGENTS.md 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.
How it starts
The opening of the file, as written. The whole thing — 167 lines — stays where its author put it; the contents beside it link to each section on GitHub.
AIエージェント向けガイド
AIエージェントがMD-Ticketを効果的に利用するためのガイドラインです。
詳細な手順は_guide/配下のドキュメントを参照してください。
前提条件
AGENTS.md統合
プロジェクトルートのAGENTS.mdにMD-Ticketへの参照を追加することで、AIエージェントがチケット管理の存在を認識できます。
統合方法はREADME.mdの「AGENTS.md統合ガイド」を参照してください。
バージョン管理について
Git管理は任意です。 エージェントはGit管理の有無を意識する必要はありません。
基本原則
- 明確性の優先: 不明点はユーザーに確認する(推測で補わない)
- テンプレート遵守: 各チケット種別のテンプレートを使用する
- 段階的詳細化: アイデア→要望→タスクの流れを尊重する
- ライフサイクル管理: チケットの状態に応じてファイルを移動・削除する
- 関連性の記録: チケット間の関連を明確にする
ユーザー確認が必要なケース
以下に該当する場合は、実施前に必ずユーザーへ確認します。
- 情報不足: 必須項目、種別判断の根拠、背景・理由が不明
- 判断の曖昧性: 複数種別への該当、優先度・緊急度不明、重複の可能性
- 重要な決定: 大幅な変更、種別変更、削除、複数タスクへの分割
- スコープ外の修正: 変更ファイルが3つ以上、既存機能の動作変更、テストが複数コマンドにまたがる、主目的から外れる修正
- 技術的・業務的判断: セキュリティ・パフォーマンス影響、他システム・チームへの影響
スコープ外と判断した場合
以下を提示して承認を得ます。
- 本チケットの主目的と指示内容の関係
- 範囲外である理由と影響範囲
- 推奨アクション(別チケット化/今すぐ実施/見送り)
複数の修正は1つずつ提案・実施・テストし、デグレ発生時に該当変更を特定可能にします。
設定ファイル
チケット種別は.ticket/config.ymlで管理されます(任意)。
設定ファイルがある場合は種別情報(label、template、description)を参照し、ない場合はデフォルト4種別(bug, task, idea, request)を使用します。
チケット種別の判断
ユーザーの依頼内容から適切なチケット種別を判断します。 迷った場合はユーザーに確認してください。
- アイデア(
idea/): 発想・構想段階のメモ。実現可能性が未検証 - 要望(
request/): 実現してほしい希望。背景と期待する結果が明確 - タスク(
task/): 実行すべき作業。前提条件と具体的な内容が定まっている - バグ(
bug/): 不具合の報告。再現手順と期待/実際の動作が記載可能
各種別の詳細な判断基準はチケット種別の判断基準を参照してください。
チケットライフサイクル
チケットの作成・管理・クローズの概要です。 詳細な手順はチケットライフサイクルを参照してください。
チケット作成
- 種別判断: ユーザーの依頼内容から種別を判断し、承認を得る
- 情報収集: 種別に応じた必須項目を収集する
- ファイル名決定:
brief-description.md形式で命名する - テンプレート取得と作成:
_template/{type}.mdを使用して作成する - 作成完了の報告: パス・種別・ファイル名を報告する
チケット管理
- 追加情報や進捗があればチケットを更新する
- 成熟度に応じて種別変更(ディレクトリ移動)を提案する
- 関連チケットは種別(関連/前提/派生/重複)とリンクで記述する
チケットクローズ
- クローズ確認: ユーザーに明示的に確認する
- 記録状況の確認: 実施内容・成果物の記録を確認する
- ファイル処理: 参考資料と関連チケットの参照を処理する
- 処理の実行: 削除またはアーカイブを実行する
- ADR記録の提案: 重要な技術判断がある場合に提案する
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.
- 2d ago First seen · 167 lines · 2,073 tokens per session scan A 63c7a7444664
MD-Ticket AGENTS.md is an instructions file published in the GitHub repository wate/MD-Ticket (2 stars, last pushed 3d ago), licensed MIT. It adds 2,073 tokens to every session, about $0.0104 per session on Opus 5. 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.
Other instructions, from other repositories
spec-kit AGENTS.md
AGENTS.md instructions for github/spec-kit, covering agents.md, about spec kit and specify, quickstart — add a new integration in 5 steps, integration architecture and integrationmanifest — file tracking.
vscode buildNext.instructions.md
Working notes and architecture documentation for the new esbuild-based build system in build/next. Use when making changes to the new build pipeline (transpile/bundle commands, NLS plugin, source-map handling, resource copying, or self-hosting watch tasks).
codex AGENTS.md
AGENTS.md instructions for openai/codex, covering rust/codex-rs, the codex-core crate, code review rules, crate api surface and model visible context.
langchain AGENTS.md
AGENTS.md instructions for langchain-ai/langchain, covering global development guidelines for the langchain monorepo, corridor security analysis, project architecture and context, monorepo structure and development tools & commands.
vscode oss-third-party-notices.instructions.md
Instructions for microsoft/vscode, covering vs code oss third-party-notices pipeline, architecture, pipeline flow in ci, applying the notice (cutover) and fallback chain (never fail the build).
next.js AGENTS.md
Instructions for vercel/next.js, covering next.js development guide, codebase structure, monorepo overview, core package: packages/next and other important packages.