# IG Authoring Pattern Language

> Schema-aligned pattern language for authoring HL7® FHIR® Implementation Guides with disciplined repository layout, naming, ADR governance, example placement, FSH usage, reuse/co-authoring across IGs, and robust staging/versioning/CI for GitHub and GitLab.

This is an AI agent discovery file for the **IG Authoring Pattern Language** at https://fhir-implementation-patterns-book-85f5e8.gitlab.io/ig-authoring-patterns/

## Machine-Readable Resources

- **Content index** (llms.txt): https://fhir-implementation-patterns-book-85f5e8.gitlab.io/ig-authoring-patterns/llms.txt
- **Full content export** (all patterns): https://fhir-implementation-patterns-book-85f5e8.gitlab.io/ig-authoring-patterns/llms-full.txt

## Content Structure

This site is a pattern language — a navigable network of named, structured patterns. Each pattern documents a recurring problem, the forces shaping its solution, the solution itself, consequences, and related patterns.

### Pattern Categories
- **Repository & Naming**: https://fhir-implementation-patterns-book-85f5e8.gitlab.io/ig-authoring-patterns/patterns/repository-and-naming/
- **Documentation & ADRs**: https://fhir-implementation-patterns-book-85f5e8.gitlab.io/ig-authoring-patterns/patterns/documentation-and-adrs/
- **FSH Authoring**: https://fhir-implementation-patterns-book-85f5e8.gitlab.io/ig-authoring-patterns/patterns/fsh-authoring/
- **Reuse & Co-authoring**: https://fhir-implementation-patterns-book-85f5e8.gitlab.io/ig-authoring-patterns/patterns/reuse-and-coauthoring/
- **Staging, Versioning & CI**: https://fhir-implementation-patterns-book-85f5e8.gitlab.io/ig-authoring-patterns/patterns/staging-versioning-ci/
- **Collaboration & Issues**: https://fhir-implementation-patterns-book-85f5e8.gitlab.io/ig-authoring-patterns/patterns/collaboration-and-issues/

### Key Sections

- **Home**: https://fhir-implementation-patterns-book-85f5e8.gitlab.io/ig-authoring-patterns/
- **Pattern Catalog**: https://fhir-implementation-patterns-book-85f5e8.gitlab.io/ig-authoring-patterns/introduction/pattern-catalog/
- **Forces Analysis**: https://fhir-implementation-patterns-book-85f5e8.gitlab.io/ig-authoring-patterns/introduction/forces-analysis/
- **Co-Usage Map**: https://fhir-implementation-patterns-book-85f5e8.gitlab.io/ig-authoring-patterns/reference/co-usage-map/
- **Implementation Approach**: https://fhir-implementation-patterns-book-85f5e8.gitlab.io/ig-authoring-patterns/reference/implementation-approach/
- **Standards & References**: https://fhir-implementation-patterns-book-85f5e8.gitlab.io/ig-authoring-patterns/reference/standards/

## Target Audience

- **IG Lead**: Owns scope, quality bar, and release train
- **FHIR Engineer**: Authors profiles, invariants, examples, and pipelines
- **Terminology Steward**: Owns CodeSystems, ValueSets, ConceptMaps
- **Clinical SME**: Provides clinical intent and validates usability
- **Implementer**: Consumes the IG and reports integration feedback
- **QA/Conformance**: Owns test strategy and cross-IG verification

## Usage Guidance

- Use `llms.txt` for a concise page index with descriptions suitable for retrieval
- Use `llms-full.txt` for the complete text of all patterns in a single document
- Individual pattern pages are at `https://fhir-implementation-patterns-book-85f5e8.gitlab.io/ig-authoring-patterns/patterns/{pattern-id}/`
- Pattern pages are self-contained and cross-link to related patterns

## Permissions

This content is freely accessible. No authentication is required. Crawling and indexing are welcome.