# Artifact Hygiene Guard

> Enforce plan/report artifact placement in OPENCODE config directories and keep repo clean.

- Skill: `plevasseur/artifact-hygiene-guard` (Agent Skill)
- Install (CLI): `npx skillmds@latest add plevasseur/artifact-hygiene-guard`
- Raw SKILL.md: https://api.skillmd.com/api/skills/plevasseur/artifact-hygiene-guard/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- License: Apache-2.0
- Author: PLeVasseur (https://skillmd.com/u/plevasseur)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/plevasseur/artifact-hygiene-guard

---


## When to use

Use this skill whenever creating execution plans, validation notes, migration reports, or ad hoc investigation artifacts.

## Rules

- Plans must live in `$OPENCODE_CONFIG_DIR/plans/`.
- Reports must live in `$OPENCODE_CONFIG_DIR/reports/`.
- Do not create repo-local plan/report files by default.

## Workflow

1. Resolve config directory:
   - `printenv OPENCODE_CONFIG_DIR`
2. Write artifacts only under config dirs.
3. Before commit, run scope check:
   - `git diff --name-only --cached`
4. If repo-local artifacts were accidentally added, remove them before merge.

## Typical accidental files to reject

- `plans/*.md` in repo root
- root-level `*VALIDATION*.md`, `*REPORT*.md`, `*MIGRATION*.md`
- temporary smoke logs under tracked directories

## Report template

Always report:

1. Artifact file paths created under `$OPENCODE_CONFIG_DIR`
2. Confirmation that repo-local artifacts were not added (or were removed)