Skip to content

Add technical-change skill for structured code change tracking#865

Open
Elkidogz wants to merge 2 commits intoanthropics:mainfrom
Elkidogz:add-technical-change-skill
Open

Add technical-change skill for structured code change tracking#865
Elkidogz wants to merge 2 commits intoanthropics:mainfrom
Elkidogz:add-technical-change-skill

Conversation

@Elkidogz
Copy link
Copy Markdown

@Elkidogz Elkidogz commented Apr 4, 2026

Summary

  • Adds a Technical Change (TC) skill that documents every code change with structured JSON records and generates accessible HTML output
  • Enables AI bot sessions to seamlessly resume work when previous sessions expire or are abandoned
  • Includes Python generators (stdlib only), validators with state machine enforcement, and WCAG AA+ accessible HTML templates

Features

  • Structured JSON records with append-only revision history and field-level change tracking
  • State machine: Planned > In Progress > Blocked > Implemented > Tested > Deployed
  • Test cases with log snippet evidence and manual approval workflows
  • AI session handoff: progress summary, next steps, blockers, key context, decisions made
  • Accessible HTML: dark theme, WCAG AA+, rem-based fonts, skip links, aria labels, print stylesheet
  • CSS-only dashboard with status filters (no JavaScript dependencies)
  • Zero external dependencies — Python stdlib only

Full Repository

https://github.com/Elkidogz/technical-change-skill

Contains the complete implementation: JSON schemas, validators, generators, HTML templates, init templates for project onboarding, and worked examples.

Test plan

  • Example TC record validates against schema (python validate_tc.py examples/example_tc_record.json → VALID)
  • Example registry validates (python validate_tc.py --registry examples/example_tc_registry.json → VALID)
  • HTML generator produces valid output with inlined CSS and dark theme
  • Dashboard generator produces filterable dashboard
  • Dogfooded: the skill tracks its own implementation as TC-001 and TC-002

🤖 Generated with Claude Code

Elkidogz and others added 2 commits April 4, 2026 10:19
A skill that documents every code change with JSON records and generates
accessible HTML output. Enables AI bot sessions to seamlessly resume work
when previous sessions expire or are abandoned.

Features:
- Structured JSON records with append-only revision history
- State machine: Planned > In Progress > Blocked > Implemented > Tested > Deployed
- Test cases with log snippet evidence and manual approval
- AI session handoff (progress, next steps, blockers, key context)
- WCAG AA+ accessible dark-theme HTML pages and dashboard
- CSS-only dashboard filters (no JavaScript)
- Python stdlib only — zero external dependencies

Full repository: https://github.com/Elkidogz/technical-change-skill

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
- Added generate_retro_tcs.py for retroactive bulk TC creation
- Fixed skill frontmatter (user-invocable, tools field, retro in description)
- Added non-blocking subagent tracking pattern (TC bookkeeping in background)
- Updated SKILL.md with /tc retro docs and subagent auto-detection rules

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant