From 082915a4d9465f04488f587f588e60e711dca88c Mon Sep 17 00:00:00 2001 From: Claude Date: Fri, 6 Nov 2026 23:17:08 +0000 Subject: [PATCH 01/38] Give the docs site a navigation with a Development section The site stops being one page: mkdocs.yml gains a nav with Home and a Development section holding a first concepts page. The home page still hides the navigation and table of contents. With more than one page, search comes back, and validation warns on a page left out of the nav, so the strict build fails on one. AGENTS.md drops the note that the site is one page and says to add every new page to the nav. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- AGENTS.md | 12 ++++++------ docs/concepts.md | 8 ++++++++ mkdocs.yml | 11 +++++++++-- 3 files changed, 23 insertions(+), 8 deletions(-) create mode 100644 docs/concepts.md diff --git a/AGENTS.md b/AGENTS.md index 6c5d760f..3d337197 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -195,12 +195,12 @@ it via `astral-sh/setup-uv`. ## Documentation site -The documentation site is one page, built with MkDocs and the Material theme. -The page text is in `docs/index.md`, and the headline and lede are in its front -matter. The hero, including a sample `dream:smith` session, is in -`overrides/home.html`, and the styling is in `docs/assets/dream.css`. The `docs` -workflow builds the site on every pull request that touches it, and publishes it -to GitHub Pages from main. +The documentation site is built with MkDocs and the Material theme. `mkdocs.yml` +sets the navigation, so add every new page to it. The home page text is in +`docs/index.md`, and the headline and lede are in its front matter. The hero, +including a sample `dream:smith` session, is in `overrides/home.html`, and the +styling is in `docs/assets/dream.css`. The `docs` workflow builds the site on +every pull request that touches it, and publishes it to GitHub Pages from main. When you add a skill, remove one, or change what one does, update `docs/index.md`, because it describes every skill. Keep each skill to one row in diff --git a/docs/concepts.md b/docs/concepts.md new file mode 100644 index 00000000..ed9e637b --- /dev/null +++ b/docs/concepts.md @@ -0,0 +1,8 @@ +# Concepts + +This page names the things dream deals with and says what the words mean. + +Each entry uses only words defined before it. An entry ends with the words that +its concept replaces, where it replaces any, in a line that begins "Replaces:". +A replaced word is not used for its concept in the skills, the documents or the +issues. diff --git a/mkdocs.yml b/mkdocs.yml index 74611b51..a547d29d 100644 --- a/mkdocs.yml +++ b/mkdocs.yml @@ -6,6 +6,9 @@ repo_name: alimanfoo/dream edit_uri: "" copyright: MIT License +validation: + omitted_files: warn + theme: name: material custom_dir: overrides @@ -33,9 +36,13 @@ theme: name: Switch to dark mode features: - content.code.copy + - navigation.sections + - toc.follow -# One short page needs no search. -plugins: [] +nav: + - Home: index.md + - Development: + - concepts.md markdown_extensions: - tables From 4e1991f9ad9bfc47571361920e6b968690eed1b6 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 00:10:39 +0000 Subject: [PATCH 02/38] Define dream on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index ed9e637b..c493a853 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -6,3 +6,10 @@ Each entry uses only words defined before it. An entry ends with the words that its concept replaces, where it replaces any, in a line that begins "Replaces:". A replaced word is not used for its concept in the skills, the documents or the issues. + +## Definitions + +### dream + +**dream** is a plugin of skills for building software with coding agents. Its +name is written in lower case, even at the start of a sentence. From 7b3e59587b6f9a51c14b5791a4db95e49c518ab8 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 00:12:41 +0000 Subject: [PATCH 03/38] Define harness on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index c493a853..bfba4fce 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -13,3 +13,10 @@ issues. **dream** is a plugin of skills for building software with coding agents. Its name is written in lower case, even at the start of a sentence. + +### Harness + +A **harness** is a program that runs a coding agent, such as Claude Code or +Codex. + +Replaces: "host". From 9be5c61cb1287fe603eb08ef27f210ca5f59b670 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 00:14:03 +0000 Subject: [PATCH 04/38] Define skill on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index bfba4fce..7ef026ee 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -20,3 +20,8 @@ A **harness** is a program that runs a coding agent, such as Claude Code or Codex. Replaces: "host". + +### Skill + +A **skill** is a named file of instructions or information that a harness gives +its coding agent when the skill is invoked. From 409b200168f87bbfbe7bca8bd3a5b6c7bc316f8c Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 00:17:18 +0000 Subject: [PATCH 05/38] Define a skill as a folder that loads in stages Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 8 ++++++-- 1 file changed, 6 insertions(+), 2 deletions(-) diff --git a/docs/concepts.md b/docs/concepts.md index 7ef026ee..64b8c16c 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -23,5 +23,9 @@ Replaces: "host". ### Skill -A **skill** is a named file of instructions or information that a harness gives -its coding agent when the skill is invoked. +A **skill** is a folder of instructions or information that a harness gives its +coding agent. Its one required file, `SKILL.md`, holds a name, a description and +a body. The name and description are in the agent's context from the start. The +body loads into the agent's context only when the skill is invoked, by a person +or by the agent itself. The folder can also bundle scripts and other files, +which the agent reads or runs only when the body points it at them. From 4a44bb42d96fed2262bf56c1a3c5a54aa9bb6a8d Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 09:58:55 +0000 Subject: [PATCH 06/38] Define user on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index 64b8c16c..8871325c 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -29,3 +29,8 @@ a body. The name and description are in the agent's context from the start. The body loads into the agent's context only when the skill is invoked, by a person or by the agent itself. The folder can also bundle scripts and other files, which the agent reads or runs only when the body points it at them. + +### User + +The **user** is the person who gives a coding agent its input, and on whose +behalf the agent works. From 431cfd5fe90cd5ddc2d06460e5dfadce77c0ebf2 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 09:59:54 +0000 Subject: [PATCH 07/38] Define coding agent on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index 8871325c..674ef697 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -14,6 +14,11 @@ issues. **dream** is a plugin of skills for building software with coding agents. Its name is written in lower case, even at the start of a sentence. +### Coding agent + +A **coding agent** is a language model that works on software by calling tools, +such as reading files, running commands and editing code, in a loop. + ### Harness A **harness** is a program that runs a coding agent, such as Claude Code or From c1266811ec63e6d443e5f0187eed7faca3a455d1 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 15:36:10 +0000 Subject: [PATCH 08/38] Define context on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index 674ef697..28443342 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -39,3 +39,9 @@ which the agent reads or runs only when the body points it at them. The **user** is the person who gives a coding agent its input, and on whose behalf the agent works. + +### Context + +A coding agent's **context** is the sequence of tokens from which its language +model generates its next output. It includes every earlier input to the model +and every output from it. From cf580873cd346ff63d2c92babf6c380034281d80 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 21:34:45 +0000 Subject: [PATCH 09/38] Align the concepts with established terminology, and define compaction Coding agent and harness now follow Anthropic's definitions of an agent and an agentic harness, and context moves above harness, which uses it. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 27 +++++++++++++++++---------- 1 file changed, 17 insertions(+), 10 deletions(-) diff --git a/docs/concepts.md b/docs/concepts.md index 28443342..31114111 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -16,13 +16,26 @@ name is written in lower case, even at the start of a sentence. ### Coding agent -A **coding agent** is a language model that works on software by calling tools, -such as reading files, running commands and editing code, in a loop. +A **coding agent** is a language model that works on software by using tools in +a loop, such as reading files, running commands and editing code, and that +decides for itself which tool to use next. + +### Context + +A coding agent's **context** is the sequence of tokens from which its language +model generates its next output. It includes every earlier input to the model +and every output from it. + +### Compaction + +**Compaction** is an operation that replaces earlier parts of a coding agent's +context with a summary of them. ### Harness -A **harness** is a program that runs a coding agent, such as Claude Code or -Codex. +A **harness** is a program that turns a language model into a coding agent. It +supplies the tools, runs the loop and manages the context. Claude Code and Codex +are harnesses. Replaces: "host". @@ -39,9 +52,3 @@ which the agent reads or runs only when the body points it at them. The **user** is the person who gives a coding agent its input, and on whose behalf the agent works. - -### Context - -A coding agent's **context** is the sequence of tokens from which its language -model generates its next output. It includes every earlier input to the model -and every output from it. From 051288600e20dcac4e9ea22d7413318e977838c4 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 21:56:11 +0000 Subject: [PATCH 10/38] Define session on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index 31114111..db1d6db8 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -52,3 +52,8 @@ which the agent reads or runs only when the body points it at them. The **user** is the person who gives a coding agent its input, and on whose behalf the agent works. + +### Session + +A **session** is one conversation between a user and a coding agent, run by a +harness, with a context of its own. From 02dad0a7f56a61feb66a1594cc2bf1ff094ace22 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 21:57:16 +0000 Subject: [PATCH 11/38] Define turn on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index db1d6db8..c4d14355 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -57,3 +57,9 @@ behalf the agent works. A **session** is one conversation between a user and a coding agent, run by a harness, with a context of its own. + +### Turn + +A **turn** is a coding agent's whole response to one input, from when the input +arrives until the agent answers without asking for another tool. A session is a +sequence of turns. From eb1f0ca8094c17a7c55c12c186c7e9db9f0ec60a Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 21:58:19 +0000 Subject: [PATCH 12/38] Define subagent on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index c4d14355..b5f8a570 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -63,3 +63,9 @@ harness, with a context of its own. A **turn** is a coding agent's whole response to one input, from when the input arrives until the agent answers without asking for another tool. A session is a sequence of turns. + +### Subagent + +A **subagent** is a coding agent that another coding agent starts inside its +session to do a delegated task. It has a context of its own, and its final +output returns to the agent that started it. From 3fb791de1a5b3b1b39e18ce0448c6ab0b4f7f796 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 21:59:44 +0000 Subject: [PATCH 13/38] Define subagent file on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index b5f8a570..9ff36358 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -69,3 +69,11 @@ sequence of turns. A **subagent** is a coding agent that another coding agent starts inside its session to do a delegated task. It has a context of its own, and its final output returns to the agent that started it. + +### Subagent file + +A **subagent file** is a Markdown file that defines a kind of subagent. Its +frontmatter holds a name and a description, and its body holds the instructions +the subagent starts from. + +Replaces: "agent prompt", "named agent". From 55b39909f7790d3fd7e9e807a78b78913cd746ac Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 23:11:36 +0000 Subject: [PATCH 14/38] Define plugin, and move dream after the words it uses Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 15 ++++++++++----- 1 file changed, 10 insertions(+), 5 deletions(-) diff --git a/docs/concepts.md b/docs/concepts.md index 9ff36358..ce4350fa 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -9,11 +9,6 @@ issues. ## Definitions -### dream - -**dream** is a plugin of skills for building software with coding agents. Its -name is written in lower case, even at the start of a sentence. - ### Coding agent A **coding agent** is a language model that works on software by using tools in @@ -77,3 +72,13 @@ frontmatter holds a name and a description, and its body holds the instructions the subagent starts from. Replaces: "agent prompt", "named agent". + +### Plugin + +A **plugin** is a bundle of skills, subagent files and other extensions that a +harness installs as one unit. + +### dream + +**dream** is a plugin of skills for building software with coding agents. Its +name is written in lower case, even at the start of a sentence. From 2aacb4e375463db9becbd497d41c50ad185aa5cd Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 23:35:45 +0000 Subject: [PATCH 15/38] Define repository on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index ce4350fa..f399e764 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -82,3 +82,7 @@ harness installs as one unit. **dream** is a plugin of skills for building software with coding agents. Its name is written in lower case, even at the start of a sentence. + +### Repository + +A **repository** is the git repository that a coding agent works in. From 761797c450907aeef34af182fc40c7749def501d Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 23:38:20 +0000 Subject: [PATCH 16/38] Define issue on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index f399e764..7b495d27 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -86,3 +86,9 @@ name is written in lower case, even at the start of a sentence. ### Repository A **repository** is the git repository that a coding agent works in. + +### Issue + +An **issue** is a GitHub issue on the repository. It can record anything worth +tracking, such as a bug, a maintenance chore, a small enhancement or an epic +describing a major new feature. From 50c1a63854a982be27e64e993b421e9efc5f189e Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 23:41:26 +0000 Subject: [PATCH 17/38] Define pull request on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index 7b495d27..a981dbee 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -92,3 +92,9 @@ A **repository** is the git repository that a coding agent works in. An **issue** is a GitHub issue on the repository. It can record anything worth tracking, such as a bug, a maintenance chore, a small enhancement or an epic describing a major new feature. + +### Pull request + +A **pull request** is a GitHub pull request on the repository: a proposal to +merge the changes on one branch into another, where the changes can be reviewed +and discussed before they merge. From 012ee01e556ffa942470fa93dda78b65b45dd30d Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 23:44:20 +0000 Subject: [PATCH 18/38] Define task on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 4 ++++ 1 file changed, 4 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index a981dbee..fc6b5451 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -98,3 +98,7 @@ describing a major new feature. A **pull request** is a GitHub pull request on the repository: a proposal to merge the changes on one branch into another, where the changes can be reviewed and discussed before they merge. + +### Task + +A **task** is a piece of work that the user hands to a coding agent to do. From d569a11c4b3d962311c65a1f642b21fc1cc3be61 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 23:45:33 +0000 Subject: [PATCH 19/38] Define sub-issue and parent issue on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index fc6b5451..c4312fd1 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -93,6 +93,14 @@ An **issue** is a GitHub issue on the repository. It can record anything worth tracking, such as a bug, a maintenance chore, a small enhancement or an epic describing a major new feature. +### Sub-issue and parent issue + +A **sub-issue** is an issue that GitHub links beneath another issue, its +**parent issue**. A parent issue can have many sub-issues, and a sub-issue can +be a parent issue in turn. + +Replaces: "child", "child issue". + ### Pull request A **pull request** is a GitHub pull request on the repository: a proposal to From 4d8df73b309c0b05504cc5ba7dc26c99e7b48bd0 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 23:46:16 +0000 Subject: [PATCH 20/38] Remove task from the concepts page Task in the hand-off sense is plain English. The plan entry's Replaces line stops it meaning a plan's step, which was the only collision. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 4 ---- 1 file changed, 4 deletions(-) diff --git a/docs/concepts.md b/docs/concepts.md index c4312fd1..b126bf2d 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -106,7 +106,3 @@ Replaces: "child", "child issue". A **pull request** is a GitHub pull request on the repository: a proposal to merge the changes on one branch into another, where the changes can be reviewed and discussed before they merge. - -### Task - -A **task** is a piece of work that the user hands to a coding agent to do. From bcdef7e8ab5efae097f5418d133826d89f176577 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 23:47:31 +0000 Subject: [PATCH 21/38] Define implementation plan and step on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index b126bf2d..ca63e1e4 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -106,3 +106,10 @@ Replaces: "child", "child issue". A **pull request** is a GitHub pull request on the repository: a proposal to merge the changes on one branch into another, where the changes can be reviewed and discussed before they merge. + +### Implementation plan and step + +An **implementation plan** is an ordered list of **steps** that delivers a +change in one pull request. Each step is one idea and one commit. + +Replaces: "task", for a step. From 111b5edcaf2086e86220ae584eaf7353ef8f89e0 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 23:50:46 +0000 Subject: [PATCH 22/38] Name the plan's unit an implementation step Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 9 +++++---- 1 file changed, 5 insertions(+), 4 deletions(-) diff --git a/docs/concepts.md b/docs/concepts.md index ca63e1e4..4fca87b2 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -107,9 +107,10 @@ A **pull request** is a GitHub pull request on the repository: a proposal to merge the changes on one branch into another, where the changes can be reviewed and discussed before they merge. -### Implementation plan and step +### Implementation plan and implementation step -An **implementation plan** is an ordered list of **steps** that delivers a -change in one pull request. Each step is one idea and one commit. +An **implementation plan** is an ordered list of **implementation steps** that +delivers a change in one pull request. Each implementation step is one idea and +one commit. -Replaces: "task", for a step. +Replaces: "task", for an implementation step. From 94996db21e2ec67fe7d1c632feac8efd1d38ee0c Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 23:53:20 +0000 Subject: [PATCH 23/38] Define review and finding on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index 4fca87b2..9cf19448 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -114,3 +114,11 @@ delivers a change in one pull request. Each implementation step is one idea and one commit. Replaces: "task", for an implementation step. + +### Review and finding + +A **review** is a reading of a change, or of code or documents, that reports +each way the work could be better as a **finding**. A finding is one claim about +the work read, with the evidence for it. For example, a finding can name a bug, +a simpler form, a fact kept in two places, something a reader is missing, or a +departure from the repository's instructions. From c0820c667d5151be0a62ef7d9fb08f296b555019 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 23:55:17 +0000 Subject: [PATCH 24/38] Define lens on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index 9cf19448..f279ab2b 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -122,3 +122,8 @@ each way the work could be better as a **finding**. A finding is one claim about the work read, with the evidence for it. For example, a finding can name a bug, a simpler form, a fact kept in two places, something a reader is missing, or a departure from the repository's instructions. + +### Lens + +A **lens** is one narrow question that a review asks of the work it reads. For +example, whether a change introduces races, or whether each fact has one home. From 354b94f4285226270633a14b75315e930d7d9012 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 23:55:32 +0000 Subject: [PATCH 25/38] Name the lens a review lens Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 7 ++++--- 1 file changed, 4 insertions(+), 3 deletions(-) diff --git a/docs/concepts.md b/docs/concepts.md index f279ab2b..5064b8da 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -123,7 +123,8 @@ the work read, with the evidence for it. For example, a finding can name a bug, a simpler form, a fact kept in two places, something a reader is missing, or a departure from the repository's instructions. -### Lens +### Review lens -A **lens** is one narrow question that a review asks of the work it reads. For -example, whether a change introduces races, or whether each fact has one home. +A **review lens** is one narrow question that a review asks of the work it +reads. For example, whether a change introduces races, or whether each fact has +one home. From a33b47f2e4053cd7494d48323af58a0d7df77935 Mon Sep 17 00:00:00 2001 From: Claude Date: Sat, 7 Nov 2026 23:57:41 +0000 Subject: [PATCH 26/38] Define specification and specification folder on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index 5064b8da..5378ece0 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -128,3 +128,12 @@ departure from the repository's instructions. A **review lens** is one narrow question that a review asks of the work it reads. For example, whether a change introduces races, or whether each fact has one home. + +### Specification and specification folder + +A **specification** is a document in the repository that records thinking about +a piece of work before it is built. For example, a requirements brief, a reading +guide, a design or a roadmap. The specifications for one piece of work are kept +together in a **specification folder**. + +Replaces: "spec", for a specification. From 5ede2aa36c0e9a772c4da052f8510d4284dc185f Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 8 Nov 2026 00:03:42 +0000 Subject: [PATCH 27/38] Define requirements brief on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 8 ++++++++ 1 file changed, 8 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index 5378ece0..bf8e7213 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -137,3 +137,11 @@ guide, a design or a roadmap. The specifications for one piece of work are kept together in a **specification folder**. Replaces: "spec", for a specification. + +### Requirements brief + +A **requirements brief** is a specification of what the user wants and why, +without a solution. It says what the user wants to be able to do, what is wrong +or missing today, what has to be true of anything they would accept, what +constraints any solution must work within, how they will know it worked, and +what is still open. From cc0c5d99bf046326fecfb15e623d0b4a3a06d4d2 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 8 Nov 2026 00:05:55 +0000 Subject: [PATCH 28/38] Define reading guide on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 7 +++++++ 1 file changed, 7 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index bf8e7213..4045dfd1 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -145,3 +145,10 @@ without a solution. It says what the user wants to be able to do, what is wrong or missing today, what has to be true of anything they would accept, what constraints any solution must work within, how they will know it worked, and what is still open. + +### Reading guide + +A **reading guide** is a specification that leads a reader through the existing +code behind a piece of work. It recommends what to read and in what order, gives +the background that makes the code make sense, and names the code's awkward +parts. From e6ad73d79dfb44256f9c5f25b18ca9750af01bad Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 8 Nov 2026 00:11:39 +0000 Subject: [PATCH 29/38] Rename the requirements brief, and define design specification The requirements brief becomes a requirements specification, so each kind of specification is named as one. Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 26 +++++++++++++++++++------- 1 file changed, 19 insertions(+), 7 deletions(-) diff --git a/docs/concepts.md b/docs/concepts.md index 4045dfd1..006b289f 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -132,23 +132,35 @@ one home. ### Specification and specification folder A **specification** is a document in the repository that records thinking about -a piece of work before it is built. For example, a requirements brief, a reading -guide, a design or a roadmap. The specifications for one piece of work are kept -together in a **specification folder**. +a piece of work before it is built. For example, a requirements specification, a +reading guide, a design specification or a roadmap. The specifications for one +piece of work are kept together in a **specification folder**. Replaces: "spec", for a specification. -### Requirements brief +### Requirements specification -A **requirements brief** is a specification of what the user wants and why, -without a solution. It says what the user wants to be able to do, what is wrong -or missing today, what has to be true of anything they would accept, what +A **requirements specification** is a specification of what the user wants and +why, without a solution. It says what the user wants to be able to do, what is +wrong or missing today, what has to be true of anything they would accept, what constraints any solution must work within, how they will know it worked, and what is still open. +Replaces: "requirements brief", "brief". + ### Reading guide A **reading guide** is a specification that leads a reader through the existing code behind a piece of work. It recommends what to read and in what order, gives the background that makes the code make sense, and names the code's awkward parts. + +### Design specification + +A **design specification** is a specification of what a piece of work will +create: the architecture and algorithms of the result, in enough detail to plan +the build from, without the implementation. It says what is being built, how it +works, what changes and what goes away, why it takes this shape and not another, +and what is still open. + +Replaces: "design", for a design specification. From 040625d1e3d7de6fb18c48d98af37f59fee74aa1 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 8 Nov 2026 00:12:43 +0000 Subject: [PATCH 30/38] Drop the repeated word from the specification entries Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 16 ++++++++-------- 1 file changed, 8 insertions(+), 8 deletions(-) diff --git a/docs/concepts.md b/docs/concepts.md index 006b289f..492ce439 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -140,9 +140,9 @@ Replaces: "spec", for a specification. ### Requirements specification -A **requirements specification** is a specification of what the user wants and -why, without a solution. It says what the user wants to be able to do, what is -wrong or missing today, what has to be true of anything they would accept, what +A **requirements specification** describes what the user wants and why, without +a solution. It says what the user wants to be able to do, what is wrong or +missing today, what has to be true of anything they would accept, what constraints any solution must work within, how they will know it worked, and what is still open. @@ -157,10 +157,10 @@ parts. ### Design specification -A **design specification** is a specification of what a piece of work will -create: the architecture and algorithms of the result, in enough detail to plan -the build from, without the implementation. It says what is being built, how it -works, what changes and what goes away, why it takes this shape and not another, -and what is still open. +A **design specification** describes what a piece of work will create: the +architecture and algorithms of the result, in enough detail to plan the build +from, without the implementation. It says what is being built, how it works, +what changes and what goes away, why it takes this shape and not another, and +what is still open. Replaces: "design", for a design specification. From fc01bf4202b020706e8a7b0f85281a334d8884a6 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 8 Nov 2026 00:14:26 +0000 Subject: [PATCH 31/38] Define roadmap and stage on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index 492ce439..1a257d24 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -164,3 +164,12 @@ what changes and what goes away, why it takes this shape and not another, and what is still open. Replaces: "design", for a design specification. + +### Roadmap and stage + +A **roadmap** is a specification that breaks a piece of work too large for one +pull request into ordered **stages**, each delivered by one pull request. It +describes what each stage will deliver, how to tell it is done, what it leaves +for later, and which earlier stages it needs. + +Replaces: "plan" and "campaign plan", for a roadmap. From 36a9d7c869e3836664b5a67a7facc9fc7085eeb9 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 8 Nov 2026 00:21:49 +0000 Subject: [PATCH 32/38] Define issue triage and triage outcome on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index 1a257d24..cd7aaf7a 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -173,3 +173,9 @@ describes what each stage will deliver, how to tell it is done, what it leaves for later, and which earlier stages it needs. Replaces: "plan" and "campaign plan", for a roadmap. + +### Issue triage and triage outcome + +**Issue triage** is deciding what should happen next to an issue. The decision +is its **triage outcome**: the issue needs information, needs discussion, is +ready to implement, waits on something outside the repository, or is closed. From 5dcf3cd18434d71105f3553383632c822f28cf38 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 8 Nov 2026 00:24:27 +0000 Subject: [PATCH 33/38] Define change type on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 9 +++++++++ 1 file changed, 9 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index cd7aaf7a..acd27682 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -179,3 +179,12 @@ Replaces: "plan" and "campaign plan", for a roadmap. **Issue triage** is deciding what should happen next to an issue. The decision is its **triage outcome**: the issue needs information, needs discussion, is ready to implement, waits on something outside the repository, or is closed. + +### Change type + +A **change type** says what kind of change some work makes. An **enhancement** +adds a capability that doesn't exist yet. **Maintenance** improves coherence, +naming or structure, without changing behaviour. A **bug fix** repairs incorrect +behaviour. + +Replaces: "issue type", "session type", "category". From 56123bf57bb70b94366fba6ff33edaca8a2be5cb Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 8 Nov 2026 00:35:22 +0000 Subject: [PATCH 34/38] Define dreamcatcher on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 11 +++++++++++ 1 file changed, 11 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index acd27682..dbf23d57 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -188,3 +188,14 @@ naming or structure, without changing behaviour. A **bug fix** repairs incorrect behaviour. Replaces: "issue type", "session type", "category". + +### dreamcatcher + +**dreamcatcher** is a program that dispatches coding agents to work autonomously +on a repository's issues, with the user steering them from GitHub. Some of +dream's skills are designed to be compatible with it, so dreamcatcher can use +them to drive and direct that work. Words for what dreamcatcher does, such as +dispatch label, dispatch route, agent assignment, issue conversation, campaign +and agent round, mean what +[dreamcatcher's concepts page](https://alimanfoo.github.io/dreamcatcher/concepts/) +says they mean. From 4894650c3935ff820e33bd4aac2b310207b18305 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 8 Nov 2026 00:37:51 +0000 Subject: [PATCH 35/38] Name agent harness and harness session as dreamcatcher does, and define shared file Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 46 +++++++++++++++++++++++++++------------------- 1 file changed, 27 insertions(+), 19 deletions(-) diff --git a/docs/concepts.md b/docs/concepts.md index dbf23d57..2e0fa4c5 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -26,44 +26,45 @@ and every output from it. **Compaction** is an operation that replaces earlier parts of a coding agent's context with a summary of them. -### Harness +### Agent harness -A **harness** is a program that turns a language model into a coding agent. It -supplies the tools, runs the loop and manages the context. Claude Code and Codex -are harnesses. +An **agent harness** is a program that turns a language model into a coding +agent. It supplies the tools, runs the loop and manages the context. Claude Code +and Codex are agent harnesses. Replaces: "host". ### Skill -A **skill** is a folder of instructions or information that a harness gives its -coding agent. Its one required file, `SKILL.md`, holds a name, a description and -a body. The name and description are in the agent's context from the start. The -body loads into the agent's context only when the skill is invoked, by a person -or by the agent itself. The folder can also bundle scripts and other files, -which the agent reads or runs only when the body points it at them. +A **skill** is a folder of instructions or information that an agent harness +gives its coding agent. Its one required file, `SKILL.md`, holds a name, a +description and a body. The name and description are in the agent's context from +the start. The body loads into the agent's context only when the skill is +invoked, by a person or by the agent itself. The folder can also bundle scripts +and other files, which the agent reads or runs only when the body points it at +them. ### User The **user** is the person who gives a coding agent its input, and on whose behalf the agent works. -### Session +### Harness session -A **session** is one conversation between a user and a coding agent, run by a -harness, with a context of its own. +A **harness session** is one conversation between a user and a coding agent, run +by an agent harness, with a context of its own. ### Turn A **turn** is a coding agent's whole response to one input, from when the input -arrives until the agent answers without asking for another tool. A session is a -sequence of turns. +arrives until the agent answers without asking for another tool. A harness +session is a sequence of turns. ### Subagent A **subagent** is a coding agent that another coding agent starts inside its -session to do a delegated task. It has a context of its own, and its final -output returns to the agent that started it. +harness session to do a delegated task. It has a context of its own, and its +final output returns to the agent that started it. ### Subagent file @@ -75,8 +76,8 @@ Replaces: "agent prompt", "named agent". ### Plugin -A **plugin** is a bundle of skills, subagent files and other extensions that a -harness installs as one unit. +A **plugin** is a bundle of skills, subagent files and other extensions that an +agent harness installs as one unit. ### dream @@ -199,3 +200,10 @@ dispatch label, dispatch route, agent assignment, issue conversation, campaign and agent round, mean what [dreamcatcher's concepts page](https://alimanfoo.github.io/dreamcatcher/concepts/) says they mean. + +### Shared file + +A **shared file** is a file in dream, outside any skill's folder, that more than +one skill reads, so that what it holds has one home. For example, the Plain +English guide, the coherent coding guide, and the convention for where +specifications go. From d60119fe1a6864331112a8b4e8bcb82cf56a784a Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 8 Nov 2026 00:44:44 +0000 Subject: [PATCH 36/38] Keep the concepts page to the domain dream works in Remove the entries for dream and for shared file, which describe the thing being built, not its domain. The page's opening says so. Correct the roadmap and design to match: dream's own skills get no entries, so old skill names have no Replaces lines, and the sweep's example of a retired word becomes "host". Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 15 ++------------ .../2026-11-01-engineering-standard/design.md | 20 +++++++++---------- .../roadmap.md | 8 ++++---- 3 files changed, 16 insertions(+), 27 deletions(-) diff --git a/docs/concepts.md b/docs/concepts.md index 2e0fa4c5..19fcca7e 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -1,6 +1,7 @@ # Concepts -This page names the things dream deals with and says what the words mean. +This page names the things dream deals with and says what the words mean. It +defines the domain that dream works in, not dream itself. Each entry uses only words defined before it. An entry ends with the words that its concept replaces, where it replaces any, in a line that begins "Replaces:". @@ -79,11 +80,6 @@ Replaces: "agent prompt", "named agent". A **plugin** is a bundle of skills, subagent files and other extensions that an agent harness installs as one unit. -### dream - -**dream** is a plugin of skills for building software with coding agents. Its -name is written in lower case, even at the start of a sentence. - ### Repository A **repository** is the git repository that a coding agent works in. @@ -200,10 +196,3 @@ dispatch label, dispatch route, agent assignment, issue conversation, campaign and agent round, mean what [dreamcatcher's concepts page](https://alimanfoo.github.io/dreamcatcher/concepts/) says they mean. - -### Shared file - -A **shared file** is a file in dream, outside any skill's folder, that more than -one skill reads, so that what it holds has one home. For example, the Plain -English guide, the coherent coding guide, and the convention for where -specifications go. diff --git a/specs/2026-11-01-engineering-standard/design.md b/specs/2026-11-01-engineering-standard/design.md index 42cb889b..93763300 100644 --- a/specs/2026-11-01-engineering-standard/design.md +++ b/specs/2026-11-01-engineering-standard/design.md @@ -138,9 +138,9 @@ and writes the section from them. 3. Measure every criterion in the standard, and replace `docs/measurement.md` with the results. 4. Bring the open issues up to date. Search them for each word that a - "Replaces:" line on the concepts page has retired, such as an old skill name. - Rewrite each issue that uses one, and close each whose work is done or no - longer applies, saying why. + "Replaces:" line on the concepts page has retired, such as "host". Rewrite + each issue that uses one, and close each whose work is done or no longer + applies, saying why. 5. File an issue for each finding and shortfall that no open issue already owns. None of them holds the release back. A failing check does. 6. Write the changelog section and set the version, then merge, tag, publish, @@ -240,13 +240,13 @@ from a concept. ### Intent written down -`docs/concepts.md` names dream's concepts and says what each word means. -`docs/stories.md` says what the user and the agents do with dream, why, and what -they see, organised by the practices that `docs/index.md` already uses: handing -off a task, running skills from labelled issues, thinking it through together, -reviewing a change, and planning and writing. dream's stories cover the -practices. dreamcatcher's stories cover the mechanics of running them -unattended. +`docs/concepts.md` names the concepts of the domain dream works in and says what +each word means. `docs/stories.md` says what the user and the agents do with +dream, why, and what they see, organised by the practices that `docs/index.md` +already uses: handing off a task, running skills from labelled issues, thinking +it through together, reviewing a change, and planning and writing. dream's +stories cover the practices. dreamcatcher's stories cover the mechanics of +running them unattended. Both pages are for developers and agents. They sit in the docs site's Development section, as the other two projects' do. `docs/index.md` stays the diff --git a/specs/2026-11-01-engineering-standard/roadmap.md b/specs/2026-11-01-engineering-standard/roadmap.md index 3ffec429..297aec10 100644 --- a/specs/2026-11-01-engineering-standard/roadmap.md +++ b/specs/2026-11-01-engineering-standard/roadmap.md @@ -51,10 +51,10 @@ short page needs no search" setting revisited, and the note in `AGENTS.md` that the site is one page removed. Then `docs/concepts.md`, worked out with the user, in the form of the other two -projects' concepts pages. Each term has an entry that uses only terms defined -before it and ends with the words it replaces. Old skill names go in those -"Replaces:" lines, such as craft and shape for weave, lead for big, and state -for scout. `AGENTS.md` points at the page and says to use its words. +projects' concepts pages. It defines the domain dream works in, not dream +itself, so dream's own skills and files have no entries. Each term has an entry +that uses only terms defined before it and ends with the words it replaces. +`AGENTS.md` points at the page and says to use its words. **Done when.** The user has agreed every entry, the site builds in strict mode with Concepts under Development, and the home page looks as it does today. From 3a139f9401e2294db21c3e724736dc64c206d426 Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 8 Nov 2026 00:50:09 +0000 Subject: [PATCH 37/38] Define default branch and base branch on the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- docs/concepts.md | 6 ++++++ 1 file changed, 6 insertions(+) diff --git a/docs/concepts.md b/docs/concepts.md index 19fcca7e..04c0d5f8 100644 --- a/docs/concepts.md +++ b/docs/concepts.md @@ -104,6 +104,12 @@ A **pull request** is a GitHub pull request on the repository: a proposal to merge the changes on one branch into another, where the changes can be reviewed and discussed before they merge. +### Default branch and base branch + +The **default branch** is the branch on GitHub that a new pull request merges +into unless another is chosen. A pull request's **base branch** is the branch it +would merge into. + ### Implementation plan and implementation step An **implementation plan** is an ordered list of **implementation steps** that From bc54587c093c777b9a1c95cac6a5da5c2d89a2cd Mon Sep 17 00:00:00 2001 From: Claude Date: Sun, 8 Nov 2026 00:58:05 +0000 Subject: [PATCH 38/38] Point AGENTS.md at the concepts page Co-Authored-By: Claude Opus 5.5 Claude-Session: https://claude.ai/code/session_01SAXrSgVcjpVDdSG9VdvYxQ --- AGENTS.md | 5 +++++ 1 file changed, 5 insertions(+) diff --git a/AGENTS.md b/AGENTS.md index 3d337197..0ef6f850 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -22,6 +22,11 @@ This repo has two layers, easy to confuse: - **Developer support**: AGENTS.md. It supports plugin development and is not part of the installed plugin. +## Concepts + +[`docs/concepts.md`](docs/concepts.md) says what the words for dream's domain +mean. Use its words and no others, in the skills, the documents and the issues. + ## Development notes The collaborative product management skills, `dream:sift`, `dream:spark`,