@libar-dev/architect 1.0.0-pre.3

package/docs-live/INDEX.md

@@ -0,0 +1,231 @@
+# Documentation Index
+
+**Purpose:** Navigate the full documentation set for @libar-dev/architect. Use section links for targeted reading.
+
+---
+
+## Package Metadata
+
+| Field             | Value                                                  |
+| ----------------- | ------------------------------------------------------ |
+| **Package**       | @libar-dev/architect                                   |
+| **Purpose**       | Context engineering platform for AI-assisted codebases |
+| **Patterns**      | 395 tracked (262 completed, 81 active, 52 planned)     |
+| **Product Areas** | 7                                                      |
+| **License**       | MIT                                                    |
+
+---
+
+## Quick Navigation
+
+| If you want to...              | Read this                                                       |
+| ------------------------------ | --------------------------------------------------------------- |
+| Learn the architecture         | [ARCHITECTURE.md](ARCHITECTURE.md)                              |
+| Browse product area overviews  | [PRODUCT-AREAS.md](PRODUCT-AREAS.md)                            |
+| Review architecture decisions  | [DECISIONS.md](DECISIONS.md)                                    |
+| Check business rules           | [BUSINESS-RULES.md](BUSINESS-RULES.md)                          |
+| Understand the tag taxonomy    | [TAXONOMY.md](TAXONOMY.md)                                      |
+| Check validation rules         | [VALIDATION-RULES.md](VALIDATION-RULES.md)                      |
+| Browse the changelog           | [CHANGELOG-GENERATED.md](CHANGELOG-GENERATED.md)                |
+| Query process state via CLI    | [Process API Reference](reference/PROCESS-API-REFERENCE.md)     |
+| Find CLI workflow recipes      | [Process API Recipes](reference/PROCESS-API-RECIPES.md)         |
+| Run AI coding sessions         | [Session Workflow Guide](reference/SESSION-WORKFLOW-GUIDE.md)   |
+| Enforce delivery process rules | [Process Guard Reference](reference/PROCESS-GUARD-REFERENCE.md) |
+| Learn annotation mechanics     | [Annotation Reference](reference/ANNOTATION-REFERENCE.md)       |
+| See codec patterns and options | [Architecture Codecs](reference/ARCHITECTURE-CODECS.md)         |
+| Understand MasterDataset types | [Architecture Types](reference/ARCHITECTURE-TYPES.md)           |
+
+---
+
+## Reading Order
+
+### Overview
+
+1. **[ARCHITECTURE.md](ARCHITECTURE.md)** -- Architecture diagram from source annotations
+2. **[PRODUCT-AREAS.md](PRODUCT-AREAS.md)** -- Product area overviews with live statistics and diagrams
+3. **[TAXONOMY.md](TAXONOMY.md)** -- Tag taxonomy configuration and format types
+
+### Deep Dive
+
+1. **[DECISIONS.md](DECISIONS.md)** -- Architecture Decision Records extracted from specs
+2. **[BUSINESS-RULES.md](BUSINESS-RULES.md)** -- Domain constraints and invariants from feature files
+3. **[VALIDATION-RULES.md](VALIDATION-RULES.md)** -- Process Guard validation rules and FSM reference
+
+### Reference Guides
+
+1. **[Annotation Reference](reference/ANNOTATION-REFERENCE.md)** -- Annotation mechanics and tag reference
+2. **[Session Workflow Guide](reference/SESSION-WORKFLOW-GUIDE.md)** -- Planning, Design, Implementation workflows
+3. **[Process API Reference](reference/PROCESS-API-REFERENCE.md)** -- CLI command reference with flags and examples
+4. **[Process Guard Reference](reference/PROCESS-GUARD-REFERENCE.md)** -- Pre-commit hooks, error codes, programmatic API
+
+---
+
+## Document Roles
+
+| Document                | Audience   | Focus                                            |
+| ----------------------- | ---------- | ------------------------------------------------ |
+| ARCHITECTURE.md         | Developers | Architecture diagram from source annotations     |
+| PRODUCT-AREAS.md        | Everyone   | Product area overviews with live statistics      |
+| DECISIONS.md            | Developers | Architecture Decision Records                    |
+| BUSINESS-RULES.md       | Developers | Domain constraints and invariants                |
+| TAXONOMY.md             | Reference  | Tag taxonomy structure and format types          |
+| VALIDATION-RULES.md     | CI/CD      | Process Guard validation rules and FSM reference |
+| CHANGELOG-GENERATED.md  | Everyone   | Project changelog from release specs             |
+| Annotation Reference    | Developers | Annotation mechanics, shape extraction           |
+| Session Workflow Guide  | AI/Devs    | Session decision trees and workflow checklists   |
+| Process API Reference   | AI/Devs    | CLI command reference with flags and examples    |
+| Process API Recipes     | AI/Devs    | CLI workflow recipes and session guides          |
+| Process Guard Reference | Team Leads | Pre-commit hooks, error codes, programmatic API  |
+| Architecture Codecs     | Developers | All codecs with factory patterns and options     |
+| Architecture Types      | Developers | MasterDataset interface and type shapes          |
+
+---
+
+## Key Concepts
+
+**Delivery Process** -- A code-first documentation and workflow toolkit. Extracts patterns from annotated TypeScript and Gherkin sources, generates markdown documentation, and validates delivery workflow via pre-commit hooks.
+
+**Pattern** -- An annotated unit of work tracked by the delivery process. Each pattern has a status (roadmap, active, completed, deferred), belongs to a product area, and has deliverables. Patterns are the atomic unit of the MasterDataset.
+
+**MasterDataset** -- The single read model (ADR-006) containing all extracted patterns with pre-computed views (byProductArea, byPhase, byStatus, byCategory). All codecs and the Data API consume this dataset.
+
+**Codec** -- A Zod-based transformer that decodes MasterDataset into a RenderableDocument. Each codec produces a specific document type. Codecs are pure functions with no I/O.
+
+**Dual-Source Architecture** -- Feature files own planning metadata (status, phase, dependencies). TypeScript files own implementation metadata (uses, used-by, category). This split prevents ownership conflicts.
+
+**Delivery Workflow FSM** -- A finite state machine enforcing pattern lifecycle: roadmap -> active -> completed. Transitions are validated by Process Guard at commit time.
+
+---
+
+## Document Inventory
+
+### Overview
+
+| Document                            | Description                                              | Audience   |
+| ----------------------------------- | -------------------------------------------------------- | ---------- |
+| [Architecture](ARCHITECTURE.md)     | Architecture diagram from source annotations             | Developers |
+| [Product Areas](PRODUCT-AREAS.md)   | Product area overviews with live statistics and diagrams | Everyone   |
+| [Taxonomy](TAXONOMY.md)             | Tag taxonomy configuration and format types              | Reference  |
+| [Changelog](CHANGELOG-GENERATED.md) | Project changelog from release specs                     | Everyone   |
+
+### Governance
+
+| Document                                | Description                                          | Audience   |
+| --------------------------------------- | ---------------------------------------------------- | ---------- |
+| [Decisions](DECISIONS.md)               | Architecture Decision Records extracted from specs   | Developers |
+| [Business Rules](BUSINESS-RULES.md)     | Domain constraints and invariants from feature files | Developers |
+| [Validation Rules](VALIDATION-RULES.md) | Process Guard validation rules and FSM reference     | CI/CD      |
+
+### Reference Guides
+
+| Document                                                        | Description                                                          | Audience   |
+| --------------------------------------------------------------- | -------------------------------------------------------------------- | ---------- |
+| [Annotation Reference](reference/ANNOTATION-REFERENCE.md)       | Annotation mechanics, shape extraction, tag reference                | Developers |
+| [Session Workflow Guide](reference/SESSION-WORKFLOW-GUIDE.md)   | Planning, Design, Implementation session workflows                   | AI/Devs    |
+| [Process API Reference](reference/PROCESS-API-REFERENCE.md)     | CLI command reference with flags and examples                        | AI/Devs    |
+| [Process API Recipes](reference/PROCESS-API-RECIPES.md)         | CLI workflow recipes and session guides                              | AI/Devs    |
+| [Process Guard Reference](reference/PROCESS-GUARD-REFERENCE.md) | Pre-commit hooks, error codes, programmatic API                      | Team Leads |
+| [Architecture Codecs](reference/ARCHITECTURE-CODECS.md)         | All codecs with factory patterns and options                         | Developers |
+| [Architecture Types](reference/ARCHITECTURE-TYPES.md)           | MasterDataset interface and type shapes                              | Developers |
+| [Configuration Guide](reference/CONFIGURATION-GUIDE.md)         | Presets, config files, sources, output, and monorepo setup           | Users      |
+| [Validation Tools Guide](reference/VALIDATION-TOOLS-GUIDE.md)   | lint-patterns, lint-steps, lint-process, validate-patterns reference | CI/CD      |
+| [Gherkin Authoring Guide](reference/GHERKIN-AUTHORING-GUIDE.md) | Roadmap specs, Rule blocks, DataTables, tag conventions              | Developers |
+
+### Product Area Details
+
+| Document                                        | Description                                        | Audience   |
+| ----------------------------------------------- | -------------------------------------------------- | ---------- |
+| [Annotation](product-areas/ANNOTATION.md)       | Annotation product area patterns and statistics    | Developers |
+| [Configuration](product-areas/CONFIGURATION.md) | Configuration product area patterns and statistics | Users      |
+| [Core Types](product-areas/CORE-TYPES.md)       | Core types product area patterns and statistics    | Developers |
+| [Data API](product-areas/DATA-API.md)           | Data API product area patterns and statistics      | AI/Devs    |
+| [Generation](product-areas/GENERATION.md)       | Generation product area patterns and statistics    | Developers |
+| [Process](product-areas/PROCESS.md)             | Process product area patterns and statistics       | Team Leads |
+| [Validation](product-areas/VALIDATION.md)       | Validation product area patterns and statistics    | CI/CD      |
+
+---
+
+## Product Area Statistics
+
+| Area          | Patterns | Completed | Active | Planned | Progress                   |
+| ------------- | -------- | --------- | ------ | ------- | -------------------------- |
+| Annotation    | 27       | 24        | 2      | 1       | [███████░] 24/27 89%       |
+| Configuration | 11       | 8         | 0      | 3       | [██████░░] 8/11 73%        |
+| CoreTypes     | 11       | 7         | 4      | 0       | [█████░░░] 7/11 64%        |
+| DataAPI       | 40       | 23        | 15     | 2       | [█████░░░] 23/40 57%       |
+| Generation    | 95       | 81        | 6      | 8       | [███████░] 81/95 85%       |
+| Process       | 11       | 4         | 0      | 7       | [███░░░░░] 4/11 36%        |
+| Validation    | 25       | 16        | 3      | 6       | [█████░░░] 16/25 64%       |
+| **Total**     | **220**  | **163**   | **30** | **27**  | **[██████░░] 163/220 74%** |
+
+---
+
+## Phase Progress
+
+**395** patterns total: **262** completed (66%), **81** active, **52** planned. [█████████████░░░░░░░] 262/395
+
+| Status    | Count | Percentage |
+| --------- | ----- | ---------- |
+| Completed | 262   | 66%        |
+| Active    | 81    | 21%        |
+| Planned   | 52    | 13%        |
+
+### By Phase
+
+| Phase     | Patterns | Completed | Progress |
+| --------- | -------- | --------- | -------- |
+| Phase 18  | 1        | 0         | 0%       |
+| Phase 23  | 2        | 2         | 100%     |
+| Phase 24  | 2        | 2         | 100%     |
+| Phase 25  | 10       | 8         | 80%      |
+| Phase 26  | 2        | 2         | 100%     |
+| Phase 27  | 3        | 3         | 100%     |
+| Phase 28  | 2        | 2         | 100%     |
+| Phase 30  | 1        | 1         | 100%     |
+| Phase 31  | 1        | 1         | 100%     |
+| Phase 32  | 1        | 1         | 100%     |
+| Phase 35  | 5        | 5         | 100%     |
+| Phase 36  | 1        | 1         | 100%     |
+| Phase 37  | 1        | 1         | 100%     |
+| Phase 38  | 1        | 1         | 100%     |
+| Phase 39  | 1        | 1         | 100%     |
+| Phase 40  | 1        | 1         | 100%     |
+| Phase 41  | 1        | 1         | 100%     |
+| Phase 42  | 1        | 1         | 100%     |
+| Phase 43  | 1        | 1         | 100%     |
+| Phase 44  | 2        | 2         | 100%     |
+| Phase 45  | 1        | 0         | 0%       |
+| Phase 46  | 2        | 0         | 0%       |
+| Phase 50  | 1        | 1         | 100%     |
+| Phase 51  | 1        | 1         | 100%     |
+| Phase 99  | 9        | 5         | 56%      |
+| Phase 100 | 16       | 4         | 25%      |
+| Phase 101 | 2        | 1         | 50%      |
+| Phase 102 | 1        | 0         | 0%       |
+| Phase 103 | 1        | 0         | 0%       |
+| Phase 104 | 1        | 0         | 0%       |
+
+---
+
+## Regeneration
+
+Regenerate all documentation from annotated sources:
+
+```bash
+pnpm docs:all          # Regenerate all generated docs
+pnpm docs:all-preview  # Also generate ephemeral workflow docs
+```
+
+Individual generators:
+
+```bash
+pnpm docs:product-areas         # Product area docs
+pnpm docs:decisions             # Architecture decisions
+pnpm docs:reference             # Reference documents
+pnpm docs:business-rules        # Business rules
+pnpm docs:taxonomy              # Taxonomy reference
+pnpm docs:validation            # Validation rules
+pnpm docs:claude-modules        # Claude context modules
+pnpm docs:process-api-reference # Process API CLI reference
+pnpm docs:cli-recipe            # CLI recipes & workflow guide
+```

package/docs-live/PRODUCT-AREAS.md

@@ -0,0 +1,255 @@
+# Product Areas
+
+**Purpose:** Product area overview index
+**Detail Level:** Full reference
+
+---
+
+## [Annotation](product-areas/ANNOTATION.md)
+
+> **How do I annotate code?**
+
+The annotation system is the ingestion boundary — it transforms annotated TypeScript and Gherkin files into `ExtractedPattern[]` objects that feed the entire downstream pipeline. Two parallel scanning paths (TypeScript AST + Gherkin parser) converge through dual-source merging. The system is fully data-driven: the `TagRegistry` defines all tags, formats, and categories — adding a new annotation requires only a registry entry, zero parser changes.
+
+**27 patterns** — 24 completed, 2 active, 1 planned
+
+**Key patterns:** PatternRelationshipModel, ShapeExtraction, DualSourceExtraction, GherkinRulesSupport, DeclarationLevelShapeTagging, CrossSourceValidation, ExtractionPipelineEnhancementsTesting
+
+## [Configuration](product-areas/CONFIGURATION.md)
+
+> **How do I configure the tool?**
+
+Configuration is the entry boundary — it transforms a user-authored `architect.config.ts` file into a fully resolved `ArchitectInstance` that powers the entire pipeline. The flow is: `defineConfig()` provides type-safe authoring (Vite convention, zero validation), `ConfigLoader` discovers and loads the file, `ProjectConfigSchema` validates via Zod, `ConfigResolver` applies defaults and merges stubs into sources, and `ArchitectFactory` builds the final instance with `TagRegistry` and `RegexBuilders`. Two presets define escalating taxonomy complexity — from 3 categories (`libar-generic`) to 21 (`ddd-es-cqrs`). `SourceMerger` computes per-generator source overrides, enabling generators like changelog to pull from different feature sets than the base config.
+
+**11 patterns** — 8 completed, 0 active, 3 planned
+
+**Key patterns:** ArchitectFactory, ConfigLoader, ConfigResolver, DefineConfig, ConfigurationPresets, SourceMerger
+
+## [Generation](product-areas/GENERATION.md)
+
+> **How does code become docs?**
+
+The generation pipeline transforms annotated source code into markdown documents through a four-stage architecture: Scanner discovers files, Extractor produces `ExtractedPattern` objects, Transformer builds MasterDataset with pre-computed views, and Codecs render to markdown via RenderableDocument IR. Nine specialized codecs handle reference docs, planning, session, reporting, timeline, ADRs, business rules, taxonomy, and composite output — each supporting three detail levels (detailed, standard, summary). The Orchestrator runs generators in registration order, producing both detailed `docs-live/` references and compact `_claude-md/` summaries.
+
+**95 patterns** — 81 completed, 6 active, 8 planned
+
+**Key patterns:** ADR005CodecBasedMarkdownRendering, CodecDrivenReferenceGeneration, CrossCuttingDocumentInclusion, ArchitectureDiagramGeneration, ScopedArchitecturalView, CompositeCodec, RenderableDocument, ProductAreaOverview
+
+## [Validation](product-areas/VALIDATION.md)
+
+> **How is the workflow enforced?**
+
+Validation is the enforcement boundary — it ensures that every change to annotated source files respects the delivery lifecycle rules defined by the FSM, protection levels, and scope constraints. The system operates in three layers: the FSM validator checks status transitions against a 4-state directed graph, the Process Guard orchestrates commit-time validation using a Decider pattern (state derived from annotations, not stored separately), and the lint engine provides pluggable rule execution with pretty and JSON output. Anti-pattern detection enforces dual-source ownership boundaries — `@architect-uses` belongs on TypeScript, `@architect-depends-on` belongs on Gherkin — preventing cross-domain tag confusion that causes documentation drift. Definition of Done validation ensures completed patterns have all deliverables marked done and at least one acceptance-criteria scenario.
+
+**25 patterns** — 16 completed, 3 active, 6 planned
+
+**Key patterns:** ProcessGuardLinter, PhaseStateMachineValidation, DoDValidation, StepLintVitestCucumber, ProgressiveGovernance
+
+## [DataAPI](product-areas/DATA-API.md)
+
+> **How do I query process state?**
+
+The Data API provides direct terminal access to project state. It replaces reading generated markdown or launching explore agents — targeted queries use 5-10x less context. The `context` command assembles curated bundles tailored to session type (planning, design, implement).
+
+**40 patterns** — 23 completed, 15 active, 2 planned
+
+**Key patterns:** DataAPIContextAssembly, ProcessStateAPICLI, DataAPIDesignSessionSupport, DataAPIRelationshipGraph, DataAPIOutputShaping
+
+## [CoreTypes](product-areas/CORE-TYPES.md)
+
+> **What foundational types exist?**
+
+CoreTypes provides the foundational type system used across all other areas. Three pillars enforce discipline at compile time: the Result monad replaces try/catch with explicit error handling — functions return `Result.ok(value)` or `Result.err(error)` instead of throwing. The DocError discriminated union provides structured error context with type, file, line, and reason fields, enabling exhaustive pattern matching in error handlers. Branded types create nominal typing from structural TypeScript — `PatternId`, `CategoryName`, and `SourceFilePath` are compile-time distinct despite all being strings. String utilities handle slugification and case conversion with acronym-aware title casing.
+
+**11 patterns** — 7 completed, 4 active, 0 planned
+
+**Key patterns:** ResultMonad, ErrorHandlingUnification, ErrorFactories, StringUtils, KebabCaseSlugs
+
+## [Process](product-areas/PROCESS.md)
+
+> **How does the session workflow work?**
+
+Process defines the USDP-inspired session workflow that governs how work moves through the delivery lifecycle. Three session types (planning, design, implementation) have fixed input/output contracts: planning creates roadmap specs from pattern briefs, design produces code stubs and decision records, and implementation writes code against scope-locked specs. Git is the event store — documentation artifacts are projections of annotated source code, not hand-maintained files. The FSM enforces state transitions (roadmap → active → completed) with escalating protection levels, while handoff templates preserve context across LLM session boundaries. ADR-003 established that TypeScript source owns pattern identity; tier 1 specs are ephemeral planning documents that lose value after completion.
+
+**11 patterns** — 4 completed, 0 active, 7 planned
+
+**Key patterns:** ADR001TaxonomyCanonicalValues, ADR003SourceFirstPatternArchitecture, MvpWorkflowImplementation, SessionHandoffs
+
+---
+
+## Progress Overview
+
+| Area                                            | Patterns | Completed | Active | Planned |
+| ----------------------------------------------- | -------- | --------- | ------ | ------- |
+| [Annotation](product-areas/ANNOTATION.md)       | 27       | 24        | 2      | 1       |
+| [Configuration](product-areas/CONFIGURATION.md) | 11       | 8         | 0      | 3       |
+| [Generation](product-areas/GENERATION.md)       | 95       | 81        | 6      | 8       |
+| [Validation](product-areas/VALIDATION.md)       | 25       | 16        | 3      | 6       |
+| [DataAPI](product-areas/DATA-API.md)            | 40       | 23        | 15     | 2       |
+| [CoreTypes](product-areas/CORE-TYPES.md)        | 11       | 7         | 4      | 0       |
+| [Process](product-areas/PROCESS.md)             | 11       | 4         | 0      | 7       |
+| **Total**                                       | **220**  | **163**   | **30** | **27**  |
+
+---
+
+## System Architecture
+
+Scoped architecture diagram showing component relationships:
+
+```mermaid
+C4Context
+    title System Architecture
+    Boundary(config, "Config") {
+        System(ConfigResolver, "ConfigResolver")
+        System(ConfigurationPresets, "ConfigurationPresets")
+        System(SourceMerger, "SourceMerger")
+        System(ArchitectFactory, "ArchitectFactory")
+        System(DefineConfig, "DefineConfig")
+        System(ConfigLoader, "ConfigLoader")
+    }
+    Boundary(renderer, "Renderer") {
+        System(CompositeCodec, "CompositeCodec")
+    }
+    System(ADR003SourceFirstPatternArchitecture, "ADR003SourceFirstPatternArchitecture")
+    System(ADR001TaxonomyCanonicalValues, "ADR001TaxonomyCanonicalValues")
+    System(ShapeExtraction, "ShapeExtraction")
+    System(ScopedArchitecturalView, "ScopedArchitecturalView")
+    System(DeclarationLevelShapeTagging, "DeclarationLevelShapeTagging")
+    System(DataAPIDesignSessionSupport, "DataAPIDesignSessionSupport")
+    System(DataAPIOutputShaping, "DataAPIOutputShaping")
+    System(DataAPIContextAssembly, "DataAPIContextAssembly")
+    System(CrossCuttingDocumentInclusion, "CrossCuttingDocumentInclusion")
+    System(CodecDrivenReferenceGeneration, "CodecDrivenReferenceGeneration")
+    System(StringUtils, "StringUtils")
+    System(ResultMonad, "ResultMonad")
+    System(ErrorFactories, "ErrorFactories")
+    System(ExtractionPipelineEnhancementsTesting, "ExtractionPipelineEnhancementsTesting")
+    System(KebabCaseSlugs, "KebabCaseSlugs")
+    System(ErrorHandlingUnification, "ErrorHandlingUnification")
+    System_Ext(ConfigurationTypes, "ConfigurationTypes")
+    System_Ext(RegexBuilders, "RegexBuilders")
+    System_Ext(ProjectConfigTypes, "ProjectConfigTypes")
+    System_Ext(ConfigurationDefaults, "ConfigurationDefaults")
+    System_Ext(ReferenceDocShowcase, "ReferenceDocShowcase")
+    System_Ext(DocGenerationProofOfConcept, "DocGenerationProofOfConcept")
+    System_Ext(DataAPIStubIntegration, "DataAPIStubIntegration")
+    Rel(ConfigResolver, ProjectConfigTypes, "uses")
+    Rel(ConfigResolver, ArchitectFactory, "uses")
+    Rel(ConfigResolver, ConfigurationDefaults, "uses")
+    Rel(ConfigurationPresets, ConfigurationTypes, "uses")
+    Rel(SourceMerger, ProjectConfigTypes, "uses")
+    Rel(ArchitectFactory, ConfigurationTypes, "uses")
+    Rel(ArchitectFactory, ConfigurationPresets, "uses")
+    Rel(ArchitectFactory, RegexBuilders, "uses")
+    Rel(DefineConfig, ProjectConfigTypes, "uses")
+    Rel(ConfigLoader, ArchitectFactory, "uses")
+    Rel(ConfigLoader, ConfigurationTypes, "uses")
+    Rel(CompositeCodec, ReferenceDocShowcase, "implements")
+    Rel(ADR003SourceFirstPatternArchitecture, ADR001TaxonomyCanonicalValues, "depends on")
+    Rel(ScopedArchitecturalView, ShapeExtraction, "depends on")
+    Rel(DeclarationLevelShapeTagging, ShapeExtraction, "depends on")
+    Rel(DeclarationLevelShapeTagging, ReferenceDocShowcase, "depends on")
+    Rel(DataAPIDesignSessionSupport, DataAPIContextAssembly, "depends on")
+    Rel(DataAPIDesignSessionSupport, DataAPIStubIntegration, "depends on")
+    Rel(DataAPIContextAssembly, DataAPIOutputShaping, "depends on")
+    Rel(DataAPIContextAssembly, DataAPIStubIntegration, "depends on")
+    Rel(CrossCuttingDocumentInclusion, DeclarationLevelShapeTagging, "depends on")
+    Rel(CrossCuttingDocumentInclusion, ReferenceDocShowcase, "depends on")
+    Rel(CodecDrivenReferenceGeneration, DocGenerationProofOfConcept, "depends on")
+    Rel(CodecDrivenReferenceGeneration, ScopedArchitecturalView, "depends on")
+    Rel(ExtractionPipelineEnhancementsTesting, ReferenceDocShowcase, "implements")
+    Rel(KebabCaseSlugs, StringUtils, "depends on")
+    Rel(ErrorHandlingUnification, ResultMonad, "depends on")
+    Rel(ErrorHandlingUnification, ErrorFactories, "depends on")
+    Rel(RegexBuilders, ConfigurationTypes, "uses")
+    Rel(ProjectConfigTypes, ConfigurationTypes, "uses")
+    Rel(ProjectConfigTypes, ConfigurationPresets, "uses")
+    Rel(ReferenceDocShowcase, CodecDrivenReferenceGeneration, "depends on")
+    Rel(ReferenceDocShowcase, ScopedArchitecturalView, "depends on")
+    Rel(ReferenceDocShowcase, ShapeExtraction, "depends on")
+    Rel(DocGenerationProofOfConcept, ShapeExtraction, "depends on")
+```
+
+---
+
+## Cross-Area Pattern Relationships
+
+Scoped architecture diagram showing component relationships:
+
+```mermaid
+graph LR
+    subgraph config["Config"]
+        ConfigResolver("ConfigResolver")
+        ConfigurationPresets["ConfigurationPresets"]
+        SourceMerger("SourceMerger")
+        ArchitectFactory("ArchitectFactory")
+        DefineConfig[/"DefineConfig"/]
+        ConfigLoader[/"ConfigLoader"/]
+    end
+    subgraph renderer["Renderer"]
+        CompositeCodec[("CompositeCodec")]
+    end
+    ADR003SourceFirstPatternArchitecture["ADR003SourceFirstPatternArchitecture"]
+    ADR001TaxonomyCanonicalValues["ADR001TaxonomyCanonicalValues"]
+    ShapeExtraction["ShapeExtraction"]
+    ScopedArchitecturalView["ScopedArchitecturalView"]
+    DeclarationLevelShapeTagging["DeclarationLevelShapeTagging"]
+    DataAPIDesignSessionSupport["DataAPIDesignSessionSupport"]
+    DataAPIOutputShaping["DataAPIOutputShaping"]
+    DataAPIContextAssembly["DataAPIContextAssembly"]
+    CrossCuttingDocumentInclusion["CrossCuttingDocumentInclusion"]
+    CodecDrivenReferenceGeneration["CodecDrivenReferenceGeneration"]
+    StringUtils["StringUtils"]
+    ResultMonad["ResultMonad"]
+    ErrorFactories["ErrorFactories"]
+    ExtractionPipelineEnhancementsTesting["ExtractionPipelineEnhancementsTesting"]
+    KebabCaseSlugs["KebabCaseSlugs"]
+    ErrorHandlingUnification["ErrorHandlingUnification"]
+    subgraph related["Related"]
+        ConfigurationTypes["ConfigurationTypes"]:::neighbor
+        RegexBuilders["RegexBuilders"]:::neighbor
+        ProjectConfigTypes["ProjectConfigTypes"]:::neighbor
+        ConfigurationDefaults["ConfigurationDefaults"]:::neighbor
+        ReferenceDocShowcase["ReferenceDocShowcase"]:::neighbor
+        DocGenerationProofOfConcept["DocGenerationProofOfConcept"]:::neighbor
+        DataAPIStubIntegration["DataAPIStubIntegration"]:::neighbor
+    end
+    ConfigResolver -->|uses| ProjectConfigTypes
+    ConfigResolver -->|uses| ArchitectFactory
+    ConfigResolver -->|uses| ConfigurationDefaults
+    ConfigurationPresets -->|uses| ConfigurationTypes
+    SourceMerger -->|uses| ProjectConfigTypes
+    ArchitectFactory -->|uses| ConfigurationTypes
+    ArchitectFactory -->|uses| ConfigurationPresets
+    ArchitectFactory -->|uses| RegexBuilders
+    DefineConfig -->|uses| ProjectConfigTypes
+    ConfigLoader -->|uses| ArchitectFactory
+    ConfigLoader -->|uses| ConfigurationTypes
+    CompositeCodec ..->|implements| ReferenceDocShowcase
+    ADR003SourceFirstPatternArchitecture -.->|depends on| ADR001TaxonomyCanonicalValues
+    ScopedArchitecturalView -.->|depends on| ShapeExtraction
+    DeclarationLevelShapeTagging -.->|depends on| ShapeExtraction
+    DeclarationLevelShapeTagging -.->|depends on| ReferenceDocShowcase
+    DataAPIDesignSessionSupport -.->|depends on| DataAPIContextAssembly
+    DataAPIDesignSessionSupport -.->|depends on| DataAPIStubIntegration
+    DataAPIContextAssembly -.->|depends on| DataAPIOutputShaping
+    DataAPIContextAssembly -.->|depends on| DataAPIStubIntegration
+    CrossCuttingDocumentInclusion -.->|depends on| DeclarationLevelShapeTagging
+    CrossCuttingDocumentInclusion -.->|depends on| ReferenceDocShowcase
+    CodecDrivenReferenceGeneration -.->|depends on| DocGenerationProofOfConcept
+    CodecDrivenReferenceGeneration -.->|depends on| ScopedArchitecturalView
+    ExtractionPipelineEnhancementsTesting ..->|implements| ReferenceDocShowcase
+    KebabCaseSlugs -.->|depends on| StringUtils
+    ErrorHandlingUnification -.->|depends on| ResultMonad
+    ErrorHandlingUnification -.->|depends on| ErrorFactories
+    RegexBuilders -->|uses| ConfigurationTypes
+    ProjectConfigTypes -->|uses| ConfigurationTypes
+    ProjectConfigTypes -->|uses| ConfigurationPresets
+    ReferenceDocShowcase -.->|depends on| CodecDrivenReferenceGeneration
+    ReferenceDocShowcase -.->|depends on| ScopedArchitecturalView
+    ReferenceDocShowcase -.->|depends on| ShapeExtraction
+    DocGenerationProofOfConcept -.->|depends on| ShapeExtraction
+    classDef neighbor stroke-dasharray: 5 5
+```
+
+---