Open Source · Apache 2.0 · 29 skills

Your PDLC was built for humans.
Now agents do the work.

tGD is an open-source skill pack for Claude Code, Codex, Gemini CLI, OpenCode, Pi, and Hermes. It wraps your product development lifecycle (PDLC) in the gates your team already trusts — spec before code, tests before claims, human sign-off before release.

Get started → 🎬 View the intro deck
The problem

Agents can code. Nobody holds them accountable.

Without tGD

  • "Should work" — the tests never ran
  • 500 lines written before reading your codebase
  • Spec skipped, broken PR shipped, agent gone

With tGD

  • "34/34 pass" — with the output to prove it
  • Reads the codebase first, ships 50 lines that pass
  • Spec → Plan → Code → Verify — no stage skipped
How it works

Seven stages. Every one gated.

Each stage hands a signed-off artifact to the next. If Verify fails, the pipeline stops and the work goes back to Develop — nothing broken reaches Release.

01
Map
/tgd-map
CONTEXT.md
02
Define
/tgd-define
PRD → DESIGN (UI) → SPEC
03
Plan
/tgd-plan
TASKS.md
04
Develop
/tgd-develop
src/ + tests/
05
Verify
/tgd-verify
TEST-REPORT.md
06
Review
/tgd-review
REVIEW.md
07
Release
/tgd-release
CHANGELOG · METRICS + deploy
Stage Input Output Agent does Human sign-off
01 Mapsrc/ + codebaseCONTEXT.md Scans codebase, maps real UI sources DEV — reviews CONTEXT.md
02 DefineCONTEXT.md + intentPRD → DESIGN (UI) → SPEC Writes PRD, routes 0/2/3 UI design, finalizes SPEC PM + DESIGN (UI) — own product and UI direction
03 PlanCONTEXT · PRD · DESIGN (UI) · SPECTASKS.md + BDD AC Context-grounded task decomposition DEV — signs off TASKS.md
04 DevelopTASKS · SPEC + src/src/ + tests/ TDD in a worktree sandbox DEV — reviews code, signs off
05 Verifysrc/ · tests/ + CATALOGTEST-REPORT.md Tests + E2E + regression + design QA QA — signs off or blocks
06 Reviewsrc/ · TEST-REPORTREVIEW.md 5-axis code review + UI conformance QA + DEV + DESIGN (UI) — sign off REVIEW.md
07 ReleaseAll signed-off artifactsCHANGELOG · METRICS + deploy Commit → CI → deploy PM — final sign-off gate
Why bother

What changes when you adopt it

Illustrative PDLC efficiency gains — not measured data.

Features released per person, per sprint
Before tGD With tGD Projected
0 5 10 15 tGD adopted agents ramped Sprint 1 — 2 features Sprint 2 — 3 features Sprint 3 — 2 features Sprint 4 — 3 features Sprint 5 — 5 features Sprint 6 — 7 features Sprint 7 — 10 features Sprint 8 — 13 features Steady state — 15+ features (projected) 5 7 10 13 15+ plateau · ~2–3 / sprint S1S2S3S4 S5S6S7S8 steady
Features released per person per sprint (illustrative)
Sprint 1Sprint 2Sprint 3Sprint 4Sprint 5Sprint 6Sprint 7Sprint 8Steady (projected)
232357101315+
Illustrative projection — not measured data.
5×
More features shipped per sprint — agents handle spec → code → test → review, humans set direction and sign off.
Throughput
80%
Fewer regression escapes — BDD acceptance criteria + an automated regression catalog catch defects before merge.
Quality
10×
Faster spec-to-deploy cycle — weeks become days, with a full audit trail (PRD → TASKS → CHANGELOG).
Velocity
Quick start

Thirty seconds to install. One command to start.

1

Clone & set up

Auto-detects your installed CLIs and links every skill and command.

git clone https://github.com/yhwangtw/tgd.git && cd tgd bash setup.sh
2

Map your codebase

The agent scans your project and writes CONTEXT.md, including a UI Landscape when frontend code exists.

/tgd-map
3

Define your first feature

The agent completes PRD → 0/2/3 UI design → SPEC inside the same Define stage.

/tgd-define I want to add user authentication
Claude CodeCodex CLIGemini CLIOpenCodePiHermes
FAQ

Common questions

Which agents does tGD support?

Claude Code, Codex CLI, Gemini CLI, OpenCode, Pi Coding Agent, and Hermes. One bash setup.sh detects what you have installed and links the right format for each.

Does tGD send my code anywhere?

No. tGD is plain Markdown skills and shell scripts that run inside your own agent — no server, no telemetry, no account. Your code never leaves the tools you already use.

Do I need to install anything besides my agent?

No — clone the repo and run bash setup.sh. It detects your CLI, links everything, and installs the tgd command for updates.

My agent has no slash commands. Does tGD still work?

Yes. Say "plan this feature" in natural language — the router skill maps intent to the right workflow automatically.

Does it work on an existing project?

Yes — /tgd-map scans the existing codebase first, so every later stage works from real context.

Can I customize the pipeline?

Yes. Every stage is a plain-Markdown skill in skills/ — edit them to match your team's workflow.