Drydock

Drydock turns specifications into working software.

Specification driven. Agile. Test driven. Dependency-aware builds. A dedicated web console. Enterprise guardrails. No API keys — Drydock runs on your existing Claude or Codex subscription.

▶ START HERE — Quick Start

Specification · Installation · Comparison matrix · Overview deck · Contributing

Overview

Drydock turns specifications into working software.

Drydock imports your source material, creates stories using agile best practices, decomposes requirements into typed blueprints (stories) related using a graph database. Drydock will run context aware builds. Each story has deterministic test driven acceptance criteria.

• Specification Driven Delivery producing governed reproducible working software.
• Agile Methedology to decompose buildable stories and for product owner / llm review.
• Test driven development with acceptance criteria embedded in each Story/Blueprint.
• Dependency graph of stories in MANIFEST.md to relates nodes/stories and order builds.
• Context compression and Grouping for context aware builds.
• QuarterDeck web console for easy questionaires, observability, and user direction.
• Enterprise guardrails with embedded branding, best practices, and build gates

Drydock Documentation

Getting started

Prerequisites

• Python 3.11 or later — python3 --version
• Install uv
  • curl -LsSf https://astral.sh/uv/install.sh | sh (macOS/Linux),
  • brew install uv
  • winget install --id=astral-sh.uv -e (Windows)
• claude or codex CLI, authenticated, in your PATH (claude --version, codex --version)

Install Drydock

uv tool install drydock-sdd     # or: pipx install drydock-sdd
drydock --version

Configure Drydock

export PROJECTS="$HOME/projects" # main directory you keep your code/projects/git
mkdir -p "$PROJECTS/drydock"     # the drydock workspace

drydock config set llm_provider claude          # or codex
drydock config set drydock_model sonnet         # or gpt-5.4 or other models
drydock config set drydock_workspace "$PROJECTS/drydock"
drydock config set drydock_build_directory "$PROJECTS"
drydock config show

Build workflow

init → import → analyze → plan → build → refit → build

The Drydock CLI

ai calls your subscription CLI agent; all other commands are deterministic.

# ── S ── SET UP ──────────────────────────────────────────────────────────
    drydock config show                        # Show configuration values and sources
    drydock config set        <var> <value>    # Set a configuration value
    drydock init              MyApp            # Create the target workspace
    drydock status                             # Status dashboard
    drydock status            MyApp            # Summary and plan state

# ── A ── ANALYZE ─────────────────────────────────────────────────────────
    drydock import            MyApp <file|dir> # Import sources into the workspace
ai  drydock analyze           MyApp            # Epic decomposition into stories & blockers
    drydock validate          MyApp            # Validate Build Plan
ai  drydock score spec        MyApp            # Audit imported raw specifications
    drydock run quarterdeck   MyApp            # Web interface
ai  drydock plan              MyApp            # Grooming and dependency graph

# ── I ── IMPLEMENT ───────────────────────────────────────────────────────
ai  drydock build             MyApp            # Iterative context-aware process
    drydock build status      MyApp            # Show build state
    drydock score ac          MyApp            # Verify Story acceptance criteria
    drydock score build       MyApp            # Post-build report: repairs, tokens, cache
ai  drydock score release     MyApp            # Score project success criteria (EARS)

# ── L ── LOOP ────────────────────────────────────────────────────────────
ai  drydock refit             MyApp            # Diff -> ticket -> dependency graph
ai  drydock document          MyApp            # Project documentation automation
ai  drydock document generate MyApp            # AI pass only
    drydock document assemble MyApp            # Assembly only
    drydock publish           <Source.md>      # Render Markdown to HTML/PDF

The QuarterDeck Web Server

QuarterDeck is the Agile web surface between the Commander (product owner) and Crew (LLM agents).

drydock run quarterdeck <Target>

Glossary

Contributing

Help test Drydock on real projects. Open issues. See CONTRIBUTING.md.

License (See LICENSE)

MIT License

Copyright (c) 2026 Web Cloud Studio

Permission is hereby granted, free of charge, to any person obtaining a copy
of this software and associated documentation files (the "Software"), to deal
in the Software without restriction, including without limitation the rights
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
copies of the Software, and to permit persons to whom the Software is
furnished to do so, subject to the following conditions:

The above copyright notice and this permission notice shall be included in all
copies or substantial portions of the Software.

THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
SOFTWARE.