Untitled


id: WO-0005 title: Floor Plan Optimizer - Residential Layout Permutation Tool requestor: Bruno (CEO) assignee: Pablo (Production Line Architect) participants: [] status: in-progress jira_key: created: 2026-03-28 completed: impacts: process: capability: roles: [] client: Bruno Bock (internal — dogfooding) product_type: Interactive desktop tool (single-page HTML app) production_line: digital-talent language: Bilingual FR/EN (UI in English, content labels in French)

Request

Build an interactive floor plan optimizer that loads a 2D residential floor plan image, lets the user define room boundaries and dimensions, then mathematically generates all valid room-assignment permutations within the fixed building envelope. This is the factory's first internal dogfooding order — the client is the CEO, and the goal is to stress-test the full 9-stage production pipeline.

Intake request: RD-0014

Client Profile

Field Value
Client Bruno Bock (CEO, internal)
Segment Personal residential architecture
Need Explore all mathematically valid room layout combinations for a house floor plan
Language Bilingual FR/EN
AI platform Claude Code (desktop)

Product Definition

# Capability Description
1 Floor plan canvas Upload a 2D floor plan image and display as scalable interactive background
2 Room zone editor Draw rectangular room zones on the plan with name, dimensions (W x L), and function type
3 Constraint engine Define fixed walls (building envelope), min/max room sizes, and adjacency rules
4 Permutation generator Mathematically generate all valid room-assignment combinations within constraints
5 Layout comparator Side-by-side visual comparison of generated layouts with area utilization metrics

Scope

  • In: Interactive HTML app, room drawing on uploaded image, combinatorial layout generation, visual comparison, area calculations
  • Out: 3D rendering, structural engineering, ML-based image recognition, cost estimation, Sweet Home 3D integration
  • Compliance: No external API calls — runs 100% client-side in the browser

Acceptance Criteria

  • Given a floor plan image (PNG/JPG), when uploaded, then it displays as a scalable canvas background
  • Given the canvas, when the user draws rectangular zones, then each zone captures room name, function, and dimensions (W x L in meters)
  • Given a building envelope and defined room functions, when permutation is triggered, then the app generates all mathematically valid room arrangements respecting size constraints
  • Given generated permutations, when displayed, then the user can browse and visually compare layouts side-by-side
  • Given a selected layout, when inspected, then total area utilization % and room adjacency summary are shown
  • Given existing room data from Architecture Maison project, when loaded, then rooms from PRJ-0001-programme-spatial are pre-populated

Definition of Done

  • All acceptance criteria pass
  • Deliverables packaged per deployment manifest
  • QA certification completed (qa-certification.md)
  • Client handover materials ready
  • Order status updated to completed with date

Success Criteria

  • 30-day: CEO has used the tool to explore 3+ layout variations for his actual house project
  • 90-day: Tool is listed in the factory portfolio as a delivered product; production pipeline lessons captured

Agent Context

References

  • RD-0014 (intake request)
  • C:\Projects\Architecture Maison\CLAUDE.md
  • C:\Projects\Architecture Maison\content-in\metamodel-maison.md
  • C:\Projects\Architecture Maison\projets\PRJ-0001-programme-spatial\
  • production-lines/digital-talent/

Constraints

  • Follow production line stages: production-lines/digital-talent/
  • Naming: WO-0005-floor-plan-optimizer per TFD-0009
  • Do not expose internal factory names in client deliverables
  • Output: single self-contained HTML file (no external dependencies)
  • Must run offline — zero API calls, 100% client-side JavaScript
  • Follow HTML interactive pattern with Claude website aesthetic

Verification

  • Run: open output/*.html in browser, upload floor plan, draw 4+ rooms, generate permutations
  • Expected: multiple valid layout options displayed with dimensions and area calculations

Production Details

Deliverable Set

Artifact Description
floor-plan-optimizer.html Self-contained interactive floor plan tool
user-guide.html Usage instructions (HTML, interactive)

Skill Inventory

N/A — this is a standalone tool, not a Claude Code agent.

Customization Values

Dimension Value
Methodology Residential architecture (metamodel-maison.md)
Repository tool N/A (standalone)
Diagram standard 2D floor plan (canvas-based)
Publication target Local desktop browser
Model selection N/A (no AI runtime dependency)

Dependencies

Dependency Source Status
Floor plan image (scan or export) Bruno — from Architecture Maison project Available (.sh3d exports)
Room program (pièces, fonctions, surfaces) PRJ-0001-programme-spatial Available

Build Estimate

Component Effort
Canvas engine + image upload Small
Room zone editor Medium
Permutation algorithm Medium
Layout comparator UI Medium
Testing + polish Small
Total Medium