Agent skill · software engineering · alirezarezvani
tc-tracker
Use when tracking technical changes as records, or handing work between AI sessions with a change record. Creates, updates and validates change records with tc_create.py, tc_update.py and tc_validator.py.
Why this skill is useful
Adds 5 executable Python scripts for managing technical change records and structured documentation workflows that aren't available in public resources.
What it needs
Requires python3 installed locally. About 6k tokens when loaded. Last updated 2026-08-05. 23,939 stars on the source repository.
What this skill does
TC Tracker Track every code change with structured JSON records, an enforced state machine, and a session handoff format that lets a new AI session resume work cleanly when a previous one expires. Overview A Technical Change (TC) is a structured record that captures what changed, why it changed, who changed it, when it changed, how it was tested, and where work stands for the next session. Records live as JSON in docs/TC/ inside the target project, validated against a strict schema and a state machine. Use this skill when the user: Asks to "track this change" or wants an audit trail for code modifications Wants to hand off in-progress work to a future AI session Needs structured release notes that go beyond commit messages Onboards an existing project and wants retroactive change documentation Asks for /tc init, /tc create, /tc update, /tc status, /tc resume, or /tc close Do NOT use this skill when: The user only wants a changelog from git history (use engineering/changelog-generator) The user only wants to track tech debt items (use engineering/tech-debt-tracker) The change is trivial (typo, formatting) and won't affect behavior Storage Layout Each project stores TCs at {projectroot}/docs/TC/: TC ID Convention Parent TC: TC-NNN-MM-DD-YY-functionality-slug (e.g., TC-001-04-05-26-user-authentication) Sub-TC: TC-NNN.A or TC-NNN.A.1 (letter = revision, digit = sub-revision) NNN is sequential, MM-DD-YY is the creation date, slug is kebab-case. State Machine See references/lifecycle.md for the full transition table and recovery flows. Workflow Commands The skill ships five Python scripts that perform deterministic, stdlib-only operations on TC records. Each one supports --help and --json. 1. Initialize tracking in a project Creates docs/TC/, docs/TC/records/, docs/TC/evidence/, tcconfig.json, and tcregistry.json. Idempotent — re-running reports "already initialized" with current stats. 2. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills alirezarezvani/tc-tracker--1a1a11