guard

Verify codebase freeze status before merging, deploying, or pushing to protected branches.

70|42|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/tranhieutt/software_development_department --skill guard-tranhieutt
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: guard
Source: https://github.com/tranhieutt/software_development_department/tree/main/.claude/skills/guard
Command: npx skills add https://github.com/tranhieutt/software_development_department --skill guard-tranhieutt

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Prevents accidental merges, deployments, or pushes during an active codebase freeze by surfacing the freeze state and enforcing policy before any critical change touches protected branches.

Core Features & Use Cases

  • Freeze detection: Reads the .freeze indicator to immediately confirm whether the repository is locked or clear, so that release managers never miss an active freeze window.
  • Contextual guidance: Displays the freeze reason, timestamp, branch, and duration while clearly stating the allowed change types during the freeze period.
  • Decision gate: Prompts the agent to classify the requested action (hotfix, release artifact, or non-critical) and either permits essential changes with a warning or blocks non-critical work, plus suggests helpful follow-up commands like /unfreeze or /hotfix.

Quick Start

Use the guard skill to verify the codebase freeze status before merging, deploying, or pushing to protected branches.

Frequently Asked Questions about guard

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I prevent accidental deployments during a codebase freeze?

To prevent accidental deployments during a codebase freeze, you need a decision gate that reads the `.freeze` indicator to confirm repository status. This blocks non-critical merges and pushes to protected branches while surfacing freeze metadata.

Can I push a hotfix to a protected branch while a release freeze is active?

Yes, you can push a hotfix during an active release freeze. The system classifies the requested action and permits essential changes like hotfix or release artifacts with a warning, while continuing to block non-critical updates.

What is a code freeze indicator and how does it work with deployments?

A code freeze indicator is a `.freeze` file that signals an active repository lock. When checked before deployments, it provides metadata including the freeze reason, timestamp, branch, and duration to enforce release policies.

How do I check freeze metadata before merging changes?

Check freeze metadata before merging by reading the `.freeze` indicator. The system displays contextual guidance including the freeze reason, timestamp, branch, and duration, while clearly stating the allowed change types during the freeze period.

Does this freeze gate block all pushes to protected branches?

No, the freeze gate does not block all pushes to protected branches. It enforces exception rules that allow only hotfix or release artifacts to proceed while blocking non-critical updates during the freeze window.

What follow-up commands should I use after checking the freeze status?

After checking the freeze status, suggested follow-up commands include `/unfreeze` or `/hotfix` depending on the required action. These commands help manage the repository state after evaluating the freeze metadata.