The design pattern

Two-pass additive page design: write one design brief per listed surface, then build one real page per committed brief through the shared milestone unit. Use when existing pages should inform and constrain the new design.

design — additive page design

Two passes of the shared milestone unit as ordinary pattern data: first write committed design briefs from the page index, then build one real page per brief. Both passes relax the baseline gate and pass a prompt_prefix, which is the whole mechanism by which one shared unit does two different jobs.

design

[header]
name = "design"
version = "1.1"
description = """
Two-pass additive page design: write one design brief per listed surface, then build one real page per
committed brief through the shared milestone unit. Use when existing pages should inform and constrain
the new design.
"""
entry = "main"

The top-level rows are the two passes; each pass's milestone unit supplies the sprint rows beneath.

design

[[header.levels]]
label = "pass"

[[header.parameters]]
name = "pages_source"
kind = "file"
default = "pages.md"
description = "The surface index for the design run."

main

Pass one: one brief per listed surface, written from the page index and committed.

design

[[blocks.main]]
type = "sub-pattern"
pattern = "milestone"
parameters = { baseline_relaxed = "true", prompt_prefix = "design/briefs/", review_prompt = "design/briefs/review", plan_source = "{{pages_source}}" }

Pass two: one real page per committed brief. The plan source is the brief directory pass one wrote, so the passes are coupled by that path and nothing else.

design

[[blocks.main]]
type = "sub-pattern"
pattern = "milestone"
parameters = { baseline_relaxed = "true", prompt_prefix = "design/pages/", review_prompt = "design/pages/review", plan_source = "docs/page-design/briefs" }