AGENTS.mdA

AGENTS.md from izittmarvin/nova-agent is an AGENTS.md file: the standing instructions coding agents read in that repo.

Install it, pinned
mdr add izittmarvin/nova-agent/AGENTS.md@git:20260906.2c02b7f

Pins git:20260906.2c02b7f in mdr.lock. Pin the fingerprint instead.

Audit grade
A, 14 of 14 checks passed
Kind
AGENTS.md file
Repository
izittmarvin/nova-agent
Path
AGENTS.md
Versions recorded
5
Latest version
git:20260906.2c02b7f, committed Sep 6, 2026
First version recorded
Aug 14, 2026
Size
13,242 bytes
Repository stars
168
License
MIT

Collected from public GitHub. Every version is saved exactly as it was and never changes. Install it at an exact version with the mdr tool, and every file is checked before it reaches your agent. The main file is checked against the SHA-256 fingerprint recorded here, and the others against the fingerprints GitHub keeps for its source commit. The automatic checks below grade the latest version, and the same checks always give the same file the same grade.

What the file says

# Nova Agent 工程规则

本文件是所有人类开发者与 Coding Agent 的**强制入口**。开始任何修改前,必须先阅读本文件;涉及架构、状态、公共契约、兼容或跨模块改动时,还必须阅读 [`engineering-rules.md`](engineering-rules.md)。修改测试、测试基础设施或 Renderer/Electron 生命周期时,还必须阅读 [`tests/AGENTS.md`](tests/AGENTS.md)。

在系统与平台约束之下,规则优先级为:任务明确要求 > 本文件 > 适用的目录级规则与详细工程规则 > 全局默认规则 > 现有代码惯例。目录规则细化对应领域,不能隐式放宽架构、安全或授权边界;同一版本已完整读取的材料无需机械重读。现有代码不因存在已久而自动成为正确范例。

## 任务适用范围与完成

- 解释、检查、审查和诊断默认只读,以有证据的结论完成,不因发现问题自动修复;“检查并修复”等明确请求包含相应实施授权。
- 对已授权且范围明确的修改,自主完成必要调查、实施和适度验证,不把计划当作最终交付,也不逐步重复请求确认。只有缺少会实质影响结果且调查无法确定的信息,或下一步超出授权时才询问。
- 下文的 Owner、契约、并发和生命周期要求用于涉及这些概念的改动,不要求文档或局部静态修改虚构对应流程。开发检查清单按实际影响核对,不适用项可略过。
- 中文交流、模型与子代理角色偏好沿用有效的全局或任务要求;日常工作不因此强制使用多模型、子代理、独立计划文档或全量测试。
- 完成意味着约定范围已交付、适用验证已执行且结果如实报告;受阻时按停止条件处理,不擅自缩减需求,也不无限扩展到无关问题。

---

## 强制写作规范(必须遵守)

以下三条对所有 Agent **一律强制**,不得以「便于追踪」「方便以后看」为由放宽。

### 1. 严禁任务编号与过程痕迹

注释、commit message、PR 说明、代码文档中**严禁**出现:

- 任务编号、阶段号、PR 编号(如 `P0`/`P1`/`P4`、`Phase 6`、`#1853`)
- 临时方案名、验收项编号、内部工单号
- 「完成了某任务」「修复了某 Bug」「按某某计划」这类过程汇报

这些内容应留在 Git 历史之外的任务系统里;写进仓库会污染可读性。

### 2. Commit message:像软件更新说明

Commit 面向「读 changelog 的人」,写**优化了什么、改进了什么、重写了什么**,不要写成技术实现流水账。

**要求:**

- 标题:`type(scope): 一句话概括用户/产品侧变化`(conventional commits)
- 正文:若干短 bullet,每条说清一项可感知的变化
…

Read the whole file at its exact version.

How to install

The exact contents, by fingerprint
mdr add izittmarvin/nova-agent/AGENTS.md@sha256:3723183ad7512c25

The line at the top of this page pins the label git:20260906.2c02b7f, which is what most people want. This one pins the sha256 fingerprint of the contents instead, so it survives a label being moved. Either way the exact version is written to mdr.lock, and mdr install downloads and checks those contents again, so it installs them exactly or stops with an error.

Badge

mdr badge

[![mdr](https://markdownregistry.com/badge/art_qw2y36qqtdkpyhrs.svg)](https://markdownregistry.com/a/art_qw2y36qqtdkpyhrs)

3 badge image fetches in 30 days. What the badge shows.

Versions

The registry has recorded 5 versions of this file, between Aug 14, 2026 and Sep 6, 2026, about one every 6 days.

versioncommittedcommitsizeaudit
git:20260906.2c02b7f latest2026-09-06 2c02b7f 13,242 BA view · diff
git:20260905.2f827922026-09-05 2f82792 12,831 BA view · diff
git:20260817.f8d39662026-08-17 f8d3966 9,996 BA view · diff
git:20260814.eb457992026-08-14 eb45799 9,427 BA view · diff
git:20260814.ebcf12e2026-08-14 ebcf12e 9,393 BA view

Audit of the latest version

A  14 of 14 checks passed. Fixed automatic checks with no AI involved, so the same checks give the same answer every run.
  • pass: Size between 200 bytes and 200 KB (13242 bytes)
  • pass: No zero-width or bidi control characters
  • pass: No instruction hidden inside an HTML comment
  • pass: No link to an exfiltration or paste host
  • pass: No credential-shaped string
  • pass: No instruction to send local credentials anywhere
  • pass: No text hidden with inline styles
  • pass: No prompt-injection phrasing
  • pass: No curl or wget piped into a shell
  • pass: No recursive delete of root, home or parent
  • pass: No instruction to read or print local credentials
  • pass: No base64 blob over 200 characters
  • pass: No link to a raw IP address
  • pass: No script tag

Source

GitHub

izittmarvin/nova-agent · 168 stars · license MIT · pushed 2026-10-16 · branch main

API

GET https://markdownregistry.com/api/v1/artifacts/art_qw2y36qqtdkpyhrs
GET https://markdownregistry.com/api/v1/resolve?ref=izittmarvin/nova-agent/AGENTS.md
GET https://markdownregistry.com/api/v1/blob/3723183ad7512c25b848bf4e830a8c04539503d9fd70379ad648a48b7fa9d8e1

Your AI assistant does the legwork. You hear about the deals worth your word. Hand yours the standing instructions at modelranch.com and it joins the network that reads files like this one.

Guides: how to write a good AGENTS.md · AGENTS.md vs CLAUDE.md · which agent file does what.

More from izittmarvin/nova-agent

code-review SKILL.md skill
izittmarvin/nova-agent · .nova/skills/code-review/SKILL.md · 收集工作区未提交改动或最近一次提交的 git 变更面,做只读代码审查并给出带文件行号的问题清单。适用:审查改动、检查刚写的代码质量。不修改代码。
git:20260808.5aa082b · audit A · 168 stars
deep-research SKILL.md skill
izittmarvin/nova-agent · .nova/skills/deep-research/SKILL.md · 把研究问题拆成子问题后并行只读检索,综合成带来源引用的结论并复核证据。适用:调研主题、技术选型对比、查清事实并给出可追溯结论。不修改代码。
git:20260808.5aa082b · audit A · 168 stars
new SKILL.md skill
izittmarvin/nova-agent · .nova/skills/new/SKILL.md · 空白技能脚手架模板,复制后修改 name/description/body 即可使用
git:20260611.179bca1 · audit A · 168 stars
nova-frontend SKILL.md skill
izittmarvin/nova-agent · .nova/skills/nova-frontend/SKILL.md · Anti-slop, high-craft frontend design: landing pages, brand sites, portfolios, dashboards, product/admin UI, commerce…
git:20260708.a7a83cd · audit A · 168 stars
onboard SKILL.md skill
izittmarvin/nova-agent · .nova/skills/onboard/SKILL.md · 首次启动向导:了解工作区、配置规则与技能,快速上手 Nova Agent
git:20260611.179bca1 · audit A · 168 stars
skill-add SKILL.md skill
izittmarvin/nova-agent · .nova/skills/skill-add/SKILL.md · 从 URL 或 zip 安装第三方技能到 ~/.nova/skills 或项目 .nova/skills
git:20260611.179bca1 · audit A · 168 stars
skill-creator SKILL.md skill
izittmarvin/nova-agent · .nova/skills/skill-creator/SKILL.md · 交互式创建或优化 Nova Agent 技能(SKILL.md),支持 quick 模式与模板
git:20260611.179bca1 · audit A · 168 stars
AGENTS.md@tests AGENTS.md file
izittmarvin/nova-agent · tests/AGENTS.md
git:20260908.e2d0385 · audit A · 168 stars

Every file in izittmarvin/nova-agent

Other files named AGENTS.md

AGENTS.md AGENTS.md file
morluto/rea · AGENTS.md
git:20261101.d684125 · audit A · 417,919 stars
AGENTS.md AGENTS.md file
obra/superpowers · AGENTS.md
git:20261020.b739a8a · audit A · 309,852 stars
AGENTS.md AGENTS.md file
affaan-m/ecc · AGENTS.md
git:20261030.f29e332 · audit A · 293,827 stars
AGENTS.md AGENTS.md file
firecrawl/firecrawl · AGENTS.md
git:20261008.5a75dca · audit A · 198,353 stars
AGENTS.md AGENTS.md file
dietrichgebert/ponytail · AGENTS.md
git:20261008.2a1fe84 · audit A · 182,080 stars
AGENTS.md AGENTS.md file
graphify-labs/graphify · AGENTS.md
git:20260926.98d73fe · audit A · 139,879 stars
AGENTS.md AGENTS.md file
garrytan/gstack · AGENTS.md
git:20261027.a50cf58 · audit A · 138,879 stars
AGENTS.md AGENTS.md file
juliusbrussee/caveman · AGENTS.md
git:20260902.d9faebc · audit A · 116,476 stars

Browse by kind, by grade A, or by owner.