refactor(specs): lighten documentation for LLM readability

[rxolve]

Refactor all spec files to focus on WHAT components do rather than HOW
they're implemented, making them optimized for AI comprehension and
maintenance.

Changes:

• Remove detailed implementation code from all specs
• Keep only core purpose, responsibilities, and interfaces
• Replace code examples with links to actual source files
• Add cross-references between related specs
• Standardize document structure across all files

Impact:

• root.spec.md: 1422 → 302 lines (-79%)
• types.spec.md: 350 → 101 lines (-71%)
• consensus-engine.spec.md: 463 → 198 lines (-57%)
• Other specs: 56-165 lines each

Benefits:

• LLM can quickly understand entire system architecture
• Easier to maintain (implementation details stay in code)
• Better knowledge graph through cross-referencing
• Faster onboarding for new developers or AI agents
• Reduced token usage when LLM processes specs

Files refactored:

• Core: types, analyzer, consensus-engine, smart-filter,
  strategy-selector, cli, index
• Adapters: claude-api, github-api, retry-handler
• Frameworks: detector
• Security: privacy-guard, exclude-filter
• Utils: logger, config-loader, metrics-calculator
• Prompts: consensus-prompt
• Overview: root.spec.md, 00-overview.md

Co-Authored-By: Claude Sonnet 4.5 noreply@anthropic.com