Knowledge Portal · engineering documentation

Skip to content

Baseline and Release Policy

Status: Permanent
Applies to: All baseline freezes
Authority: ChatGPT Desktop (Architect) instructs; Developer executes


Purpose

This document defines when freeze, backup, commit, tag, and GitHub push occur in the development workflow. These actions are never automatic and always require Architecture Review approval first.

Technical freeze rules live in core/methodology/GIT_FREEZE_PROCEDURE.md. Release document structure lives in docs/planning/RELEASE_PLAN.md. This document covers operational timing and role boundaries.


Golden Rule

No Git action without Architecture Review approval.

Runtime Adapter / Native IDE does not commit, tag, or push at freeze by default. ChatGPT Desktop does not execute Git operations. The Developer executes only when the Architect explicitly instructs after freeze approval.


When ChatGPT Instructs Each Action

Freeze

When: After implementation, hardening (if any), tests, and architecture review all pass.

ChatGPT confirms:

  • Phase scope complete
  • Frozen platforms untouched
  • Remaining risks documented
  • Release doc drafted or ready to create

ChatGPT says: “Freeze approved. Proceed to release documentation, then backup, commit, tag, push.”

Does NOT mean: Git operations happen immediately — freeze approval authorizes the sequence.


Backup

When: After release document is ready, before Git commit.

ChatGPT confirms:

  • Freeze review passed
  • This is a major baseline (or other backup trigger per BACKUP_POLICY.md)

ChatGPT says: “Create local backup: Dental-Clinic-ROS-v3.8-Production-Hardening-Baseline.zip


Commit

When: After backup (if instructed), with staged scope matching approved phase files only.

ChatGPT confirms:

  • Release doc exists
  • Backup completed (if required)
  • Commit message provided

ChatGPT says: “Commit with message: Release: Production Platform v3.8 (Phase 8A freeze) with Governance Foundation (Phase 8B).

Follow-up: If release doc had Commit: TBD, ChatGPT instructs hash update commit.


Tag

When: After successful commit, working tree clean for phase scope.

ChatGPT confirms:

  • Commit hash matches release doc
  • Tag name matches release doc header

ChatGPT says: “Create annotated tag: v3.8-production-platform


GitHub Push

When: After tag verified locally.

ChatGPT confirms:

  • git rev-parse {tag}^{commit} matches release commit
  • Developer ready to publish baseline to remote

ChatGPT says: “Push branch and tags to GitHub.”


Combined Baseline Example (v3.8)

Phase 8A (Production Hardening) and Phase 8B (Governance Foundation) ship as one Git baseline:

ItemValue
Tagv3.8-production-platform
Release docdocs/releases/v3.8-production-platform.md
Internal recorddocs/releases/v3.8-governance-foundation.md (not independently tagged)
Prior baselinev3.7-observability-platform

Governance Foundation has no independent Git tag — it is incorporated into the production baseline.


What Is Never Automatic

ActionNever triggered by
FreezeCursor completing implementation
BackupCursor test pass
CommitCursor unless Developer explicitly requests in prompt
TagRelease doc creation alone
GitHub PushLocal tag creation alone

Approval Gate Summary

Implementation Report

Architecture Review ──▶ Rejected → rework
        ↓ Approved
[Hardening if required] → re-review

Freeze Review ──▶ Not approved → stop
        ↓ Approved
Release Document

Backup (if instructed)

Commit (instructed)

Tag (instructed)

GitHub Push (instructed)

Next Phase

Release Validation Checklist (ChatGPT)

Before instructing commit:

  • [ ] Canonical release doc path confirmed
  • [ ] Tag name matches doc header
  • [ ] Prior baseline chain documented
  • [ ] Frozen platforms table complete
  • [ ] Verification commands documented
  • [ ] Remaining risks section present
  • [ ] Next phase declared not started


ChatGPT Desktop (Architect) approves the sequence. Developer executes it. Runtime Adapter never owns freeze Git.

ZAIXOS Knowledge Portal — public engineering docs at /docs · Staff operations at /admin