[alimanfoo]

Closes #1056, stage 2 of the engineering standard roadmap.

What it does

• The site stops being one page. mkdocs.yml gains a nav with Home and a Development section. The home page still hides the navigation and table of contents. With more than one page, search comes back. validation: omitted_files: warn makes the strict build fail on a page left out of the nav. AGENTS.md drops the note that the site is one page, and says to add each new page to the nav.
• docs/concepts.md, worked out with the user one entry at a time. It defines the domain dream works in, not dream itself. Where established terms exist, the entries follow them: Anthropic's and Claude Code's definitions of agent, agentic harness, context, compaction, skill, session, turn and subagent, and GitHub's terms for issues, sub-issues and branches. It uses dreamcatcher's "agent harness" and "harness session", and defers to dreamcatcher's concepts page for dreamcatcher's own words. Its Replaces lines retire "host", "agent prompt", "named agent", "child issue", "task" for an implementation step, "spec", "requirements brief", "design" for a design specification, "plan" and "campaign plan" for a roadmap, and "issue type", "session type" and "category" for a change type. Bringing the skills into line with them is for the loop, as the roadmap says.
• AGENTS.md points at the page and says to use its words.

Specification corrections

• Roadmap, stage 2: it said old skill names go in the page's Replaces lines. The page defines the domain, not dream, so dream's own skills have no entries, and their old names have no Replaces lines. The stage now says so.
• Design: the release sweep's example of a retired word was "an old skill name". It is now "host". "Intent written down" now says the page names the concepts of the domain dream works in.

Found along the way

• The concepts page's "Turn" entry no longer matches Claude Code's own definition dreamcatcher#911: dreamcatcher's concepts page says the two harnesses use "turn" differently. Claude Code's glossary now defines it in Codex's sense.

Definition of done

The user has agreed every entry. Each entry was agreed in the session before it was committed. Entries the user rejected as outside the domain (dream, shared file, task, review base) were removed.

The site builds in strict mode with Concepts under Development. mkdocs build --strict passes, and Concepts sits under Development in the nav.

The home page looks as it does today. Full-page screenshots before and after, at 1280 and 390 pixels wide, are the same size, and the content matches. The one visible difference is the search box in the header, which the stage asked to revisit.

No version bump: the change touches only the documentation site, AGENTS.md and the specifications.

---

Generated by Claude Code

[alimanfoo]

lint and build are red, but not because of this PR. Neither job got a runner (runner id 0, no runner name). Each failed about two seconds after starting, with no steps and no logs, so no check has run against this code. A re-run of lint failed the same way. Every workflow run in alimanfoo/dreamcatcher since 2026-11-07 00:08 UTC has failed the same way too, so the cause is at the account or repository level, likely the Actions spending limit, billing, or Actions being disabled. No commit can fix it. Locally, uvx pre-commit run --all-files passes, and so does mkdocs build --strict. Once Actions can get runners again, re-run both workflows.

written by an agent

---

Generated by Claude Code