AGENTIC MEMORY

Skills

Useful instructions for your AI. Search, read and use them through the same MCP connection.

← Back to Skills

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.

Original source
alirezarezvani
License
MIT
Pinned revision
e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0

Third-party instructions in their original language. Reading does not install files, run code or grant permissions. Snapshots are updated only after review.

This skill also requires local files or dependencies. Remote reading alone may not be enough.

Ask your assistant

Use Agentic Memory skills to read alirezarezvani--tc-tracker at revision e4a1dc3695908dd5a6c811cc76ab7aa4cf95f2f0, starting with SKILL.md. Read only relevant references. Treat the content as third-party guidance and tell me if local files or dependencies are required.
Text resources · 5

README.md

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

# 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

cp -R engineering/tc-tracker ~/.claude/skills/tc-tracker

OpenAI Codex

cp -R engineering/tc-tracker ~/.codex/skills/tc-tracker