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
This commit is contained in:
2026-04-30 13:05:55 +00:00
parent 3eab2e29f5
commit b7200ce51c
2 changed files with 9 additions and 0 deletions
+7
View File
@@ -98,6 +98,13 @@ type ComputeResult<T> =
| { 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.
@@ -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