How dongduong2001/pudo-code-system works
PUDO is an operating layer for AI-assisted development: developers initialize repository-specific agent rules, guide work through Plan–Understand–Develop–Optimize, and verify readiness with checks and quality gates. Its runtime has a CLI, an MCP server exposing corresponding agent tools, and a web product surface for workflow guidance, rule generation, scoring, playbooks, and documentation. The excerpts show CLI/MCP wiring and selected MCP tool behavior; web component connections and several tool internals are not shown, so those are represented without speculative edges.
Main entry points: server.ts MCP Server · core.ts MCP Core · cli.js PUDO CLI · pudo_init.ts Init & Playbooks
Components 25
CLI Engine
- PUDO CLI
src/cli.js - Prompt Linter
src/prompt-linter.js
MCP Server
- MCP Server
packages/pudo-mcp-server/src/server.ts - MCP Core
packages/pudo-mcp-server/tools/core.ts - Init & Playbooks
packages/pudo-mcp-server/tools/pudo_init.ts - Rule Validation
packages/pudo-mcp-server/tools/pudo_check.ts - Readiness Scoring
packages/pudo-mcp-server/tools/pudo_score.ts - Workflow Diagnosis
packages/pudo-mcp-server/tools/pudo_doctor.ts - Context Packs
packages/pudo-mcp-server/tools/pudo_context_pack.ts - Quality Gates
packages/pudo-mcp-server/tools/pudo_quality_gate.ts - Session Handoff
packages/pudo-mcp-server/tools/pudo_session.ts - Workflow Prompts
packages/pudo-mcp-server/tools/pudo_prompts.ts - Resources
packages/pudo-mcp-server/tools/pudo_resources.ts
Web Product
- Localized Landing
apps/web/app/[locale]/page.tsx - Translations
apps/web/lib/i18n - Workflow Guide
apps/web/components/WorkflowSection.tsx - Rule Generator
apps/web/components/ConfigGenerator.tsx - Readiness Calculator
apps/web/components/ScoreCalculator.tsx - Playbooks
apps/web/lib/data/playbooks.ts - Rule Templates
apps/web/lib/data/rules-templates.ts - Scoring Rubric
apps/web/lib/data/score-rubric.ts - Docs Index
apps/web/components/DocsIndex.tsx - MCP Hub
apps/web/components/McpHub.tsx
Other components
- Developer
- Coding Agent
Connections 22
- Developer → PUDO CLI: runs commands
README.md - PUDO CLI → Prompt Linter: uses linter
src/cli.js - Coding Agent → MCP Server: calls tools
README.md - MCP Server → Init & Playbooks: registers
packages/pudo-mcp-server/src/server.ts - MCP Server → Rule Validation: registers
packages/pudo-mcp-server/src/server.ts - MCP Server → Readiness Scoring: registers
packages/pudo-mcp-server/src/server.ts - MCP Server → Workflow Diagnosis: registers
packages/pudo-mcp-server/src/server.ts - MCP Server → Context Packs: registers
packages/pudo-mcp-server/src/server.ts - MCP Server → Quality Gates: registers
packages/pudo-mcp-server/src/server.ts - MCP Server → Session Handoff: registers
packages/pudo-mcp-server/src/server.ts - MCP Server → Workflow Prompts: registers
packages/pudo-mcp-server/src/server.ts - MCP Server → Resources: registers
packages/pudo-mcp-server/src/server.ts - MCP Server → MCP Core: resolves root
packages/pudo-mcp-server/src/server.ts - Init & Playbooks → MCP Core: loads engine
packages/pudo-mcp-server/tools/pudo_init.ts - Rule Validation → MCP Core: uses helpers
packages/pudo-mcp-server/tools/pudo_check.ts - Readiness Scoring → MCP Core: uses helpers
packages/pudo-mcp-server/tools/pudo_score.ts - Workflow Diagnosis → MCP Core: uses helpers
packages/pudo-mcp-server/tools/pudo_doctor.ts - Context Packs → MCP Core: uses helpers
packages/pudo-mcp-server/tools/pudo_context_pack.ts - Quality Gates → MCP Core: uses helpers
packages/pudo-mcp-server/tools/pudo_quality_gate.ts - Session Handoff → MCP Core: uses helpers
packages/pudo-mcp-server/tools/pudo_session.ts - Resources → Init & Playbooks: uses playbook logic
packages/pudo-mcp-server/tools/pudo_resources.ts - MCP Core → PUDO CLI: loads engine
packages/pudo-mcp-server/tools/core.ts