discover-document-norms
Installation
SKILL.md
Skill: Discover Document Norms
Purpose
Help users define their project-specific artifact norms (paths, naming, lifecycle) for document governance. Projects may have their own documentation structure; this skill discovers and formalizes it so other skills (capture-work-items, brainstorm-design, assess-doc-readiness) can follow project norms.
Core Objective
Primary Goal: Produce docs/ARTIFACT_NORMS.md (and optionally .ai-cortex/artifact-norms.yaml) that declares the project's artifact paths, naming, and lifecycle for backlog, design, ADR, and calibration artifacts.
Success Criteria (ALL must be met):
- ✅ Project structure scanned: Existing
docs/structure and conventions inspected - ✅ User preferences confirmed: Paths for backlog, design, adr, doc-readiness confirmed via dialogue (or accepted from starting template)
- ✅ ARTIFACT_NORMS.md written: Human-readable norms file at
docs/ARTIFACT_NORMS.md - ✅ Optional YAML created: If user requests,
.ai-cortex/artifact-norms.yamlwritten with machine-readable schema - ✅ User confirmed: User explicitly approved the norms before final write