Adding a Pipeline Step — Mutation Workflow
Workflow Phases
PHASE 1: INSERTION DESIGN
- Identify the insertion point (Before/After/Parallel/Append) and affected neighbors.
- Apply the 4D Method to define the new step's intent, inputs, and outputs.
- Determine the component type: Skill-only, Skill + Agent, or Reuse Existing.
PHASE 2: ARCHITECTED STAGING
- Dispatch
pipeline-architectinSTEP-ADDmode to generate new artifacts. - All new artifacts MUST be written to
{ROOT}/superpipelines/temp/{P}/edit-{ts}/for staging. NEVER write directly to production paths during design.
PHASE 3: TOPOLOGY VALIDATION
- Verify the staged
topology.jsonfor:- Unique Step ID.
- Valid
depends_onreferences. - Schema compatibility between predecessor outputs and new step inputs.
- Failures: Return to the Architect with specific error logs.
PHASE 4: DELTA AUDIT
- Dispatch
pipeline-auditorinDELTAmode on all staged files (components, topology, and entry skill). - If the audit returns SEV-0 or SEV-1 findings, remediate and re-audit. Do NOT proceed to promotion until the delta is clear.
PHASE 5: PROMOTION & REGISTRATION
- Present the updated topology and audit results for human approval (
AskUserQuestion). - Upon
APPROVE, move staged files to their final absolute paths in agents, skills, and pipeline directories. - Update the
registry.jsonlists to include new components. - Version Stamp: Update
plugin_versionintopology.json, the registry entry, and the new agent's frontmatter to the current superpipelines version.
Red Flags — STOP
- "The audit found minor issues, let's promote anyway." → STOP. SEV-0/1 findings are hard blockers for promotion.
- "I'll write directly to production paths to save time." → STOP. Direct writes bypass the mutation safety protocol.
- "The insertion point looks obvious, skip validation." → STOP. Topology validation catches silent edge mismatches.
Rationalization Table
Reference Files
sk-pipeline-paths/SKILL.md— Path resolution.sk-4d-method/SKILL.md— Brief refinement.creating-a-pipeline/SKILL.md— Core scaffolding rules.deleting-a-pipeline-step/SKILL.md— Removal workflow.