Releases: nullhack/python-project-template
Releases · nullhack/python-project-template
Release v2.2.20260413 - Luminous Kestrel 🦅
Release v2.2.20260413 - Luminous Kestrel 🦅
"Like a kestrel hovering in clarity, this release streamlines and sharpens our tools"
Changelog
Added
- Architecture-First Feature System - New directory structure separating business and architecture features
- Architectural Analysis Skill - Systematic architecture documentation for each feature
- 8-Phase Development Cycle - Expanded from 7-phase with dedicated Architecture Analysis phase
Changed
- BDD → Acceptance Criteria - Renamed gherkin-validation to acceptance-criteria-validation for accurate terminology
- Consistency Updates - Fixed phase numbering, cross-references, and documentation across all agents and skills
- Epic-Workflow Refactor - Converted from epic-based to feature-selection with architecture-first priority
- Manager Agent - Enhanced with test signature creation capabilities
Removed
- detect-secrets tooling - Removed as overkill for this template's use case
- Redundant template files - Cleaned up CI templates, CodeQL, dependency-review templates
Migration Notes
- No breaking changes in this release
- Projects can continue using existing workflow
SHA: c4c07e4
Release v2.1.20260413 - Polished Gecko
Release v2.1.20260413 - Polished Gecko 🦎
"Like a gecko scaling a wall, this release polishes and adheres to better practices"
Why "Polished Gecko"?
This release is named Polished Gecko because:
- Polished: Extensive cleanup and streamlining of Docker, documentation, and CI/CD workflows
- Gecko: The gecko's feet represent strong adherence - we've fixed CI compliance issues (complexity, CodeQL config) to ensure tight grip on quality standards
Changelog
🐛 Bug Fixes
- fix: remove custom CodeQL workflow to resolve config conflict
- fix: reduce complexity in run function to pass CI checks
- fix: remove Python examples from gherkin-validation skill
- fix: update CI workflow to use app package name
- Fix: Update pyproject.toml to use app package name
✨ Features
- feat: add workflow coordination skills and enhanced QA enforcement
- feat: enhance setup_project.py and update README documentation
- feat: V2 Development Workflow with CI/CD Fixes (#32)
- Adding back codeql
🔧 Refactoring
- Refactor: Update template to use generic app package and restructure setup
- simplify: consolidate Docker setup to single development-focused configuration
📖 Documentation
- docs: clean up README badges and Docker references
🔀 Merges
- Merge pull request #34 from nullhack/feature/app_hardcoded
- Merge pull request #33 from nullhack/V2/init
- Merge pull request #31 from nullhack/V2/init
Summary
This release focuses on polishing the template:
- Removed unused files and streamlined Docker configs
- Fixed CI compliance issues (McCabe complexity, CodeQL conflicts)
- Added enhanced QA enforcement skills for better development workflow
- Refactored to use generic "app" package name for easier templating
** SHA**: 80be795
v2.0.20260411 - Armored Pangolin
🚀 MAJOR RELEASE - V1 → V2 Architecture Transition
This represents a fundamental architectural shift from V1 (template validation workflows) to V2 (project development workflows).
Breaking Changes
- Workflow Architecture: Complete transition from template validation (V1) to project development (V2)
- CI/CD Pipeline: New comprehensive GitHub Actions workflow replacing template-specific workflows
- Branch Structure: V2/init becomes the new development foundation
- Agent Configuration: Updated agent roles and capabilities for project development
Security Improvements
- Enhanced GitHub Actions workflow security with proper permissions blocks
- Removed risky PIP_USER environment variable from CI/CD pipeline
- Added secure error handling to shell scripts with 'set -euo pipefail'
- Implemented job-level permissions for all CI workflow operations
Infrastructure & DevOps
- Modernized Docker setup with security-first containerization approach
- Comprehensive CI/CD pipeline with GitHub Actions integration
- Improved workflow security following GitHub Advanced Security recommendations
- Full project development workflow implementation
Development Experience
- Complete project-focused development environment
- Better error handling and security practices in automation
- Enhanced development workflow with secure defaults
- Improved CI/CD reliability and security posture
Migration Notes
- BREAKING: This is a major version requiring migration from V1 template workflows
- V1 template validation workflows are replaced by V2 project development workflows
- Projects using V1 should plan migration to V2 architecture
- All security improvements follow GitHub security best practices
Vivid Cardinal
Release v1.7.20260410 - Vivid Cardinal
Added
- QA-gated epic workflow with mandatory QA checkpoints
- Requirements-gatherer agent (Business Analyst using BABOK methodology)
- Overseer agent (QA Specialist enforcing quality standards)
- Epic-workflow skill for automatic feature progression
Changed
- All agent descriptions use industry-standard roles
- Model specifications removed (template is model-agnostic)
- Documentation updated to reflect all components
Quality Assurance This release introduces a complete QA-gated epic workflow that mirrors enterprise development practices with dedicated business analyst and QA specialist agents. The workflow enforces quality at 4 mandatory checkpoints.
v1.6.20260409 - Guardian Owl
Release: v1.6.20260409 - Guardian Owl
Added
- Overseer Agent - Quality assurance agent that reviews work after each test implementation and requests changes if needed
- Requirements Gatherer Agent - Agent that asks questions to understand project needs, updates documentation, creates detailed analysis for architect
Changed
- Updated developer workflow to include
@overseercalls after Phase 3 (TDD tests) and Phase 7 (Quality Assurance) - Updated AGENTS.md with new agents and workflow examples
v1.5.20260403 - Crystal Jellyfish
What's New
- pdoc for API documentation with search
- pytest-html-plus for BDD-style HTML test reports
- BDD docstrings display as test names in HTML report
- New task for GitHub Pages deployment
Changes
- Replace mkdocs/mkdocstrings with pdoc
- Add pytest-html-plus with JSON report
- Update conftest.py for BDD docstring extraction
- Coverage reports now in docs/coverage/
Versioning Update
- Removed rN revision suffix
- Format now: v{major}.{minor}.{YYYYMMDD}
elegant swan
v1.6.20260313 - elegant swan
Refactored
- Extract prototype/test patterns to reference files
- Add reference/prototype-patterns.md with guidelines for creating, using, and disposing prototype scripts (MANDATORY deletion after use)
- Add reference/test-patterns.md with TDD test patterns and guidelines
- Update prototype-script skill to reference the new patterns file
- Update tdd skill to reference patterns and embed test data directly
- Update implementation skill to use embedded test data
- Update developer agent workflow to include prototype disposal step
Innovative Dolphin
v1.5.20260313 - Innovative Dolphin
Changes
- feat: Add AI-driven themed naming for releases
- feat: Remove revision from versioning format
New Version Format
- Old: v1.4.20260313r1
- New: v1.5.20260313
Same-day releases now increment minor: v1.5, v1.6, etc.
Usage
cookiecutter gh:nullhack/python-project-templateAI Analysis
Dominant theme: FEATURES - New AI-driven functionality for release naming and cleaner versioning.
Creative Fox
v1.3.20260313r1 - Creative Fox
Changes
- feat: Add session-workflow skill for multi-session AI development
- fix: Remove BDD references and DEVELOPMENT_WORKFLOW.md
- fix: Template hotfix - Jinja2 escaping, calver versioning
Usage
cookiecutter gh:nullhack/python-project-templatev1.0.0 - Creative Dolphin 🐬
Release v1.0.0 - Creative Dolphin 🐬
AI-Enhanced Development Workflow Template
What's New
This is the first major release of the AI-Enhanced Python Project Template!
- AI-Powered Development - OpenCode agents for architecture review, TDD, and repository management
- 7-Phase Development Cycle - Feature Definition → Prototype → TDD → Signature Design → Architecture Review → Implementation → Quality Assurance
- SOLID + Object Calisthenics - Enterprise-grade architecture enforcement
- Smart Releases - Hybrid calver versioning with themed release names
Features Added
- Developer Agent - Main 7-phase TDD/BDD workflow
- Architect Agent - SOLID principles and design review
- Repo-Manager Agent - Git operations, PRs, themed releases
- 10+ Development Skills - feature-definition, prototype-script, tdd-bdd, signature-design, implementation, code-quality, git-release, pr-management
- Template Management - Meta agent and skills for managing the template itself
- Comprehensive CI - Template validation, generated project tests, Docker builds
Technology Stack
- Python 3.13+ with UV package manager
- Ruff for linting/formatting
- PyTest + Hypothesis for testing
- MkDocs for documentation
- Docker multi-stage builds
Documentation
Migration
This is the first semantic version release. No breaking changes.
# Generate a new project
cookiecutter gh:nullhack/python-project-template
# Start AI-assisted development
opencode
/init
@developer /skill feature-definition