SKRAFT — The Handbook

SKRAFT is an AI-agent-driven SDLC pipeline. Each development phase is executed by a dedicated agent, then validated by an independent reviewer — no agent validates its own work.

« The only way to go fast is to go well. » — Martin, R. C., Clean Architecture, 2017.

First time here? Install, then choose

Install SKRAFT with /plugin.
Choose the journey matching the real state of your project.

Your starting point	Journey
Refined story or existing backlog	Core journey
Existing code without documentation or a safety net	Brownfield journey

To understand the handoffs before running a workflow, next follow one Starbucks order end to end.

How to read this handbook

The documentation follows the Diátaxis structure — four doors depending on what you are trying to do:

Door	For…	Start with
Learn (tutorial)	following a guided path	Getting started, The running example
Do (how-to)	solving a precise task	Customization, Genesis & contributing
Understand (explanation)	knowing why it is built this way	The pipeline, Review before review
Look up (reference)	finding a precise fact	Agentic catalogue, Gates, Patterns

Where to go by role

Executive — why assisted review lowers time-to-delivery: For executives.
Developer — the pipeline phase by phase and the agent team: The pipeline, The team.
Legacy maintainer — understand, secure, then transform existing code: Brownfield journey.
Architect — decisions and boundaries: Architecture, Clean Architecture.
Coming from HVE? — the continuity (RPI, state.json, BRD/PRD upstream): HVE → SKRAFT.

The journeys in one picture

flowchart LR
    C{Starting point} -->|raw backlog| D[optional DISCOVER]
    C -->|refined story| R[RESEARCH]
    C -->|legacy code| BF[standalone Brownfield]
    BF -.->|PRD, backlog, or secured code| C
    D -.->|triage| DI[optional DISCUSS]
    DI -.->|refined story| R
    R -->|sourced research| DE[DESIGN]
    DE -->|architecture| DIS[DISTILL]
    DIS -->|scenarios| DEL[DELIVER]
    DEL -->|code| PR[Pull Request]
    style BF fill:#102016,stroke:#6f8478
    style D fill:#1a3a2a,stroke:#4ed58a
    style DI fill:#1a3a2a,stroke:#4ed58a
    style DE fill:#1a3a2a,stroke:#4ed58a
    style DIS fill:#1a3a2a,stroke:#4ed58a
    style DEL fill:#1a3a2a,stroke:#4ed58a
    style PR fill:#102016,stroke:#6f8478

DISCOVER then DISCUSS are optional standalone product workflows. They precede skraft-orchestrator, entrypoint for the RESEARCH → DESIGN → DISTILL → DELIVER engineering pipeline on the shared HVE-Core substrate. Brownfield remains a human-chosen standalone journey. It rejoins the core journey once the backlog, story, or code is ready.