dipeo-codegen-pipeline

What problem does it solve?

DiPeO's complex code generation pipeline (TypeScript specs → Intermediate Representation → Python/GraphQL) can be daunting to navigate, diagnose, or modify, leading to errors in generated code and slow development. This skill simplifies interaction with the pipeline, providing clear guidance and on-demand documentation.

Core Features & Use Cases

• Intelligent Task Routing: Quickly determines if a codegen task (e.g., simple spec lookup, workflow questions) can be handled directly by the skill or requires escalation to a specialized agent for complex changes.
• On-Demand Documentation: Retrieves precise documentation sections for TypeScript model design, IR builder architecture, code generation workflow, and diagnosis procedures using the doc-lookup skill.
• Diagnosis Guidance: Provides a structured approach to tracing issues from TypeScript specifications through the Intermediate Representation to the final generated Python/GraphQL code, significantly reducing debugging time.
• Use Case: When a generated GraphQL type is incorrect, this skill can guide you through the diagnosis process, helping you pinpoint whether the issue lies in the TypeScript spec, the IR builder, or the generation template, saving significant debugging time and ensuring accurate code.

Quick Start

Example doc-lookup call for naming standards

python .claude/skills/doc-lookup/scripts/section_search.py
--query "naming-standards"
--paths docs/agents/codegen-pipeline.md
--top 1