Pattern Index

Consolidated from pattern-catalog.md and PATTERN-INDEX.md Format: ADR-style numbered patterns

Total Patterns: 60 patterns (001-059) + template (000)

Pattern Categories

Core Architecture Patterns

Foundational patterns for system architecture and infrastructure

Pattern-001: Repository Pattern - Data access encapsulation
Pattern-002: Service Pattern - Business logic organization
Pattern-003: Factory Pattern - Object creation abstraction
Pattern-004: CQRS-lite Pattern - Command/query separation
Pattern-005: Transaction Management - Data consistency
Pattern-007: Async Error Handling - Error propagation
Pattern-008: DDD Service Layer - Domain organization
Pattern-014: Error Handling API Contract - API error contracts
Pattern-015: Internal Task Handler - Task processing patterns
Pattern-017: Background Task Error Handling - Async error management
Pattern-034: Error Handling Standards - REST-compliant HTTP status codes and error responses

Data & Query Patterns

Data access, session management, and query abstraction patterns

Pattern-013: Session Management - Database session handling
Pattern-016: Repository Context Enrichment - Context-aware data access
Pattern-023: Query Layer Patterns - Query abstraction layers
Pattern-025: Canonical Query Extension - Query extension patterns
Pattern-026: Cross-Feature Learning - Feature learning integration

AI & Intelligence Patterns

AI coordination, spatial intelligence, and language model integration patterns

Pattern-012: LLM Adapter - Language model integration
Pattern-019: LLM Placeholder Instruction - AI instruction patterns
Pattern-020: Spatial Metaphor Integration - Spatial AI context
Pattern-022: MCP+Spatial Intelligence Integration - MCP spatial patterns
Pattern-028: Intent Classification - Natural language intent routing
Pattern-029: Multi-Agent Coordination - Specialized agent orchestration
Pattern-032: Intent Pattern Catalog - Regex pattern management for intent classification
- 44 total patterns across TEMPORAL (17), STATUS (14), PRIORITY (13)
- 92% canonical query coverage achieved (Phase 3 expansion)

Integration & Platform Patterns

External system integration, plugin architecture, and platform connectivity patterns

Pattern-018: Configuration Access - Configuration management
Pattern-027: CLI Integration - Command-line interface patterns
Pattern-030: Plugin Interface - Extensible integration architecture
Pattern-031: Plugin Wrapper - Adapter pattern for integration routers
Pattern-033: Notion Publishing - Knowledge management publishing
Pattern-035: MCP Adapter Methods - Backward-compatible MCP migration pattern (ADR-013 Phase 2)
Pattern-040: Integration Swappability Guide - Router pattern for pluggable provider implementations

Infrastructure & Scheduling Patterns

Background job execution, periodic tasks, and infrastructure coordination patterns

Pattern-048: Periodic Background Job - Lightweight asyncio-based periodic task execution with responsive shutdown

Development & Process Patterns

Development methodology, quality assurance, and workflow management patterns

Pattern-006: Verification-First - Methodology approach
Pattern-009: GitHub Issue Tracking - Process management
Pattern-010: Cross-Validation Protocol - Quality assurance
Pattern-011: Context Resolution - Implicit context resolution
Pattern-021: Development Session Management - Dev workflow sessions
Pattern-024: Methodology Patterns - Development methodology patterns
Pattern-036: Signal Convergence - Multi-analyzer breakthrough detection (META-PATTERN)
Pattern-037: Cross-Context Validation - Concept validation across contexts (META-PATTERN)
Pattern-038: Temporal Clustering - Coordination analysis via temporal grouping (META-PATTERN)
Pattern-039: Feature Prioritization Scorecard - Quantified feature prioritization framework
Pattern-041: Systematic Fix Planning - Phase-based approach to multi-issue resolution
Pattern-042: Investigation-Only Protocol - Separation of bug investigation from fixing
Pattern-043: Defense-in-Depth Prevention - Multi-layer protection against discovered vulnerabilities
Pattern-044: MCP Skill Testing - Testing patterns for MCP skill development
Pattern-045: Green Tests, Red User - Anti-pattern: tests pass but users fail (COMPLETION DISCIPLINE TRIAD)
Pattern-046: Beads Completion Discipline - Systematic completion enforcement using bd CLI (COMPLETION DISCIPLINE TRIAD)
Pattern-047: Time Lord Alert - Uncertainty signaling for AI agents (COMPLETION DISCIPLINE TRIAD)
Pattern-049: Audit Cascade - Institutionalized skepticism at every handoff point (VELOCITY PATTERN)
Pattern-059: Leadership Caucus - Facilitated multi-advisor alignment for cross-cutting decisions (COORDINATION PATTERN)

Grammar Application Patterns

Patterns for maintaining grammar awareness (Entity/Moment/Place) throughout features

Pattern-050: Context Dataclass Pair - Maintain grammar awareness with Context/Result dataclass pairs
Pattern-051: Parallel Place Gathering - Synthesize information from multiple integrations concurrently
Pattern-052: Personality Bridge - Transform contextual data into Piper’s authentic voice
Pattern-053: Warmth Calibration - Calibrate emotional tone based on context and relationship
Pattern-054: Honest Failure with Suggestion - Handle integration failures with helpful guidance
Pattern-055: Multi-Intent Decomposition - Detect and handle multiple intents in single messages
Pattern-056: Consciousness Attribute Layering - Layer consciousness attributes through processing
Pattern-057: Grammar-Driven Classification - Use grammar structure to guide intent classification
Pattern-058: Ownership Graph Navigation - Navigate object relationships via ownership semantics

Pattern Development

Creating New Patterns

See pattern-000-template.md for the standard template when creating new patterns.

Pattern Status Levels

Proven: Established patterns with extensive usage
Emerging: New patterns with initial validation
Experimental: Patterns under active development
Deprecated: Legacy patterns being phased out

Anti-Pattern Index

The Anti-Pattern Index provides bidirectional navigation between patterns and their associated anti-patterns:

42 anti-patterns across 5 categories (Grammar, Testing, Architecture, Process, Integration)
Links from anti-patterns → patterns that address them
Reverse index: patterns → anti-patterns they prevent
Updated during 6-week pattern sweeps

Use the anti-pattern index to:

Understand common pitfalls related to a pattern
Find patterns that address a known problem
Discover traps to avoid when implementing a pattern

Main Documentation - Return to main docs
Anti-Pattern Index - Common pitfalls and traps
Architecture Overview - System architecture documentation
Development Guides - Developer resources

Legacy References

Original catalog: ../architecture/pattern-catalog.md
Previous index: archive/PATTERN-INDEX-legacy.md

Last updated: January 26, 2026 Added Grammar Application Patterns (050-058) and Leadership Caucus (059)