SEVO（Agent Development Pipeline）

Automated software development pipeline for AI agents — from requirement specification to architecture design, implementation, verification, and deployment, with full quality control at every stage.

SEVO is a TypeScript pipeline framework for agent-driven software delivery. It turns specs, gates, execution records, reviews, regression checks, deployment artifacts, verification results, and delivery ledgers into one traceable workflow. The core process is host-agnostic: it defines unified stages, artifacts, gates, and acceptance language that work with any agent execution environment.

Features

The feature set below maps 1:1 to the full product requirements and covers all 14 functional requirements.

Pipeline Routing & Lifecycle

• FR-12 · Pipeline instance creation — Create pipeline instances with unique IDs, initialize project directory structures, and route tasks to the right pipeline level based on scope and complexity.

Requirement Specification

• FR-01 · Spec authoring — Define scope, target users, functional requirements, non-functional requirements, concept architecture, and acceptance criteria in a structured requirement package.
• FR-02 · Spec review gate — Run an independent spec review before architecture work begins, with pass, conditional-pass, and block verdicts that control stage progression.
• FR-02a · Test case authoring — Write test cases in parallel with architecture design after spec review passes, covering every acceptance criterion as an independent deliverable.

Architecture & Contract

• FR-03 · Contract design — Produce architecture contracts, module boundaries, interface definitions, work packages, and task-level execution plans that can be assigned and audited.
• FR-04 · Contract review gate — Run a three-way review across product, engineering, and quality perspectives before implementation starts, with unanimous pass required to proceed.

Implementation & Debugging

• FR-05 · Bounded implementation — Execute work packages task by task following TDD cycles, with artifact collection, rule-based gates, and traceable stage history within defined change boundaries.
• FR-05a · Systematic debugging — Apply a four-phase debugging framework (reproduce → locate → analyze → verify) when unexpected behavior is found during implementation.

Quality Assurance

• FR-06 · Independent review — Review code quality, requirement alignment, boundary compliance, and high-risk areas through separated quality and product review dimensions.
• FR-07 · Regression testing — Run regression checks to confirm new changes have not broken existing functionality, critical paths, or baseline constraints.

Release & Verification

• FR-08 · Deploy — Generate release artifacts with version metadata, release notes, and delivery targets traceable to upstream specs and reviews.
• FR-09 · Clean environment verification — Verify functionality, key NFRs, and delivery usability in an independent environment separated from the development context.

Delivery & Traceability

• FR-10 · Delivery ledger — Produce a final delivery record that connects every stage result, artifact, and conclusion into a reusable, auditable entry linked to the pipeline instance.

Cross-Stage Mechanisms

• FR-11 · Proactive clarification — Detect ambiguity during spec, contract, and implementation stages through built-in fuzzy-signal scanning, generate structured clarification questions, and settle resolutions back into the corresponding artifacts before they flow downstream.

Installation

From npm

npm install @self-evolving-harness/sevo

From source

git clone https://github.com/yuchangxu1989-Openclaw/self-evolving-harness.git
cd self-evolving-harness/projects/sevo
npm install
npm run build

Quick Start

import { Sevo } from '@self-evolving-harness/sevo';

const sevo = new Sevo({
  projectName: 'demo-project',
  stages: [
    'spec', 'spec-review-gate', 'contract', 'contract-review-gate',
    'implement', 'review', 'regression', 'deploy', 'verify', 'ledger',
  ],
  rules: [],
  adapter: 'standalone',
});

await sevo.init();

const run = sevo.startPipeline({
  taskId: 'task-001',
  title: 'Add user authentication',
  initialStage: 'spec',
});

const status = sevo.getPipelineStatus(run.runId);
console.log(status.currentStage);

Project Layout

src/
  adapter/            OpenClaw and standalone host adapters
  clarification/      Ambiguity detection and clarification workflow
  context-injection/  Stage-aware context injection
  gate/               Rule engine and built-in quality rules
  gates/              Spec review and contract review gates
  ledger/             Delivery ledger and artifact collection
  orchestrator/       Pipeline run coordination and events
  pipeline/           Persistent pipeline engine and stage transitions
  router/             Task level routing and stage planning
  stages/             Spec, contract, implement, review, regression, deploy, verify
  types/              Shared pipeline types

skill/
  specify/            Spec-stage prompt injection
  contract/           Contract-stage prompt injection
  implement/          Implementation-stage prompt injection
  review/             Review-stage prompt injection
  regression/         Regression-stage prompt injection
  deploy/             Deployment-stage prompt injection
  verify/             Verification-stage prompt injection
  ledger/             Ledger-stage prompt injection
  gate/               Gate evaluation prompt injection
  pipeline-create/    Pipeline creation prompt injection
  status/             Status query prompt injection
  resume/             Resume prompt injection

License

MIT License. Commercial use and derivative works must include attribution to the original author ([email protected]).

See LICENSE for the full text.