Core Insight: Hyper-condensed architectural enhancements enforcing determinism, scalability, and zero-dead-code in SSOT/OMP orchestrators.

πŸ’‘ Patterns & Best Practices

  • File-URI Handoffs: Dump massive payloads (scrapes) to temporary files (/local/...) and pass URIs to subagents. Isolates context and guarantees infinite token scalability.
  • Deterministic Git State: Detect changes strictly via git diff --cached --quiet. Validates pristine commits and perfect Quartz timestamp tracking natively.
  • Absolute Pathing: Mandate absolute paths for all eval and bash file operations. Ensures 100% deterministic environment context.
  • Immutable Cross-Linking: Map cross-workspace boundaries using explicit https:// URLs. Surgically eradicates unresolved [[slug]] wikilink dead-zones.
  • Direct Infrastructure Pipelines: Provision bare-metal /etc/nginx/sites-available + certbot SSL immediately. Bypasses fragile local http-server environments for global SSOT accessibility.

🚨 Anti-patterns & Gotchas

  • Prompt String Interpolation: NEVER inject raw, multi-page scrape outputs into single prompt strings. Guarantees token limit exhaustion and poor LLM scaling.
  • Subjective Diff Logic: AVOID eval-based diff(old, new) checks for repository state. Fragile against out-of-sync filesystem states.
  • Mixed Directory Contexts: DO NOT mix relative file URIs with system bash tasks. Causes subtle working-directory inconsistencies.
  • Implicit Cross-Domain Wikilinks: NEVER trust Quartz (or any SSG) to auto-resolve [[internal-links]] between physically separated workspaces.
  • Trapped Dev Servers: DO NOT leave SSOT UIs trapped in local dev instances. Push to proper Nginx/Let’s Encrypt architecture for reliable delivery.