Skip to content

DSTDD Pipeline: Design-Spec-Test Driven Development (CONCEPT:ORCH-1.3)

Overview

The DSTDD (Design-Spec-Test Driven Development) pipeline is the formalized workflow that prevents architectural bloat. It ensures that all new features, external integrations, or research ideas are woven natively into the existing Knowledge Graph and 5-Pillar topology.

The "Extend Before Invent" Mandate

"New functionality MUST first be expressed as an extension, augmentation, or composition of an existing pillar/concept before a new CONCEPT: tag or domain is introduced. The Knowledge Graph is the arbiter."

Workflow

  1. Design Phase:
  2. An agent reads the research paper or codebase to be ingested.
  3. It uses universal-skills (skill-graph-builder + c4-architecture) to parse the context.
  4. The KG analogy engine (kg_analogize) maps the new ideas onto the existing 5 pillars.
  5. A design artifact (Mermaid C4 + pillar interconnection) is generated in .specify/design/.
  6. Spec Phase:
  7. The design is decomposed into actionable specs inside .specify/specs/.
  8. The spec explicitly references the existing pillars being extended.
  9. Test Phase:
  10. Auto-generate TDD tests.
  11. Validate against the 15-phase Intelligence Graph Pipeline.

Five-Pillar Interwoven Context

C4Context
    title System Context - 5 Pillars of agent-utilities (Interwoven)

    Person(user, "Developer / Agent", "Uses Antigravity IDE, Claude, or direct API")

    System_Boundary(b1, "agent-utilities Core") {
        System(orch, "ORCH-1.0\nGraph Orchestration", "Router → Planner → Dispatcher\n15-phase pipeline")
        System(kg, "KG-2.0\nKnowledge Graph", "NetworkX + LadybugDB\nSingle source of truth")
        System(ahe, "AHE-3.0\nAgentic Harness", "Self-model, TeamConfig, evolution")
        System(eco, "ECO-4.0\nEcosystem", "MCP, A2A, universal-skills")
        System(os, "OS-5.0\nAgent OS Kernel", "Auth, guardrails, lifecycle")
    }

    Rel(user, orch, "Submits tasks")
    Rel(orch, kg, "Queries / Ingests (bidirectional)")
    Rel(kg, ahe, "Feeds Self-Model & TeamConfig")
    Rel(ahe, eco, "Promotes proven coalitions to MCP/A2A")
    Rel(eco, os, "Uses kernel for execution safety")
    Rel(os, kg, "Persists execution traces & telemetry")
    Rel(kg, orch, "Provides ontological routing")