project-flow-guard

Manages project versioning and artifact tracking for Codex development using Python scripts.

2|Updated May 7, 2026
One-click install
npx skills add https://github.com/Teng-bio/codex-skills-hub --skill project-flow-guard
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: project-flow-guard
Source: https://github.com/Teng-bio/codex-skills-hub/tree/main/skills/global/project-flow-guard
Command: npx skills add https://github.com/Teng-bio/codex-skills-hub --skill project-flow-guard

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill helps prevent version confusion during Codex development by managing project versions, ensuring that outputs and artifacts are properly documented and tracked.

Core Features & Use Cases

  • Version Control: Manage project versions and outputs, preventing confusion and ensuring that the correct versions are used.
  • Task Classification: Classify tasks such as source edits, artifact runs, and promotion to ensure proper handling.
  • Run Lifecycle: Manage the lifecycle of runs, including starting, closing, and promoting outputs.
  • Branch and Baseline Management: Create and manage branches and baselines for long-lived work and snapshots of project states.
  • Cleanup and Organization: Organize project files and remove outdated versions.

Quick Start

Initialize the project flow guard by running 'project_flow_guard.py init --root .'

Frequently Asked Questions about project-flow-guard

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

FAQPage Schema
How do I manage project versions and artifact tracking during Codex development?

You can manage the run lifecycle by classifying artifact runs, starting execution, and promoting outputs. This tracks artifacts across project versions, ensuring correct outputs are documented and preventing confusion during Codex development.

What is the best way to organize project files and clean up outdated versions in a development workflow?

The best way to organize project files and clean up outdated versions is by sealing baselines and branching. This manages long-lived work and snapshots of project states, ensuring outdated versions are safely removed and properly documented.

How do I initialize a version control workflow for a new development project?

You initialize the project flow guard by running the initialization script with your root directory. This sets up the required project structure to classify source edits, artifact runs, and promotion tasks for proper version handling.

Does project flow management require specific dependencies or a Python environment?

Project flow management requires a Python environment for script execution and file operations. It does not list external dependencies, but it requires proper user input and an existing project structure to function correctly.

When should I create branches and seal baselines for long-lived work?

You should create branches and seal baselines when you need to snapshot project states or manage long-lived work. This ensures proper artifact tracking and prevents version confusion when handling concurrent development tasks.