# Track Refs

> Maintain references/INDEX.md, classify reference RT tier, and emit BA-design triplet rows. Use when adding or refreshing reference projects.

- Skill: `arch1esun/track-refs` (Agent Skill)
- Install (CLI): `npx skillmds@latest add arch1esun/track-refs`
- Raw SKILL.md: https://api.skillmd.com/api/skills/arch1esun/track-refs/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Arch1eSUN (https://skillmd.com/u/arch1esun)
- Updated: 2026-09-21
- Page: https://skillmd.com/skills/arch1esun/track-refs

---


# 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:

```bash
arcgentic track-refs add references/<repo> \
  --owner-repo owner/repo \
  --round R1 \
  --usage-evidence '{"pattern_only": true}'
```

Emit BA-design triplet row:

```bash
arcgentic track-refs triplet references/<repo> \
  --owner-repo owner/repo \
  --round R1 \
  --usage-evidence '{"pattern_only": true}'
```

Refresh relevance marker:

```bash
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.md`
- `toolkit/src/arcgentic/skills_impl/track_refs.py`