alirezarezvani/claude-skills / engineering/skills/tc-tracker
tc-tracker
VerifiedUse 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.
| File | Kind | Size |
|---|---|---|
| README.md | markdown | 2.2 KB |
| SKILL.md | skill md | 10.0 KB |
| references/handoff-format.md | markdown | 5.2 KB |
| references/lifecycle.md | markdown | 3.9 KB |
| references/tc-schema.md | markdown | 5.3 KB |
| scripts/tc_create.py | script | 9.7 KB |
| scripts/tc_init.py | script | 6.7 KB |
| scripts/tc_status.py | script | 7.2 KB |
| scripts/tc_update.py | script | 13.8 KB |
| scripts/tc_validator.py | script | 13.9 KB |
README.md
View on GitHub# TC Tracker
Structured tracking for technical changes (TCs) with a strict state machine, append-only revision history, and a session-handoff block that lets a new AI session resume in-progress work cleanly.
## Quick Start
```bash
# 1. Initialize tracking in your project
python3 scripts/tc_init.py --project "My Project" --root .
# 2. Create a new TC
python3 scripts/tc_create.py --root . \
--name "user-auth" \
--title "Add JWT authentication" \
--scope feature --priority high \
--summary "Adds JWT login + middleware" \
--motivation "Required for protected endpoints"
# 3. Move it to in_progress and record some work
python3 scripts/tc_update.py --root . --tc-id <TC-ID> \
--set-status in_progress --reason "Starting implementation"
python3 scripts/tc_update.py --root . --tc-id <TC-ID> \
--add-file src/auth.py:created \
--add-file src/middleware.py:modified
# 4. Write a session handoff before stopping
python3 scripts/tc_update.py --root . --tc-id <TC-ID> \
--handoff-progress "JWT middleware wired up" \
--handoff-next "Write integration tests" \
--handoff-blocker "Waiting on test fixtures"
# 5. Check status
python3 scripts/tc_status.py --root . --all
```
## Included Scripts
- `scripts/tc_init.py` — Initialize `docs/TC/` in a project (idempotent)
- `scripts/tc_create.py` — Create a new TC record with sequential ID
- `scripts/tc_update.py` — Update fields, status, files, handoff, with atomic writes
- `scripts/tc_status.py` — View a single TC or the full registry
- `scripts/tc_validator.py` — Validate a record or registry against schema + state machine
All scripts:
- Use Python stdlib only
- Support `--help` and `--json`
- Use exit codes 0 (ok) / 1 (warnings) / 2 (errors)
## References
- `references/tc-schema.md` — JSON schema reference
- `references/lifecycle.md` — State machine and transitions
- `references/handoff-format.md` — Session handoff structure
## Slash Command
When installed with the rest of this repo, the `/tc <subcommand>` slash command (defined at `commands/tc.md`) dispatches to these scripts.
## Installation
### Claude Code
```bash
cp -R engineering/tc-tracker ~/.claude/skills/tc-tracker
```
### OpenAI Codex
```bash
cp -R engineering/tc-tracker ~/.codex/skills/tc-tracker
```
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 194k | Updated | Claude CodeCodex | Verified | Install |