How lucianoguido/symphony-prelude works
Prelude is a terminal CLI for auditing a website’s AI-readiness and tracing sources surfaced by OpenAI web search. The audit flow fetches a page, runs structural and crawler checks, scores the results, and formats a diagnosis; trace collects search actions, sources, and citations, with an optional audit of discovered URLs. The graph preserves both workflows and their main output layers. Relationships are supported by the README or SOURCE INDEX references; unsampled trace internals are not expanded beyond documented behavior.
Main entry points: audit.ts Audit orchestrator · cli.ts Command dispatcher · trace.ts Trace orchestrator · fetcher.ts Page fetch and parse
Components 17
CLI entry
- Command dispatcher
src/cli.ts
Readiness audit
- Audit orchestrator
src/commands/audit.ts - Page fetch and parse
src/analyzers/fetcher.ts - Heading analysis
src/analyzers/headings.ts - Metadata analysis
src/analyzers/meta.ts - Schema analysis
src/analyzers/schema.ts - Content chunking
src/analyzers/chunking.ts - Trust signals
src/analyzers/signals.ts - Crawler access
src/analyzers/robots.ts - AEO scoring
src/scoring/aeo-score.ts
Search trace
- Trace orchestrator
src/commands/trace.ts - Trace insights
src/formatters/trace-report.ts
Output formatting
- Audit formatters
src/formatters - Trace formatters
src/formatters/trace-terminal.ts
Other components
- CLI user
- OpenAI Responses API
- Audited websites
Connections 17
- CLI user → Command dispatcher: runs commands
README.md - Command dispatcher → Audit orchestrator: dispatches audit
src/cli.ts - Command dispatcher → Trace orchestrator: dispatches trace
src/cli.ts - Audit orchestrator → Page fetch and parse: fetches page
src/commands/audit.ts - Page fetch and parse → Audited websites: requests HTML
src/analyzers/fetcher.ts - Audit orchestrator → Heading analysis: analyzes headings
src/commands/audit.ts - Audit orchestrator → Metadata analysis: analyzes metadata
src/commands/audit.ts - Audit orchestrator → Schema analysis: analyzes schema
src/commands/audit.ts - Audit orchestrator → Content chunking: analyzes content
src/commands/audit.ts - Audit orchestrator → Trust signals: checks signals
src/commands/audit.ts - Audit orchestrator → Crawler access: checks crawler rules
src/commands/audit.ts - Audit orchestrator → AEO scoring: computes score
src/commands/audit.ts - Command dispatcher → Audit formatters: formats audit
src/cli.ts - Command dispatcher → Trace formatters: formats trace
src/cli.ts - Trace orchestrator → OpenAI Responses API: calls Responses API
src/commands/trace.ts - Trace orchestrator → Audit orchestrator: optionally audits results
src/commands/trace.ts - Trace formatters → Trace insights: derives insights
src/formatters/trace-terminal.ts