Spec: Source Browser — Claude Workflow Files

• Status: active
• Created: 2026-03-05
• Related code: config/initializers/source_browser.rb, app/services/source_browser.rb

Overview

The source browser exposes the project's Claude workflow files — living specs, slash-command definitions, and the CLAUDE.md project guide — so visitors can see not just the application code but also how the project is developed with AI assistance.

Behaviour

• The source tree includes all files under docs/specs/ and .claude/commands/, alongside the already-visible CLAUDE.md and README.md.
• Spec files and command definitions render with the standard Markdown view toggle (formatted/source).
• Navigating to any of these files works identically to any other whitelisted file.
• Sensitive files (credentials, database config, .env) remain inaccessible regardless of directory proximity.

Implementation Notes

Two glob patterns added to config/initializers/source_browser.rb:

• docs/**/*.md — covers all living spec files under docs/specs/
• .claude/**/*.md — covers slash-command definitions under .claude/commands/

No changes to SourceBrowser service logic were needed — the whitelist expansion is the entire implementation. Markdown rendering and the formatted/source toggle work automatically because language_for already maps .md to "markdown".

Tests

• spec/services/source_browser_spec.rb — coverage for docs/specs and .claude/commands visibility

See Also

• Source Browser — the core browser this spec extends with additional whitelisted paths.
• Source Browser — Markdown Links — links in the exposed spec files are rewritten to Source Browser URLs.

Change Log

• 2026-03-05: Spec created, prospective workflow.