ml-debug/AGENTS.md

Local Instructions

Quote-first evidence

When adding evidence or appendix material for this skill, prefer the expert's own words over assistant synthesis. These sources are high-level SME material, often above current frontier LLM taste and more diverse than model priors. Quoting them is grounding data; rewording them injects assistant bias.

• Use generous quote blocks, usually 2-3 sentences or a full paragraph.
• Preserve the author's paragraph flow. Do not insert blank blockquote lines between sentences from the same paragraph; it makes expert prose harder to read and adds fake structure.
• Keep editorial text sparse and mostly for routing: why this source is here, when to read it, and what local file it supports.
• Do not atomize useful source material into tiny one-line quotes when a longer block preserves the author's reasoning.
• Put lower-relevance sources in "See also" rather than forcing a synthetic narrative around them.
• In SKILL.md, link to reference docs like refs/research_taste.md instead of copying a long assistant-written summary.