artifact-conventions

Enforce preservation, format, and section conventions for spec artifacts.

Updated Mar 22, 2026
One-click install
npx skills add https://github.com/patrickrmoore/sdd-test --skill artifact-conventions
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: artifact-conventions
Source: https://github.com/patrickrmoore/sdd-test/tree/main/.github/skills/artifact-conventions
Command: npx skills add https://github.com/patrickrmoore/sdd-test --skill artifact-conventions

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Defines preservation, format, and section rules for SDD specification artifacts (spec.md, plan.md, tasks.md, checklists). Use when editing feature-artifact files under specs/<feature-folder>/ to prevent accidental corruption of cross-referenced IDs, priorities, and gating state.

Core Features & Use Cases

  • Enforces consistent frontmatter structure and required sections in spec-related artifacts.
  • Guards cross-artifact references, IDs, and gating state to maintain traceability.
  • Applies to files under specs/<feature-folder>/ to ensure governance and consistency across the feature workspace.

Quick Start

Edit artifact files under specs/<feature-folder>/ to automatically apply the conventions.

Frequently Asked Questions about artifact-conventions

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

FAQPage Schema
How do I maintain cross-artifact traceability when editing spec files?▼

To maintain cross-artifact traceability when editing spec files, enforce preservation rules for cross-referenced IDs, priorities, and gating state to prevent accidental corruption of linked artifacts during edits.

What are frontmatter validation rules for spec and plan artifacts?▼

Frontmatter validation rules for spec and plan artifacts require consistent frontmatter structure and specific section presence to ensure artifact integrity and governance across the feature workspace.

How do I prevent accidental changes to gating state in feature specs?▼

Preventing accidental changes to gating state in feature specs requires enforcing non-destructive edits and preservation conventions, protecting critical cross-referenced state values from being overwritten during routine artifact updates.

When do I need specification governance conventions for feature artifacts?▼

You need specification governance conventions for feature artifacts when editing files under specs/<feature-folder>/ to prevent changes to IDs, priorities, and gating state, ensuring consistency and traceability across the feature workspace.

Does artifact convention enforcement work with existing spec.md and plan.md files?▼

Artifact convention enforcement works with existing spec.md and plan.md files by applying preservation, format, and section rules automatically when editing, guarding cross-artifact references without requiring file migration.