Skip to content

[agents docs] update modular.md#13568

Merged
yiyixuxu merged 1 commit intomainfrom
update-modular-md
Apr 27, 2026
Merged

[agents docs] update modular.md#13568
yiyixuxu merged 1 commit intomainfrom
update-modular-md

Conversation

@yiyixuxu
Copy link
Copy Markdown
Collaborator

No description provided.

…pect patterns

Distilled from the ErnieImage modular pipeline review (PR #13498):

- New "Common modular conventions" section: skim qwenimage / flux2 / wan /
  helios first, mirroring the references-driven shape of models.md / pipelines.md.
- Promoted "Standalone block reusability" to a Key pattern. Each block (text
  encoder, VAE encoder, prepare-latents, denoise, decoder) must run on its
  own; encoders take raw inputs only, per-prompt expansion happens in a
  dedicated input step inside the core denoise sequence. Replaces old
  gotchas #4 (pre-computed encoder outputs) and #5 (VAE encode in
  prepare-latents).
- Promoted "Flat block assembly" to a Key pattern (was gotcha #7).
- New gotcha "Respect the declared IO system": one rule covering three
  bypass directions — defensive `getattr` reads of declared
  components/state, undeclared `block_state` writes, and direct
  `state.set()` calls that skip `set_block_state` entirely.
- Reworked InputParam/OutputParam section to link to INPUT_PARAM_TEMPLATES /
  OUTPUT_PARAM_TEMPLATES in modular_pipeline_utils.py (the registry is
  dynamic) and added a non-template example.
- Added a distilled-checkpoint exception to the `guidance_scale`-as-input
  gotcha — distilled flux-style models legitimately accept it.
- Dropped the "inputs duplicating derivable state" gotcha (uncommon).

Co-Authored-By: Claude Opus 4.7 (1M context) <noreply@anthropic.com>
@github-actions github-actions Bot added the size/M PR with diff < 200 LOC label Apr 27, 2026
@yiyixuxu yiyixuxu merged commit 0f1abc4 into main Apr 27, 2026
5 checks passed
@yiyixuxu yiyixuxu deleted the update-modular-md branch April 27, 2026 19:56
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

size/M PR with diff < 200 LOC

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant