workspace-hygiene-and-git-discipline

Route agent artifacts outside the parent repo and enforce git discipline.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/shichiyou/hermes-agent-001 --skill workspace-hygiene-and-git-discipline
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: workspace-hygiene-and-git-discipline
Source: https://github.com/shichiyou/hermes-agent-001/tree/main/.devcontainer/hermes-backup/skills/devops/workspace-hygiene-and-git-discipline
Command: npx skills add https://github.com/shichiyou/hermes-agent-001 --skill workspace-hygiene-and-git-discipline

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Routing agent-generated artifacts outside the parent repo while enforcing git discipline to prevent pollution, misalignment, and hidden drift, and ensuring reliable CI/tool evaluation without impacting main code.

Core Features & Use Cases

  • Artifact routing: direct agent outputs to safe locations outside the parent repo.
  • Submodule integrity: safe alignment, detached-head recovery, and pointer synchronization to keep parent references accurate.
  • Pre-commit discipline: automated checks to prevent accidental commits of artifacts and policy violations.

Quick Start

Run the artifact routing and submodule alignment procedures to validate a clean parent repository state.

Frequently Asked Questions about workspace-hygiene-and-git-discipline

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

FAQPage Schema
How do I route agent artifacts outside the parent git repository?

To route agent artifacts outside the parent git repository, you direct agent-generated outputs to safe external locations. This prevents repository pollution and ensures clean CI workflows without impacting main code.

How do I fix a detached HEAD state in git submodules?

Fixing a detached HEAD state in git submodules requires performing detached-head recovery and submodule pointer synchronization. This realigns submodule references to keep parent repository pointers accurate and prevent hidden drift.

What is the best way to prevent accidental commits of build artifacts in a monorepo?

The best way to prevent accidental commits of build artifacts in a monorepo is applying pre-commit discipline. Automated validation checks intercept policy violations and artifact leakage before they enter the main codebase.

Does this workspace cleanup approach work with CI-CD workflows?

Yes, this workspace cleanup approach works with CI-CD workflows. It enforces safe git discipline to prevent submodule drift and artifact leakage, ensuring reliable CI tool evaluation and reproducibility without impacting main code.

Why does submodule drift threaten reproducibility in monorepos?

Submodule drift threatens reproducibility in monorepos because parent references become inaccurate when submodule pointers are misaligned. Safe alignment and pointer synchronization are required to maintain repository integrity and reliable builds.

When should I run pre-commit validation for submodule alignment?

Run pre-commit validation for submodule alignment before finalizing any changes to the parent repository. This enforces safe git discipline, catches detached HEAD states early, and ensures artifact routing rules are strictly followed.