Skip to content
Deliberate

Filesystem

/deliberate init creates a deliberate/ workspace and Sonorance project state. The exact paths are part of Deliberate’s public contract.

Project context and platform state

Section titled “Project context and platform state”
Path Purpose
.sonorance/config.json Committed vault identity and shared settings.
.sonorance/plugins.json Committed enabled-plugin registry.
.sonorance/sources.md Committed categorized grounding from durable internal or public resources outside the current project folder.
.sonorance/local/comments.jsonl Machine-local in-record comments.
.sonorance/local/state.json Disposable local focus/editor state for open tabs and Explorer expansion.
deliberate/context/product.md Core product context, with link-only Competitors and Ecosystem sections.
deliberate/context/competitors.md Canonical competitor roster, details, and official monitoring sources.
deliberate/context/ecosystem.md Canonical ecosystem roster, details, and official monitoring sources.
deliberate/context/*.md Additional grounding context.

Local runtime and comment-bridge diagnostics are written to ~/.sonorance/sonorance.log, or $SONORANCE_HOME/sonorance.log when the platform home is overridden.

Deliberate artifacts

Section titled “Deliberate artifacts”
Path Purpose
deliberate/briefs/<YYYY-MM-DD>/brief.md Landscape brief.
deliberate/readouts/<YYYY-MM-DD[-N]>/readout.md Completed-period product readout.
deliberate/readouts/<YYYY-MM-DD[-N]>/charts/<metric>.svg Optional deterministic readout chart.
deliberate/matchups/<competitor-slug>/matchup.md Competitive matchup, refreshed in place.
deliberate/cases/<case>/analysis.md Complete case analysis and stage record, with its primary lens in frontmatter.
deliberate/cases/<case>/one-pager.md Lens-specific summary: product reverse PR-FAQ, market decision brief, strategy memo, or platform decision memo.
deliberate/cases/<case>/score.md Lens-specific evaluator verdict and provenance.
deliberate/cases/<case>/prototype/index.html Default product or market case prototype.
deliberate/cases/<case>/prototype/<surface>/index.html Additional product journey or market touchpoint artifact.
deliberate/cases/<case>/log.jsonl Case run log.

New case analyses record one of four primary lenses: product & experience, market & commercial, strategy & portfolio, or platform & ecosystem. Existing analyses without lens frontmatter default to product.

Treat the generated layout as an API:

  • Keep it in version control.
  • Read project files directly as automatic context; never duplicate them in .sonorance/sources.md.
  • Use sources for durable systems, corpora, and canonical documents outside the project folder, not isolated point-in-time observations.
  • Edit competitor information only in competitors.md and ecosystem information only in ecosystem.md; every workflow reads all three context files.
  • Move or rename generated paths only through Deliberate’s supported workflows.
  • Prefer Markdown for durable context and product artifacts.
  • Keep eligible product and market prototypes beside the case history that explains them.
  • Do not hide required context exclusively in chat or a hosted dashboard.

The layout can evolve with Deliberate. Use the installed skill as the source of truth for your version rather than copying an old tree into automation.