tpdc

TPDC Engine

AI-powered development workflow engine with structured pipelines for feature development, bug fixing, refactoring, code assessment, planning, and discovery.

Installable as a Claude Code plugin or usable as a standalone CLI.

Quick Start

As a Claude Code Plugin

# Inside Claude Code:
/plugin marketplace add Mtrejo11/tpdc-engine
/plugin install tpdc@tpdc
/reload-plugins

Then use any command:

/tpdc:show
/tpdc:discovery "We need to add real-time notifications to the app"
/tpdc:fix "Login form crashes on empty email submission"

As a Standalone CLI

npx tpdc show
npx tpdc solve "Add password reset flow with email verification"
npx tpdc fix "Dashboard charts don't render on Safari"

From Source

git clone https://github.com/Mtrejo11/tpdc-engine.git
cd tpdc-engine
npm install
npm run build
node dist/cli.js show

---

Commands

Execution Commands

Command	Purpose	Mutation	Example
solve	Run the full pipeline	Yes	tpdc solve "Add password reset flow with email verification"
fix	Bug-fix with input normalization	Yes	tpdc fix "Login form crashes on empty email submission on iOS"
refactor	Structural improvement	Yes	tpdc refactor "Extract authentication logic into a dedicated service"
develop	End-to-end orchestrated workflow	Yes	tpdc develop feature "Add user profile settings page"

Analysis Commands (Safe Mode Only)

Command	Purpose	Example
discovery	Frame a vague idea before execution	tpdc discovery "We need to add real-time notifications"
assess	Security, performance, or architecture audit	tpdc assess "Evaluate SQL injection risks in the search API"
plan	Technical implementation plan with phases	tpdc plan "Migrate from REST to GraphQL"

Inspection Commands

Command	Purpose	Example
show	List recent runs or inspect a specific run	tpdc show / tpdc show d2ae7adf
diff	Show patch diffs for a mutation run	tpdc diff d2ae7adf

---

How It Works

Every command runs through the TPDC engine pipeline:

intake → design → decompose → execute → validate

Each stage is powered by a pluggable capability — an LLM prompt with input/output schema validation.

Pipeline Stages

Stage	What It Does
Intake	Normalizes the request into a structured ticket with acceptance criteria
Design	Produces an Architecture Decision Record (ADR) with scope, risks, alternatives
Decompose	Breaks the design into ordered implementation steps with dependencies
Execute	Generates execution artifacts or patches (safe or mutation mode)
Validate	Evaluates execution quality, scores 0-100, surfaces findings

Execution Modes

Safe mode (default): Analyzes and plans without touching any files.

Mutation mode (--apply): Generates patches, validates them via dry-run, shows a preview, and applies after confirmation.

tpdc fix "Bug description" --apply --repo-root ~/my-project

Mutation flow:

execute-patch → dry-run → preview → confirmation → git apply → validate

---

Command Details

solve

Full pipeline execution. The general-purpose command.

tpdc solve "Add two-factor authentication to the login flow"
tpdc solve "Implement dark mode" --apply --repo-root ~/project

fix

Bug-fix flow. Normalizes bug reports by extracting platform, component, actual/expected behavior. If context is missing, suggests a clarified bug report.

tpdc fix "Dashboard charts don't render on Safari 17"
tpdc fix "Form validation error messages disappear after 1 second on Android"

Output includes: detected context, missing fields, validation checklist, suggested clarified input.

refactor

Structural improvement without changing functional behavior. Detects the refactor category automatically:

Category	Triggers
Extraction	extract, pull out, move to, factor out
Decomposition	split, break down, decompose
Consolidation	consolidate, merge, centralize, DRY
Simplification	simplify, remove, clean up, flatten
Architecture	introduce layer, decouple, separate concerns

tpdc refactor "Extract payment processing into a dedicated service"
tpdc refactor "Split the UserProfile component into smaller sub-components"
tpdc refactor "Consolidate duplicate API error handling across services"

Output includes: targets, risk level (low/medium/high), structural issues, strategy, affected files, expected benefits.

assess

Analysis/audit mode. Auto-detects the assessment category: