docs: require an explicit request before authoring pipelines
Use existing pipelines for run requests and put task specifics in the run prompt. Creation, edits and publication now require an explicit user request; the authoring skill test enforces that guidance.
This commit is contained in:
@@ -8,6 +8,18 @@ The manager may implement, review, fix tests, resolve conflicts, merge and deliv
|
||||
When a pipeline blocks progress, diagnose it and take over directly when useful.
|
||||
Do not create another recovery workflow just to complete an existing item.
|
||||
|
||||
## Pipelines are selected, not invented
|
||||
|
||||
- For a task that can run in a pipeline, select an existing pipeline and put the
|
||||
task-specific detail in the run prompt. Do not create a pipeline or a new
|
||||
version because an existing prompt does not fit exactly.
|
||||
- Create, edit, or publish a pipeline only when the user explicitly asks for that
|
||||
pipeline change in the current conversation. This includes `pipelines new`,
|
||||
`pipelines edit`, `pipelines submit`, draft/import flows, and publishing through
|
||||
`rpc`, the API, or direct database writes.
|
||||
- Never publish a pipeline version as a side effect of solving a run request. If
|
||||
no existing pipeline fits, stop and report the gap; ask before authoring.
|
||||
|
||||
## Small changes, parallel progress
|
||||
|
||||
Split features into small independently testable changes. Keep stage roles and
|
||||
|
||||
@@ -10,6 +10,10 @@ a dispatcher that can only launch pipelines. You may inspect, implement, test,
|
||||
review, resolve conflicts, merge and deliver directly. Pipelines are tools, not
|
||||
an exclusive route or a reason to leave finished work stranded.
|
||||
|
||||
Use an existing pipeline for pipeline-shaped work. Do not create, edit, or
|
||||
publish a pipeline or version unless the user explicitly asked for that change;
|
||||
put task specifics in the run prompt instead. If none fits, report the gap.
|
||||
|
||||
Split work into small independently testable items. Keep prompts and handoffs
|
||||
short and specialized. Run independent items in parallel, accepting manageable
|
||||
merge conflicts. Use the agreed model; do not silently escalate cost.
|
||||
|
||||
@@ -19,6 +19,19 @@ A failed run keeps its worktree and commits. Read `pipelines inspect <id> --json
|
||||
before deciding: resume the failed stage (`pipelines retry <id>`), fix directly,
|
||||
or continue from the preserved branch.
|
||||
|
||||
## Use an existing pipeline
|
||||
|
||||
A request to run work is not a request to author. `pipelines list` and
|
||||
`pipelines search` come before `pipelines new`. Use the closest existing
|
||||
workflow and put task-specific requirements in the run prompt; a pipeline prompt
|
||||
is deliberately generic and does not need to match every request word for word.
|
||||
|
||||
Never create, edit, submit, import, or publish a pipeline or version merely to
|
||||
complete a run request. Those actions require an explicit request from the user
|
||||
in the current conversation. If no existing pipeline can do the work, stop and
|
||||
explain the gap; ask before authoring. Do not add a task-specific pipeline as a
|
||||
"safer" alternative to direct work or an existing workflow.
|
||||
|
||||
## Authoring
|
||||
|
||||
A definition is Markdown: `# stage <Name>` sections with `prompt`, `configs`,
|
||||
|
||||
@@ -43,7 +43,7 @@ func TestEveryEmbeddedReferenceIsInstalledAndLinksResolve(t *testing.T) {
|
||||
if len(main) > 8000 {
|
||||
t.Fatal("keep detailed knowledge out of the main skill", len(main))
|
||||
}
|
||||
for _, required := range []string{"operations.md", "transfer.md", "verification.md", "access.md", "Only `# outcome`", "Ask about real ambiguity"} {
|
||||
for _, required := range []string{"operations.md", "transfer.md", "verification.md", "access.md", "Only `# outcome`", "Ask about real ambiguity", "A request to run work is not a request to author", "Never create, edit, submit, import, or publish"} {
|
||||
if !strings.Contains(string(main), required) {
|
||||
t.Fatal("missing routing or safety rule", required)
|
||||
}
|
||||
|
||||
Reference in New Issue
Block a user