Vision Consolidated, Pipeline Restructured

Unified the architectural vision into a single document, created the default-pages catalog, restructured the SDLC pipeline, and fixed the Admin/User toggle.

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/ to 1-specs/iCashflow/ where they belong
  • Archived pencil-workflow-vision.md and ideation-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 --filter consistently

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.