feat(engineering): add tc-tracker skill

[Elkidogz]

Summary

Adds a self-contained tc-tracker skill under engineering/tc-tracker/ for structured technical change tracking with state machine enforcement and AI session handoff.

This is a resubmission of the previously closed PR #487, fully reworked to match repo conventions. All scripts are now embedded (no external links), the SKILL.md frontmatter is stripped to name + description only, and the slash command is registered in commands/tc.md.

What it does

• Tracks every code change with structured JSON records (what, why, who, when)
• Enforces a state machine: planned -> in_progress -> implemented -> tested -> deployed (with blocked as a side state)
• Stores session handoff data so when an AI session expires, the next one resumes seamlessly with progress, next steps, blockers, and key context
• Append-only revision history with field-level change tracking

What's included

• engineering/tc-tracker/SKILL.md (207 lines, well under 500)
• engineering/tc-tracker/README.md (overview)
• engineering/tc-tracker/scripts/ (5 Python scripts, stdlib only, all support --help and --json)
  • tc_init.py — Initialize TC tracking in a project
  • tc_create.py — Create a new TC record
  • tc_update.py — Update status, files, tests, handoff data
  • tc_status.py — Show TC status (single or all)
  • tc_validator.py — Validate a TC record or registry
• engineering/tc-tracker/references/ (3 reference docs)
  • lifecycle.md — State machine and transitions
  • tc-schema.md — JSON schema reference
  • handoff-format.md — Session handoff structure
• commands/tc.md — Slash command dispatcher (/tc <subcommand> [args])

Convention compliance

• SKILL.md frontmatter has only name + description
• SKILL.md under 500 lines (207)
• Anti-Patterns section included
• Cross-References section included
• All scripts pass python3 script.py --help
• All scripts use Python stdlib only (no pip dependencies)
• All scripts support --json for machine-readable output
• Exit codes: 0=success, 1=warnings, 2=critical errors
• No external repo links in README or SKILL.md
• Slash command registered in commands/tc.md
• Targets dev branch (not main)
• Tested end-to-end: init -> create -> validate cycle works

Test plan

• python3 tc_init.py --root /tmp/test --project demo --json -> creates docs/TC structure
• python3 tc_create.py --root /tmp/test --name feat --title "Test" --scope feature --priority high --summary "..." --motivation "..." --json -> creates valid TC record
• python3 tc_validator.py --registry /tmp/test/docs/TC/tc_registry.json -> VALID
• All scripts pass --help

🤖 Generated with Claude Code

[alirezarezvani]

@claude review the pr. Scan and approve it for the merge, when all criterias are met.

[claude]

Claude Code is working…

I'll analyze this and get back to you.

View job run