FOXHALL CLARITY v16 — OPTION ATLAS AMENDMENT
Non-negotiable catalog requirement
Foxhall Clarity currently contains 130 construction and finish tasks. The v16 catalog shall provide a minimum of 20 decision-ready options for every task in every investment tier:
- Essential: at least 20 options per task
- Enhanced: at least 20 options per task
- Signature: at least 20 options per task
Minimum launch catalog: 130 tasks × 3 tiers × 20 options = 7,800 tier-specific option cards.
The 95 design philosophies and 28 palettes remain separate ranking inputs. They shall not be pre-multiplied into millions of duplicate option records.
Core rule
All tiers must meet the same applicable code, safety, structural, moisture, substrate, accessibility, infection-control, and manufacturer requirements. Essential may simplify visible material, pattern, customization, procurement, or installation detail. It may never omit a required assembly or technical prerequisite.
Four option classes
Every task belongs to one of four option classes so the catalog does not force decorative language onto technical work.
- Finish and visual expressions
- Flooring, paint, wall finish, tile, trim, paneling, ceilings, millwork, stairs, cladding and hardscape.
- Assembly and performance strategies
- Waterproofing, moisture mitigation, subfloor preparation, insulation, roofing, ventilation, acoustic work, healthcare controls and specialty systems.
- Product and fixture archetypes
- Lighting, plumbing, hardware, windows, doors, appliances, glass, mirrors, controls and window treatments.
- Planning and control approaches
- Samples, mockups, approvals, protection, reopening, sequencing, procurement and project controls.
Twenty decision lanes
Each task receives task-specific versions of these twenty lanes. Labels and specifications must be written for the actual task; generic filler is prohibited.
| # | Decision lane | Essential expression | Enhanced expression | Signature expression |
|---|---|---|---|---|
| 1 | Repair and retain | Repair serviceable work and replace only failed areas | Repair, selectively replace and visually blend | Conservation-grade restoration or exact replication |
| 2 | Stock classic | Reliable stock profile or finish | Premium stock selection with coordinated details | Custom-matched classic composition |
| 3 | Stock contemporary | Simple current stock expression | Premium contemporary selection | Integrated architectural contemporary expression |
| 4 | Low disruption | Minimum demolition and rapid reopening | Phased work with improved detailing | Fully planned occupied-space execution with concealed transitions |
| 5 | Quick turn | Readily available materials and straightforward installation | Short-lead premium materials | Preplanned custom package with controlled fabrication schedule |
| 6 | Easy maintenance | Common, repairable and easy-clean materials | Higher-performance cleanability and replaceable components | Seamless or integrated detailing with documented care plan |
| 7 | High durability | Appropriate residential/light-commercial performance | Upgraded wear, impact or duty rating | Heavy-duty or institutional performance with premium finish |
| 8 | Moisture resilient | Moisture-appropriate standard assembly | Upgraded moisture management and detailing | Fully coordinated moisture-control system and monitoring points |
| 9 | Healthy material | Low-emitting readily available selection | Third-party-certified or documented low-emitting system | Material-health-led specification with full documentation |
| 10 | Accessible and legible | Remove obvious barriers and contrast conflicts | Improved reach, clearance, threshold and visual legibility | Integrated universal-design solution with refined detailing |
| 11 | Acoustic and quiet | Basic noise reduction or resilient separation | Coordinated absorption, isolation and equipment-noise control | Modeled or specialist-designed acoustic system |
| 12 | Preservation match | Closest practical stock match | Custom color/profile matching | Exact replication, salvage or reversible intervention |
| 13 | Natural material | Accessible natural or natural-look material | Higher-grade authentic natural material | Bespoke, responsibly sourced natural material package |
| 14 | Texture led | One controlled tactile or low-sheen expression | Layered texture with coordinated transitions | Hand-finished or custom-fabricated material depth |
| 15 | Pattern and layout | Straightforward layout with controlled cuts | Planned pattern, border or focal alignment | Bespoke geometry, inlay, bookmatching or integrated datum control |
| 16 | Color led | Restrained stock color direction | Coordinated multitone or color-blocked expression | Custom color, stain, glaze or artist-led chromatic composition |
| 17 | Performance led | Meet the known use requirement | Exceed the expected duty with improved warranty or serviceability | Highest appropriate performance with testing and documentation |
| 18 | Semi-custom | Stock components with selected modifications | Semi-custom sizing, finish and coordination | Fully coordinated semi-custom package with upgraded detailing |
| 19 | Custom crafted | Limited field-built or shop-modified detail | Custom fabrication at focal areas | Full custom fabrication, mockup and shop-drawing control |
| 20 | Signature integrated | One restrained feature | Multiple coordinated architectural details | Fully integrated bespoke system forming the room identity |
For technical tasks, these lanes translate into assemblies, verification plans, capacity choices, sequencing strategies and control levels—not cosmetic variants.
Required fields on every option card
Each of the 7,800 option cards must contain:
- Client-facing option name
- Construction-facing name
- Investment tier
- Option class
- Concise visual or functional outcome
- Complete baseline specification
- What changes from the lower tier
- Best-use cases
- Poor-use cases
- Primary tradeoff
- Required substrate or existing-condition prerequisites
- Required field verification
- Code, standard or manufacturer dependency
- Maintenance expectation
- Expected disruption level
- Lead-time class
- Installer skill or specialist requirement
- Relative material-cost band
- Relative labor-intensity band
- Warranty or serviceability note
- Accessibility implications
- Moisture and environmental implications
- Style affinities
- Palette affinities
- Room-type compatibility
- Renderer prompt language
- Client explanation
- Builder note
- Confidence level
- Research-basis label and review date
Research and authority labels
Every card must distinguish:
- Required baseline — code, safety, accessibility or recognized technical minimum
- Standard-informed — based on recognized industry guidance
- Manufacturer-dependent — final selection requires current technical data and approved assembly
- Design-led — aesthetic or spatial choice rather than a technical requirement
- Field-dependent — cannot be finalized until conditions are documented
- Specialist review — engineer, architect, electrician, plumber, roofer, accessibility consultant, healthcare specialist or other qualified party may be required
Ranking instead of menu dumping
The mobile interface must never display twenty large cards by default.
Default view:
- Best fit: five ranked options
- Foxhall standard: one recommended option
- Recently used
- Saved favorites
- Browse all 20+
Search and filters:
- Style compatibility
- Palette compatibility
- Room type
- Residential, commercial or healthcare
- Essential, Enhanced or Signature
- Repair-first
- Preservation
- Low disruption
- Fast availability
- Easy maintenance
- High durability
- Moisture resistance
- Accessibility
- Acoustic comfort
- Healthy materials
- Natural materials
- Stock, semi-custom or custom
- Labor intensity
- Material cost
- Lead time
- Specialist required
- Field verification required
Ranking model
Initial recommendation score:
- Room compatibility: 20 points
- Selected tier fit: 15 points
- Design philosophy fit: 15 points
- Client priorities: 10 points
- Existing-condition fit: 10 points
- Performance requirement: 10 points
- Budget position: 8 points
- Disruption tolerance: 5 points
- Maintenance preference: 4 points
- Lead-time preference: 3 points
Penalties:
- Missing mandatory prerequisite: option remains viewable but receives a visible hold
- Incompatible room or exposure: strong warning and ranking penalty
- Specialist requirement not acknowledged: warning
- Stale manufacturer or price reference: warning
- Duplicate outcome already selected: ranking penalty
Tier behavior
Users may browse and select from any tier at any time.
Selecting an option from another tier must not be blocked. The application shows:
- You are viewing an Enhanced expression inside the Essential concept
- Likely effect on cost
- Likely effect on labor
- Likely effect on disruption
- Required supporting assemblies
The user may:
- Keep the option in the current concept
- Promote the concept tier
- Create a hybrid concept
- Duplicate into a new concept
- Save as a custom Foxhall standard
No-gate behavior
- Options remain browsable without a photo.
- Options remain selectable without dimensions.
- Options remain comparable without pricing.
- Boards export with placeholders and confidence labels.
- Missing information reduces confidence; it never disables the tool.
- Technical holds are warnings and release gates, not navigation locks.
- Every option supports a custom note and custom specification.
- Every list includes Custom / Not listed.
Comparison
Users can compare up to four option cards side by side across:
- Visual outcome
- Tier
- Baseline specification
- Material quality
- Installation complexity
- Required preparation
- Durability
- Maintenance
- Disruption
- Lead time
- Accessibility
- Moisture suitability
- Price band
- Labor intensity
- Specialist requirement
- Tradeoffs
- Verification needs
Bundles and recipes
The catalog must also support coordinated bundles so users do not have to choose every system independently.
Examples:
- Chesapeake Coastal Reset
- Refined Chesapeake
- Collected Coastal Craft
- Japandi Calm Reset
- Japandi Crafted Sanctuary
- Feng Shui Clear Arrival
- Feng Shui Supported Living
- Biophilic Restorative Layers
- Medical Office Rapid Reopen
- Medical Office Durable Calm
- Older-Home Stewardship
- Historic Trim Continuity
- Sensory-Regulated Interior
- Aging-in-Place Quiet Upgrade
A bundle preselects options but never locks them.
Technical baseline rule by major source family
- Wood flooring: moisture, substrate, acclimation, installation and manufacturer requirements remain mandatory at every tier.
- Tile: prepared substrates, appropriate methods, coverage, movement accommodation and wet-area requirements remain mandatory at every tier.
- Resilient flooring: moisture, substrate, adhesive and product-system requirements remain mandatory at every tier.
- Architectural millwork: material, fabrication, finish and installation quality criteria remain explicit.
- Kitchens and baths: clearance, fixture placement, support-space and accessible-planning requirements remain visible.
- Lighting: quantity, quality, glare, task needs, controls and application criteria are separated from decorative fixture choice.
- Accessibility: applicable scoping and technical requirements are never treated as upgrades.
- Roofing and exterior: system design, flashing, drainage, weather exposure and manufacturer requirements are not reduced by tier.
- Moisture control: water entry, condensation and assembly drying are treated as system requirements.
- Healthcare: risk assessment, infection prevention, surfaces, built-ins and facility requirements remain separate from aesthetics.
- Windows and doors: certified performance data and local climate/code requirements are tracked separately from appearance.
Mobile interaction
Option sheet layout:
- Search field
- Five recommended cards
- Filter button
- Favorites and recent choices
- Browse all 20+
- Compare tray
- Custom option
Each collapsed card shows only:
- Name
- One-sentence outcome
- Tier
- Three key tags
- Relative cost and disruption
- Select button
Expanding a card reveals the full specification and research fields.
Data architecture
Do not store 7,800 repetitive full records inside one monolithic HTML file.
Recommended structure:
- task-definitions.js — 130 task definitions
- option-archetypes.js — reusable decision lanes and tier logic
- task-option-overrides.js — task-specific labels, assemblies and exceptions
- standards-map.js — authority and verification metadata
- option-engine.js — generates and ranks the final cards
- favorites.js — user standards and recent choices
Only the active task's twenty options are generated into the interface.
Automated acceptance tests
The release fails if any of the following is true:
- Any task has fewer than 20 Essential options.
- Any task has fewer than 20 Enhanced options.
- Any task has fewer than 20 Signature options.
- Any option is missing a tradeoff.
- Any option is missing prerequisites or a clear Not applicable statement.
- Any option is missing a research-basis label.
- Any Essential option omits a mandatory safety or assembly baseline.
- Tier specifications are textually identical without an explicit reason.
- Duplicate option names occur within a task and tier.
- The mobile sheet opens with all twenty cards expanded.
- Missing photos, dimensions or prices disable browsing or selection.
- Existing v12-v15 project choices fail migration.
Initial audit sample
Before release, manually audit all sixty options for at least these representative tasks:
- LVP
- Hardwood installation
- Tile flooring
- Paint
- Wallpaper
- Base and casing
- Full-height paneling
- Kitchen cabinetry
- Countertops
- Shower waterproofing
- Vanities
- Architectural lighting
- Plumbing fixtures
- Window replacement
- Roofing
- Deck and railing
- Moisture mitigation
- Healthcare resilient and flash cove
- ICRA and reopening controls
- Accessibility upgrades
Final product rule
The catalog should feel expansive without making the user browse an encyclopedia.
Show the five choices most likely to work. Keep twenty or more researched choices available. Explain why each choice fits, what it costs in complexity, and what must be verified before Foxhall relies on it.