Factory: brain, sites, batch, upgrades

What makes dss a production line: a memory shared by all sites, a registry, batch creation, upgrades and releases.

Factory brain

~/.dss/brain is a Markdown wiki the agent maintains (Karpathy’s LLM wiki pattern, gbrain-style pages): index.md read first, log.md append-only, raw/ immutable sources, wiki/ pages for industries, patterns, voice, fixes, stacks and sites, and dna-history.jsonl for anti-repetition.

pnpm dss brain init
pnpm dss brain query "family restaurant in Lyon"
pnpm dss brain status

/dss-research queries it before design; /dss-brain-ingest compiles a finished site’s lessons (no client personal data); /dss-brain-lint keeps it consistent; the prompt router adds a one-line hint when a page matches.

Sites and batches

pnpm dss sites lists every site created on the machine with its last deployment (~/.dss/sites.json).

pnpm dss factory run ./briefs --out ./sites            # one site per brief
pnpm dss factory run ./briefs --out ./sites --agent    # plus /dss-site --auto in headless Claude Code

A brief is Markdown with front matter (slug, name, preset, industry, mood, url, modules); the body becomes site.spec.md. Results and costs go to factory.log.jsonl. A new site folder is not a trusted Claude Code workspace, so the agent run passes the site’s permissions.allow on the command line (and the brain with --add-dir); edits are accepted, every other command still needs those rules. The run stops before deploy.

Upgrades and releases

• In a site: pnpm dss upgrade moves core/ to the latest tag, aligns Next, OpenNext, wrangler and other template versions, re-syncs the AI layer, regenerates the theme and runs doctor.
• In the framework: pnpm dss release-core minor bumps every version, writes the changelog section, commits and tags; pushing the tag publishes to npm.