| name | track-refs |
| description | Maintain references/INDEX.md, classify reference RT tier, and emit BA-design triplet rows. Use when adding or refreshing reference projects. |
track-refs
Maintains the local reference catalog used by planning and BA design passes.
When to invoke
- BA design pass needs a reference scan table
- User adds a local reference repo under
references/
- A round needs reference relevance refreshed
Commands
Add a local reference:
arcgentic track-refs add references/<repo> \
--owner-repo owner/repo \
--round R1 \
--usage-evidence '{"pattern_only": true}'
Emit BA-design triplet row:
arcgentic track-refs triplet references/<repo> \
--owner-repo owner/repo \
--round R1 \
--usage-evidence '{"pattern_only": true}'
Refresh relevance marker:
arcgentic track-refs refresh-relevance --round R1
RT tiers
| Tier | Meaning |
|---|
| RT0 | Pattern-only reference; no copied/runtime dependency |
| RT1 | Source-adapted code allowed by license |
| RT2 | Binary vendored/distributed |
| RT3 | Imported at runtime |
GPL/AGPL source adaptation is forced to RT0 unless separately approved.
See also
agents/ref-tracker.mdtoolkit/src/arcgentic/skills_impl/track_refs.py
