freeze

Code Freeze

Lock the codebase in preparation for a release. Create a .freeze file containing freeze information.

Workflow

1. Read Current Status

Check if .freeze already exists by reading the file. If it exists, display the information and ask:

"The codebase is currently frozen for: [REASON]. Do you want to override the current freeze? (yes/no)"

If no, stop.

2. Get Freeze Reason

If no argument is provided, ask:

"What is the reason for the freeze? (e.g., 'Release v2.1.0', 'Hotfix deployment', 'Sprint end')"

3. Create .freeze File

Write the following content:

FROZEN=true
REASON=[reason]
FROZEN_AT=[ISO timestamp]
BRANCH=[current branch from git rev-parse --abbrev-ref HEAD]

4. Notification

Display:

🔒 CODEBASE FROZEN
Reason : [reason]
Time   : [timestamp]
Branch : [branch]

Non-critical merges are blocked. Only hotfixes are permitted.
To unlock: /unfreeze

5. Suggested Next Steps

• /release-checklist — Run the full release checklist
• /guard — Check the freeze status at any time
• /unfreeze — Unlock after the release is complete

Edge Cases

• Existing freeze: Ask for override confirmation before overwriting.
• No git repository: Still create .freeze but omit the BRANCH field.

Related Skills

• /guard — Check freeze status before merge/deploy
• /unfreeze — Remove freeze after release
• /release-checklist — Full release workflow
• /hotfix — Deploy urgent fixes during a freeze