Roadmap

[djdarcy]

Roadmap

Evergreen tracking issue for git-repokit-common development priorities.

Phase 1: Foundation (current)

• Shared scripts, hooks, and tools extracted from projects
• Git subtree workflow (add, pull, push)
• sync-versions.py with pyproject.toml config
• Pre-commit/post-commit/pre-push hooks
• GitHub tools (gh_issue_full.py, gh_sub_issues.py)
• VERSION file for simple version tracking
• update-common.sh for subtree management
• docs/sync-versions.md reference documentation
• Consumer/downstream project tracking ([FEATURE] Track consuming projects for update notifications #1)

Phase 2: Robustness

• Tests for sync-versions.py core logic
• Tests for hook scripts (mock git environments)
• Cross-platform validation (Linux, macOS)
• Handle edge cases in --check (worktrees, detached HEAD, shallow clones)

Phase 3: Integration

• Integration with repokit create / repokit adopt (Phase 2 of git-repokit)
• Auto-notify consuming projects on new releases ([FEATURE] Track consuming projects for update notifications #1)
• Template for project-specific hook extensions

Phase 4: Future

• Plugin system for project-specific hooks
• Dashboard showing all consuming projects and their versions
• Automated subtree PR creation for downstream updates

---

Version	Status	Notes
v0.2.2	Current	update-common.sh, VERSION, sync-versions docs
v0.1.4-alpha	Released	--check fix for unreleased tags, demo/ reorg
v0.1.3-alpha	Released	tag-format config, hook bug fixes
v0.1.0	Released	Initial shared toolbox