---
docgen:
  source: npm/skills/doc-files/js/docgen-extract-anchors.mjs
  crc: e80e0827
---

# docgen-extract-anchors

## Огляд

Детермінований витяг «анкорів» — конкретних фрагментів коду, які модель зобов'язана згадати в документації, щоб не зісковзнути на generic-фрази. Анкори підставляються у промпти окремим блоком обов'язкового включення, а їх покриття перевіряється скорером.

## Поведінка

1. З тексту джерела збираються п'ять категорій анкорів: усі URL; експортовані константи-рядки з непорожнім значенням; маркери повідомлень про помилки виду `(rule.mdc)`; посилання на json-конфіги проєкту; code-block-приклади з провідного коментаря файлу (де автор зазвичай показує контракт).
2. Кожна категорія дедуплікується зі збереженням порядку появи.
3. Для промпта анкори форматуються в компактний текстовий блок з інструкціями, де саме їх згадати; якщо анкорів немає взагалі — блок не додається, щоб не вводити модель в оману «обов'язковими» полями.

## Публічний API

- `extractAnchors` — текст джерела → категоризовані анкори.
- `anchorsToPrompt` — анкори → текстовий блок для system-промпта або порожній рядок.

## Гарантії поведінки

- Повністю детермінований і read-only; жодних LLM-викликів і мережі.
- Працює по сирому тексту без AST: дешево і свідомо толерує надлишок (зайвий анкор — менша проблема, ніж пропущений).
