AGENTS.md · git:20261114.d6c60d9 · 2026-11-14 · sha256 0011f8c0dc945969

AGENTS.md git:20261114.d6c60d9A

Immutable. This exact content never changes and is served at /api/v1/blob/0011f8c0dc945969.

# AGENTS.md — working on the DENT repository

This repository **is** a skill. If you're an AI agent editing it:

- The skill lives in `skills/dent/`. `SKILL.md` is always loaded by agents that use DENT; keep it lean and put task-specific detail in `skills/dent/references/`.
- Label guidance **[Law]**, **[Rule]** or **[Convention]**. Never weaken a [Rule].
- New style → `skills/dent/references/styles/<name>.md` from `_style-template.md` + a row in `_styles-index.md` + update the style count in `SKILL.md` frontmatter/§9.2 and `README.md`.
- New reference file → add a row to `SKILL.md` §9.2 and to the add-on routing table in `references/workflow-questions-and-effort.md` §4.
- Commands are generated: edit `COMMANDS` in `scripts/build_commands.py`, run it (writes `skills/dent/commands/`, root `commands/` and `docs/COMMANDS.md`), and add a routing row in `references/workflow/orchestration.md`. Never hand-edit generated files.
- Catalogue rows need a link, licence and status (`✓ <date>` only after checking the official source, else `K`).
- Changing `verify_page.py`? Add a case to `evals/fixtures/bad.html` and run `python scripts/test_tools.py` (needs Playwright).
- README visuals come from `assets/build_assets.py`; regenerate, don't hand-edit the SVGs.
- Architecture: `docs/ARCHITECTURE.md`. DENT 2.0 audit/plan/progress: `docs/dent-2/`.
- Run `python scripts/validate.py` after every change; it must print `OK`. Keep SKILL.md under ~450 lines (router only).
- Bump the version in `SKILL.md` metadata, `.claude-plugin/plugin.json` and `.claude-plugin/marketplace.json` together, and add a `CHANGELOG.md` entry.
- Don't put user-specific `DESIGN.md` files in this repo.