Cline rules

1---
2paths:
3  - "src/domain/citation.py"
4  - "src/domain/value_objects.py"
5  - "src/presentation/tools/document_tools.py"
6  - "src/presentation/tools/table_tools.py"
7  - "tests/unit/test_citation_index.py"
8---
9 
10# Citation-Ready Design Rules (CRAAP Scaffold)
11 
12This repo aims for **citation-ready assets** where a reference can be traced back to a precise span (line/sentence/block) and re-verified after edits.
13 
14## Evidence Span Invariants
15- Prefer stable identifiers and locators: `doc_id`, `span_id`, `source_revision_id`, `locator_version`.
16- When possible, include multiple locators (line/char/byte offsets) plus `text_sha256` and short surrounding context.
17- Avoid false precision: keep CRAAP scores empty unless a real scoring method exists; default to conservative `unassessed`/`needs_review`.
18 
19## Backward-Compatible Tool Outputs
20- When changing structured tool payloads, keep alias keys accepted (don’t break old clients).
21- If removing fields, provide a migration path or tolerate legacy inputs for a full release cycle.
22