Quick Rules

Folder name: planNNN-short-description.
Plan files: planNNN-prompt.md, planNNN-draft.md, planNNN.md.
Plans use frontmatter type: plan + description (prompt stage frontmatter is optional).
Task files under tasks/ are named taskNNN-NN-short-name.md and use frontmatter type: task + description.
Timestamps in body must use YYYY-MM-DDTHH:MM:SS+HH:MM.
Draft stage is intent-only: no concrete ## Tasks checklist.
Active plan is executable: includes task checklist + acceptance criteria.

Authoring Checklist

Use this skill when working with CatHerder plan folders.

Detailed rules live in references/; this file is a compact index + checklist.

Folder name: planNNN-short-description.
Plan files: planNNN-prompt.md, planNNN-draft.md, planNNN.md.
Plans use frontmatter type: plan + description (prompt stage frontmatter is optional).
Task files under tasks/ are named taskNNN-NN-short-name.md and use frontmatter type: task + description.
Timestamps in body must use YYYY-MM-DDTHH:MM:SS+HH:MM.
Draft stage is intent-only: no concrete ## Tasks checklist.
Active plan is executable: includes task checklist + acceptance criteria.

Script	Purpose	Usage	Exit Codes	Dependencies / Notes
`scripts/validate.sh`	Run `validate.py` via the workspace venv. Report-only; does not modify files.	`bash scripts/validate.sh path/to/planNNN-…`	0=clean 1=issues-found 2=usage-error	Prefers `../../../../.venv/bin/python`; falls back to `python3`.
`scripts/validate.py`	Validate plan folder structure, frontmatter, status, timestamps, and task files. Emits JSON with `error`/`warning` severities.	`python scripts/validate.py path/to/planNNN-…`	0=clean 1=issues-found 2=usage-or-config-error	Requires `python-frontmatter>=1.1.0`.