메뉴
Guide for understanding and working with the workflow compiler and runtime in src/seer/core/. Use when implementing node executors, debugging compilation/runtime issues, adding workflow features, or understanding the workflow execution architecture.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
use when creating or updating end-to-end tests for the Seer application. This skill provides guidance on how to structure and implement e2e tests effectively.
React Flow best practices for workflow canvas in seer-frontend. Use when modifying WorkflowCanvas, adding new block types, debugging node rendering issues, or optimizing React Flow performance.
Apply Seer design system patterns when creating or modifying UI components. Auto-triggers for badge, button, input, and form components in src/components/.
Use this when you are asked to debug production errors
Guide for adding new external integrations (OAuth or API key-based) to seer. Use when implementing new service integrations like Google, GitHub, Slack, etc.
Context about runtime credential resolution in seer. Use when understanding how OAuth tokens, resources, and secrets are resolved for tool execution.
| name | workflow-compiler |
| description | Guide for understanding and working with the workflow compiler and runtime in src/seer/core/. Use when implementing node executors, debugging compilation/runtime issues, adding workflow features, or understanding the workflow execution architecture. |
| allowed-tools | Read, Grep, Glob, Bash(pytest:*) |
Key principle: src/seer/core/ is pure compilation + runtime — NO database or HTTP. API layer orchestrates compiler + persistence.
WorkflowSpec (JSON) → WorkflowCompiler.compile() (validate → transform → LangGraph) → CompiledGraph → Runtime (node executors + state + checkpointing)
src/seer/core/ → compiler/ (parse · type_env · validate_refs · lower_control_flow · emit_langgraph) · runtime/ (global_compiler · nodes · execution · state · input_validation · validate_output) · schema/ (models · jsonschema_adapter) · expr/ (evaluator · typecheck) · errors.py · registry/ · triggers/
runtime/nodes.py)tool · llm · code · conditional · transform · trigger · input · output · extract · if_else · for_each
State keys: user, node_outputs, workflow_inputs, messages, interrupts. Input resolution: static | input (node output ref) | expression (${node.field}) | workflow_input. Checkpointing: MemorySaver (dev) · DatabaseCheckpointer (prod).
WorkflowCompilerError → ValidationPhaseError (1–3) · TypeEnvironmentError (2) · LoweringError (4) · ExecutionError → EvaluationError (runtime)
schema/models.py, add to Node unionruntime/nodes.pycompiler/compiler.pycompiler/validate_refs.py if neededtests/core/Best practices: No DB/HTTP in compiler · use StrictModel · nodes return partial state updates · always add unit + integration spec tests for src/seer/core/ changes
| File | Purpose |
|---|---|
src/seer/core/runtime/global_compiler.py | WorkflowCompilerSingleton |
src/seer/core/runtime/nodes.py | All node executors |
src/seer/core/schema/models.py | WorkflowSpec, Node, InputDef, OutputContract |
src/seer/core/compiler/validate_refs.py | Reference validation |
src/seer/core/errors.py | Error hierarchy |
src/seer/core/README.md | Architecture overview |
/workflow-validation