lingyuzeng
3e07402f4e
Add a public numbering module and route fragmenting, validation, and scaffold preparation through the canonical numbering entry. Rewrite the repository entry docs around the fixed numbering contract, add MkDocs landing pages, and document the mirror mapping used for medicinal-chemistry comparisons. Also refresh the validation analysis reports to explain the canonical-versus-mirrored numbering relationship.
1.3 KiB
1.3 KiB
AGENTS.md
This is the only authoritative agent entry for this repository.
If another AGENTS.md file says something different, follow this file.
Canonical numbering
1 = 内酯羰基碳2 = 相邻酯氧3..N = 从 2 位出发沿环唯一图遍历顺序继续编号
For 16-membered rings, the mirror mapping is fixed:
3 → 164 → 155 → 146 → 137 → 128 → 119 → 10
This numbering is deterministic and is not a visual clockwise / anticlockwise toggle.
它不是视觉顺时针，也不是视觉逆时针切换。
The public API does not expose clockwise or anticlockwise parameters.
Practical rule
- Use canonical numbering in code, reports, and validation outputs.
- Convert to literature-style mirrored labels only when you are comparing against a source that numbers the ring from the opposite direction.
- Keep bridge / fused multi-anchor cases explicit; do not silently reinterpret them as a direction choice.
Entry points
README.mdis the progressive disclosure landing page.docs/index.mdis the documentation landing page.docs/user-guide/ring-numbering.mdis the canonical numbering reference.docs/development/project-structure.mdis the repository layout reference.docs/project-docs/AGENTS.mdpoints back here and should never override this file.