Skip to content

fix: use hybrid calver instead of patch in version patterns #29

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
nullhack merged 2 commits into from
Apr 10, 2026
+26 −8
Merged

fix: use hybrid calver instead of patch in version patterns #29

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
d5850ab
chore(release): prepare v1.7.20260410 - Vivid Cardinal
nullhack Apr 10, 2026
0afb7ee
fix: use hybrid calver instead of patch in version patterns
nullhack Apr 10, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
14 changes: 7 additions & 7 deletions .opencode/agents/repo-manager.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -31,18 +31,18 @@ As a Release Engineer focused on the template repository:

## Template Versioning Strategy

For the cookiecutter template repository, use semantic versioning: `v{major}.{minor}.{patch}`
For the cookiecutter template repository, use hybrid calver: `v{major}.{minor}.{YYYYMMDD}`

**Version Semantics:**
- **Major**: Breaking changes to template structure or cookiecutter variables
- **Minor**: New features (agents, skills, workflows) - backward compatible
- **Patch**: Bug fixes, documentation updates, minor improvements
- **Calver**: Calendar date of release (YYYYMMDD)

**Examples:**
- `v1.0.0` - Initial stable template release
- `v1.1.0` - Added new agent capabilities
- `v1.1.1` - Fixed documentation typos
- `v2.0.0` - Changed cookiecutter.json structure
- `v1.0.20260312` - Initial release on March 12, 2026
- `v1.1.20260315` - Added new agent capabilities on March 15
- `v1.2.20260315` - Second release same day (increment minor)
- `v2.0.20260401` - Changed cookiecutter.json structure on April 1

## Release Engineering Standards

Expand Down Expand Up @@ -95,7 +95,7 @@ For the cookiecutter template repository, use semantic versioning: `v{major}.{mi
```bash
git checkout develop
git pull origin develop
git checkout -b release/v{major}.{minor}.{patch}
git checkout -b release/v{major}.{minor}.{YYYYMMDD}
```

2. **Changelog Generation**
Expand Down
2 changes: 1 addition & 1 deletion .opencode/agents/template-manager.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -54,7 +54,7 @@ python-project-template/
## Release Engineering Process

### Semantic Versioning Strategy
Following SemVer 2.0.0 specification: `v{major}.{minor}.{patch}`
Following hybrid calver specification: `v{major}.{minor}.{YYYYMMDD}`
- **Major (Breaking)**: API changes, cookiecutter variable modifications, structural changes
- **Minor (Feature)**: New capabilities, agents, skills, backward-compatible enhancements
- **Patch (Fix)**: Bug fixes, documentation updates, security patches
Expand Down
16 changes: 16 additions & 0 deletions CHANGELOG.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -2,6 +2,22 @@

All notable changes to this template will be documented in this file.

## [v1.7.20260410] - Vivid Cardinal - 2026-04-10

### Added
- **QA-gated Epic Workflow** - Complete epic-based development with mandatory quality checkpoints at each phase
- **Epic-workflow Skill** - Manages epic-based development with automatic feature progression
- **EPICS.md Template** - Epic tracking and management file for generated projects

### Changed
- Updated all agent descriptions to use industry-standard roles (Development Lead, Software Architect, QA Specialist, Business Analyst, Release Engineer)
- Removed model specifications from all agents to make template model-agnostic
- Updated AGENTS.md to properly document all 5 generated project agents and all skills
- Updated README.md with new workflow and agent roles

### Fixed
- Documentation now accurately reflects what exists in template

## [v1.6.20260409] - Guardian Owl - 2026-04-09

### Added
Expand Down
2 changes: 2 additions & 0 deletions README.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -8,6 +8,8 @@

> **Ship production-ready Python projects faster with AI-powered development workflows**

### Latest Release: [v1.7.20260410](https://github.com/nullhack/python-project-template/releases/tag/v1.7.20260410) - Vivid Cardinal

Modern cookiecutter template delivering enterprise-grade Python projects with **OpenCode AI agents**, **TDD/BDD workflows**, and **zero-config quality standards**.

## ✨ What You Get
Expand Down
Loading