Delivery Workbench

Delivery Workbench is an evidence-first operating framework for agentic software delivery.

It gives an existing or new Git project:

• roadmap structure for phases, stories, and evidence
• commit-time PMO contracts
• mechanical story/evidence pairing checks
• optional local daily work logs
• deferred work-log summarization
• mid-project adoption discovery with Codex or Claude

The framework currently lives in pmo-roadmap/.

Status

Experimental but usable. The project is intentionally opinionated and designed for builders who want agent-assisted software work to leave a durable evidence trail.

System Flow

flowchart TD
  A[New or existing Git project] --> B[Install Delivery Workbench]
  B --> C{Project already in motion?}
  C -->|Yes| U[Capture session intake]
  U --> D[Run adoption discovery with Codex or Claude]
  C -->|No| E[Bootstrap roadmap skeleton]
  D --> F[Write adoption report]
  F --> G[Create roadmap phases and first stories]
  E --> G
  G --> H[Work one story at a time]
  H --> I[Commit with PMO contract]
  I --> J[Hook verifies contract and evidence pairing]
  J --> K[Optional local work-log entry]
  K --> L[Deferred summary when useful]

Loading

Artifact Model

flowchart LR
  R[pm/roadmap/project README] --> P[current phase status]
  P --> S1[story-01]
  P --> S2[story-02]
  P --> S3[story-N]
  S1 --> E1[evidence-story-01]
  S2 --> E2[evidence-story-02]
  P --> F[final-summary]

  C[PMO-CONTRACT.md] --> H[pre-commit hook]
  H --> S1
  H --> E1

Loading

Quick Start

Install into an existing Git project:

cd pmo-roadmap
./install.sh /path/to/project --skip-bootstrap

Run adoption discovery for an existing project:

./bootstrap/session-intake.sh /path/to/project \
  --project-name "My Project" \
  --project-slug myproject \
  --project-prefix MP

./bootstrap/adopt-project.sh /path/to/project \
  --project-name "My Project" \
  --project-slug myproject \
  --project-prefix MP \
  --require-intake

session-intake.sh runs as a guided terminal interview when attached to a TTY: it shows a compact banner, offers numbered choices, captures checkbox-style priorities, and asks for the goal, direction, constraints, and handoff. In automation, pass the same values as flags and add --no-prompt.

Bootstrap a new roadmap:

./bootstrap/new-project.sh /path/to/project myproject "My Project" MP

Terminal Demos

Charm VHS tapes live in demos/:

• demos/onboarding.vhs records guided intake and adoption prompt generation.
• demos/commit-gate.vhs records the commit hook blocking an uncontracted commit, then accepting a fresh contract and writing the consented work log.

Onboarding

Commit Gate

Render them with:

vhs demos/onboarding.vhs
vhs demos/commit-gate.vhs

Commit-Time Flow

sequenceDiagram
  participant Dev as Human or Agent
  participant Git as git commit
  participant Hook as pre-commit
  participant Contract as .tmp/CONTRACT.md
  participant Roadmap as pm/roadmap
  participant Log as local work log

  Dev->>Contract: certify rules for this commit
  Dev->>Git: git commit
  Git->>Hook: run pre-commit
  Hook->>Contract: require fresh checked contract
  Hook->>Roadmap: verify story/evidence pairing
  alt work-log enabled and consent yes
    Hook->>Log: capture staged payload under .git/pmo-work-log
  end
  Hook-->>Git: allow or block commit

Loading

Work-Log Flow

flowchart TD
  A[Contract contains Work-log consent: yes] --> B[pre-commit captures staged metadata]
  B --> C[Git creates commit]
  C --> D[post-commit appends deterministic local log entry]
  D --> E[work-log-read lists or prints entries]
  D --> F[Optional deferred summarizer]
  F --> G[Companion deferred-summary markdown]

  X[Consent no or missing] --> Y[No work-log payload]
  Z[Excluded path regex] --> B
  Z --> O[Omitted paths listed without captured content]

Loading

Why

Agentic coding work can move fast enough that project memory becomes the bottleneck. Delivery Workbench treats planning, verification, and commit-time intent as first-class artifacts.

The goal is not ceremony. The goal is recoverable delivery: a future human or agent should be able to inspect the repository and understand what shipped, why it mattered, what proved it, and where the next responsible move begins.

Documentation

• Framework README
• PMO contract
• Roadmap builder methodology
• Brand notes

Validation

bash -n pmo-roadmap/bin/work-log-read \
  pmo-roadmap/bin/work-log-summarize \
  pmo-roadmap/bootstrap/adopt-project.sh \
  pmo-roadmap/bootstrap/new-project.sh \
  pmo-roadmap/bootstrap/session-intake.sh \
  pmo-roadmap/hooks/pre-commit \
  pmo-roadmap/hooks/post-commit \
  pmo-roadmap/install.sh \
  pmo-roadmap/update.sh \
  pmo-roadmap/tests/adoption-discovery.sh \
  pmo-roadmap/tests/work-log-mvp.sh

pmo-roadmap/tests/adoption-discovery.sh
pmo-roadmap/tests/work-log-mvp.sh

License

MIT.