julien-ref-doc-production

This Skill standardizes documentation production by enforcing consistent folder structure, naming conventions, and YAML metadata headers across eight document types: GUIDE, INCIDENT, SESSION, AUDIT, RECHERCHE, RECOMMANDATIONS, MIGRATION, PERFORMANCE, and SECURITE. Apply DRY principles with cross-referenced living documents to maintain single sources of truth.

Each document requires a complete YAML header containing title, version, created, updated, authors, audience, level, status, tags, and related fields. This metadata enables versioning, author tracking, audience targeting, and cross-file references while supporting event-based workflows that evolve with your documentation.

Structure documents in a defined folder hierarchy with consistent naming conventions and establish cross-references between files. A references directory holds in-depth docs while progressive disclosure keeps primary documents lean, eliminating redundancy and reducing maintenance burden across your doc system.

Yes. The Skill supports eight specialized document types designed for distinct contexts: INCIDENT captures events, SECURITE addresses security, PERFORMANCE covers optimization, MIGRATION documents transitions, and others. Each type uses the same YAML structure and naming conventions, enabling scalable documentation across varied project needs.

Living documentation evolves with your project through event-based workflows tracked via YAML metadata. Version, updated, and status fields capture change history automatically. Static docs become outdated; living docs stay current by design, reducing staleness and keeping guidance actionable.

No. Begin by creating a new guide under docs/ and add YAML metadata at the top. The Skill provides the structure and conventions to apply incrementally—start with one document type and expand as your documentation grows, applying DRY and metadata consistency from the start.