QDeskWatch AGENTS.md

QDeskWatch AGENTS.md is an instructions file for Codex, OpenCode from FFmorange/QDeskWatch. It costs 681 tokens per session, scanned A, original, MIT.

Repository instructions for QDeskWatch, a desktop assistant built with Qt 6, QML/Qt Quick, C++17, and CMake. They describe the project and rules for updating agent instructions, documentation, and skills.

In plain words
What is it for?
Use them when modifying QDeskWatch to understand its technology, file structure, and approval rules for project documentation and instructions.
Why use it?
They tell coding agents how to work within this project and when they must ask before changing shared guidance or documentation.

Instructions file for CodexOpenCode

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 instructions/ffmorange/qdeskwatch/agents-md
Clone the repo
git clone --depth 1 https://github.com/FFmorange/QDeskWatch

Made for: Codex, OpenCode.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for QDeskWatch AGENTS.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/ffmorange/qdeskwatch/agents-md.svg)](https://agentmods.dev/instructions/ffmorange/qdeskwatch/agents-md)
Your own site
<a href="https://agentmods.dev/instructions/ffmorange/qdeskwatch/agents-md"><img src="https://agentmods.dev/badge/instructions/ffmorange/qdeskwatch/agents-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 681 This file is loaded in full into every session.
When invoked 681 The same file — it is already loaded in full.
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.00681 $0.00681
Opus 5 $0.00341 $0.00341
Sonnet 5 $0.00136 $0.00136
Haiku 4.5 $0.00068 $0.00068

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

Security

Grade A, and why

QDeskWatch 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 4d 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.

AGENTS.md · 47 lines

What it actually says

AGENTS

本文件用于约束和说明 QDeskWatch 仓库内的协作方式。

更新日期:2026-04-11

项目介绍

  • 本项目是一个参考 Apple Watch / iWatch 视觉语言的 PC 端桌面助手。
  • 当前技术栈以 Qt 6QML / Qt QuickC++17CMake 为核心。

项目文件结构

参考docs/project-file-structure.md

AGENTS.md 更新规范

  • 当判断某项规则适合写入 AGENTS.md 时,应先征求用户确认后再添加,不应直接写入。
  • 凡涉及项目级 AGENTS.md 的修改,无论是新增、删除、调整、合并还是重写条款,均应先征求用户确认,再执行操作。
  • 当准备向项目级 AGENTS.md 添加规则时,如果缓存目录中的 AGENTS.md 已经存在内容相同或语义相近的通用条款,原则上无需重复补充;只有在当前项目存在额外约束、适用范围不同,或确有必要在项目内再次明确时,再考虑添加。
  • 当发现文档、skill、项目级 AGENTS.md,或它们内部多个条款之间存在内容冲突、语义矛盾或适用范围不一致时,应先向用户说明冲突点、涉及位置及可能影响,再询问用户是否需要调整,以及希望保留哪一侧规则或如何合并。

文档更新规范

  • 当判断某份文档可能需要更新时,应先征求用户确认,确认后再执行文档修改。

skill 更新规范

  • 当判断当前使用的 skill 内容可能需要更新时,应先征求用户确认,确认后再执行 skill 修改。

skill 调用规范

  • skill 仅在与当前任务明确匹配时使用,不应为了“显得更高级”而刻意滥用。
  • 项目内 skill 位于 skills/ 目录,默认采用“一个 skill 对应一个目录”的结构存放,即 skills/<skill-name>/SKILL.md,并可按需包含 agents/openai.yaml 等配套文件;执行任务前,应先判断当前需求是否可以由现有 skill 直接处理或辅助处理。
  • 只要当前任务与某个现有 skill 的触发范围明显匹配,就应优先使用该 skill,再开展后续分析、检索或修改。
  • 如果过程中调用了某个 skill,应在过程说明中明确写出所使用的 skill,让用户知道本次任务调用了哪个 skill。
  • 如果项目内 skill 与系统 skill 同时可用,应优先选择更贴近当前仓库语境的 skill;必要时再组合使用。
  • skill 默认只承载方法、流程、判断顺序和输出要求,不应写入过多项目专属事实。
  • 当项目结构发生变化,且某个 skill 与相关文档存在依赖或引用关系时,应先更新项目文档,再让该 skill 引用最新文档。
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. 4d ago First seen · 47 lines · 681 tokens per session scan A e3e153efaf2c

Subscribe to this mod's changes

QDeskWatch AGENTS.md is an instructions file published in the GitHub repository FFmorange/QDeskWatch (2 stars, last pushed 4mo ago), licensed MIT. It adds 681 tokens to every session, about $0.0034 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.

Related

Other instructions, from other repositories

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).

microsoft/vscode · 6,785 tokens

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.

github/spec-kit · 7,104 tokens

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.

openai/codex · 5,182 tokens

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.

langchain-ai/langchain · 4,345 tokens

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).

microsoft/vscode · 5,001 tokens

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.

vercel/next.js · 7,296 tokens