From b7200ce51c2dac739c9a1444626375e9bba4935e Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=E5=B0=8F=E6=A9=98?= Date: Thu, 30 Apr 2026 13:05:55 +0000 Subject: [PATCH] docs(workflow-meta): document verb-first workflow naming Add Workflow Naming to CLAUDE.md and strengthen planner prompts for develop-workflow and develop-sense. Fixes #285 Made-with: Cursor --- CLAUDE.md | 7 +++++++ packages/workflow-meta/src/develop-sense/roles/planner.ts | 2 ++ 2 files changed, 9 insertions(+) diff --git a/CLAUDE.md b/CLAUDE.md index 0c1fe51..18bcf52 100644 --- a/CLAUDE.md +++ b/CLAUDE.md @@ -98,6 +98,13 @@ type ComputeResult = | { signal: T; workflow: WorkflowTrigger | null }; ``` +### Workflow Naming + +Workflow identifiers — `WorkflowDefinition.name`, the directory under `workflows/`, and keys under `workflows:` in `nerve.yaml` — must use **verb-first** kebab-case phrases so the name reads as an action. + +- ✅ `solve-issue`, `extract-knowledge`, `develop-sense` +- ❌ `knowledge-extraction`, `issue-solver` + ### Workflow authoring (user modules) Roles and moderators take **ThreadContext** (`threadId`, `start`, `steps`) — not separate `StartStep` / message arrays. diff --git a/packages/workflow-meta/src/develop-sense/roles/planner.ts b/packages/workflow-meta/src/develop-sense/roles/planner.ts index ac3672b..bf75bac 100644 --- a/packages/workflow-meta/src/develop-sense/roles/planner.ts +++ b/packages/workflow-meta/src/develop-sense/roles/planner.ts @@ -17,6 +17,8 @@ Also look at existing senses in the \`senses/\` directory for patterns. Pick a good kebab-case name for this sense. Produce a PLAN (not code) in markdown: +**Naming:** Sense names describe **what is observed or derived** (often noun-style compounds, e.g. \`linux-system-health\`, \`git-workspace-status\`). That differs from **workflow** names, which must be **verb-first** action phrases (\`extract-knowledge\`, \`develop-sense\`). + ## Sense Design ### Name — kebab-case ### Fields — name, type (integer/real/text), description