A week of testing POCs revealed architectural gaps that led to a significant cleanup of our vision, specs, and pipeline structure.
New Artifacts
- Layers of Resolution — A single authoritative vision document replacing three scattered ideation docs. Defines four architectural layers (Components, Workflow Stories, Pages, Customer Forks) and the bidirectional generative cycle where pages produce new workflow stories via the Red Pencil
- Default Pages Catalog — Machine-readable JSON mapping all 7 Storybook workflows (77 steps) to pages, components, use cases, and routes. This is the Layer 2 connective tissue that the AI chat prototype will consume alongside the component catalog
Pipeline Restructuring
- Moved iCashflow specifications (4-layer data model, entity definitions, locked design decisions, implementation blueprint, diagrams) from
0-vision/to1-specs/iCashflow/where they belong - Archived
pencil-workflow-vision.mdandideation-notes.md— both superseded by the consolidated vision doc 0-vision/now contains only the vision document, Excalidraw sketches, and sample bank export files
Fixes
- Admin/User toggle in je-pfm-oneshot corrected: edit buttons now visible in both modes (editing is a User capability, not Admin-only). Mode-aware headings and subtitles match the component-demo behavior
- Imports domain added as the 11th domain to the component demo with full admin and user pages, routes, and workspace dependencies
- pnpm shortcuts removed from root package.json — all apps now use
pnpm --filterconsistently
PRs
- #588 — JE-PFM scope toggle
- #589 — Imports domain, toggle fix, vision consolidation, pipeline restructuring
Read the full story in Layers of Resolution: How We Think About Page Composition.