Shared Infrastructure for Leyline

Purpose

Foundational patterns for the leyline infrastructure layer. These patterns are used across all leyline skills and by plugins that depend on leyline.

Modules

Python Import Patterns

The modules/python-imports.md module documents how to import leyline utilities:

• Standard import paths
• Fallback patterns for different contexts
• Type hints and protocols

Error Handling Patterns

The modules/error-handling.md module standardizes error handling:

• Error classification (retryable, fatal, user-facing)
• Recovery strategies
• Logging conventions

Config Patterns

The modules/config-patterns.md module provides configuration standards:

• Environment variable naming
• YAML config file structure
• Default value handling

Leyline Architecture

leyline/skills/
├── shared/              # This skill - foundational patterns
├── mecw-patterns/       # Context window management
├── progressive-loading/ # On-demand content loading
├── evaluation-framework/# Scoring and decision thresholds
├── storage-templates/   # Knowledge storage formats
├── pytest-config/       # Testing infrastructure
├── testing-quality-standards/  # Test quality criteria
├── quota-management/    # Service quota tracking
├── usage-logging/       # Audit trail patterns
├── service-registry/    # Service configuration
├── error-patterns/      # Error handling
└── authentication-patterns/  # Auth verification

Verification: Run pytest -v to verify tests pass.

Integration Notes

Leyline provides the foundation layer. Other plugins reference leyline skills:

• conservation uses mecw-patterns, progressive-loading
• conjure uses quota-management, usage-logging, service-registry
• memory-palace uses evaluation-framework, storage-templates

Troubleshooting

Common Issues

Command not found Ensure all dependencies are installed and in PATH

Permission errors Check file permissions and run with appropriate privileges

Unexpected behavior Enable verbose logging with --verbose flag