diff --git a/AGENTS.md b/AGENTS.md index b01317c..74eb2e1 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -207,10 +207,6 @@ Source: docs/features/in-progress/.md ``` -## Research Foundations - -The cognitive science and social science mechanisms behind this workflow's design are documented in `docs/academic_research.md` — pre-mortem, implementation intentions, adversarial collaboration, elaborative encoding, and 11 other mechanisms with full citations. - ## Setup To initialize a new project from this template: diff --git a/CHANGELOG.md b/CHANGELOG.md index 961941d..8d987fe 100644 --- a/CHANGELOG.md +++ b/CHANGELOG.md @@ -2,6 +2,26 @@ All notable changes to this template will be documented in this file. +## [v3.2.20260415] - Vigilant Mantis - 2026-04-15 + +### Added +- **Adversarial verification mandate**: Reviewer's default hypothesis is now "the code is broken despite green checks" — job is to find the failure mode, not confirm it works (#54) +- **Production-grade gate**: New step 3 in verification — app must exit cleanly AND output must change when input changes; static output regardless of input = REJECTED (#54) +- **UUID Drift bash check**: One-liner detects duplicate UUIDs across test functions; any duplicate = REJECTED with fix instructions (#54) +- **docs/academic_research.md**: 15 cognitive and social science mechanisms with full citations grounding every workflow design decision (pre-mortem, implementation intentions, adversarial collaboration, elaborative encoding, and 11 more) (#54) +- **Design pattern decision table**: Added to `developer.md` and `implementation/SKILL.md`; any detected anti-pattern = REJECTED (#54) +- **Architecture contradiction check**: Developer must cross-check ADRs against ACs before writing production code (#54) +- **PO pre-mortem**: Added at scope step and acceptance step (#54) +- **Semantic alignment rule**: Tests must operate at same abstraction level as AC (#54) +- **Integration test requirement**: Multi-component features require at least one integration test through the public entry point (#54) +- **Verification Philosophy section**: Added to AGENTS.md — automated checks verify syntax-level correctness; human review verifies semantic-level correctness; both required (#54) + +### Changed +- **Verification order**: Code review before automated commands; run app first as production-grade gate (#54) +- **All review sections converted to tables**: Correctness, KISS, SOLID, ObjCal, Design Patterns, Tests, Versions/Build all have PASS/FAIL/Fix columns (#54) +- **UUID Uniqueness rule**: If only Given varies it is a property — use Hypothesis `@given` + `@example`, not multiple test functions; if When/Then differs use `extend-criteria` (#54) +- **Production-grade self-check in implementation**: Developer must verify output changes with input before handoff (#54) + ## [v3.1.20260414] - Tidal Capybara - 2026-04-14 ### Added diff --git a/pyproject.toml b/pyproject.toml index 4eebc1d..81e3c6d 100644 --- a/pyproject.toml +++ b/pyproject.toml @@ -1,6 +1,6 @@ [project] name = "python-project-template" -version = "3.1.20260414" +version = "3.2.20260415" description = "Python template with some awesome tools to quickstart any Python project" readme = "README.md" requires-python = ">=3.13"