), making activity data unreadable. Add headers like 'Property' and 'Activities'.Footer shows fixed date '2026-06-23' while header says 'Updated today'—inconsistent data freshness. Use dynamic date.Abbreviation 'PM' used without explanation in header. Add tooltip or brief clarification (e.g., 'PM: Project Manager').Missing help badge on 'Date range' button. Add ? icon with tooltip explaining date range functionality.Alternative Presentations:Portfolio Activity Calendar — Better for spotting trends but less suitable for detailed activity review. Tradeoff: visual scanning vs. data precision.
Quick win: Add table headers to activity grid (e.g., 'Property', 'Activities'). New page idea: Portfolio Glance: High-level summary of activity metrics (e.g., '12 active properties, 47 activities this week') linking to detailed log.
! 3.0
properties/timeline.html
audience: mixed · depth: 3
A visually clear but stale timeline of properties that lacks actionable insights, navigation aids, and current data.
T1: val=3 red=4 help=2
T2: clarity=3 design=4 nav=2
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: fail empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Timeline data is outdated (data_freshness: fail); update to reflect current property activity.
- Future dates (2025-2026) shown in timeline contradict '2011–present' claim; remove future dates.
- Abbreviation 'Mo' (for months) used without explanation; add tooltip or legend.
- No back link to main properties page; add breadcrumb or back button.
Alternative Presentations:Properties Timeline Table — Better for detailed data lookup but less visual for duration; tradeoff: more data at a glance vs. visual summary.
Quick win: Add a legend explaining 'Mo' (e.g., 'Mo = Months') near the timeline header. New page idea: Properties list with timeline filter (show active properties only) instead of historical view.
! 3.3
properties/2087-dogwood-recap.html
audience: mixed · depth: 3
Misleading status header and missing actionable elements undermine a well-structured work order recap.
T1: val=4 red=4 help=3
T2: clarity=3 design=4 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: pass empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Header incorrectly states 'COMPLETED' when 0/49 work orders are complete; change to 'IN PROGRESS' or similar
- Add ? help badges for work order codes (P1, P2, W01a) to explain abbreviations
- Add back navigation to properties list and links to related pages (e.g., PM dashboard)
- Replace monospace font in table with standard sans-serif for portal consistency
Alternative Presentations:2087 Dogwood — Work Order Summary — Faster for quick status checks but loses detailed work order context; better for mobile view
Quick win: Correct header status from 'COMPLETED' to accurate project phase New page idea: PM dashboard showing all properties with pending work orders (prioritized by completion %)
! 3.3
properties/cash-flow.html
audience: mixed · depth: 3
A useful consolidation of cash flow data that is currently non-functional due to empty tables and lacks navigation aids.
T1: val=4 red=5 help=3
T2: clarity=3 design=3 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: pass empty states: fail intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: pass tab help badges: fail abbreviation tooltips: pass
Fixes:- Add empty state message for VPT table (currently empty, causing confusion)
- Add ? help badges to table headers (e.g., 'Segment', 'Contract') for jargon explanation
- Fix sticky header issue (automated checklist shows failure)
- Add back navigation path for deep page (click depth 3)
Redesigns:- Redesign VPT table to reduce column count and improve readability (current layout is dense with small font)
Alternative Presentations:Cash Flow Dashboard — Better for quick overview but requires more development; tradeoff is less detail than table view
Quick win: Add 'No open commitments' message when VPT table is empty New page idea: Dedicated 'VPT Commitments' page with filtering/sorting for detailed view
! 3.3
properties/property-status-board.html
audience: owner · depth: 3
⚠ discoverability
Valuable portfolio overview hampered by poor navigation, missing help elements, and non-sticky header.
T1: val=4 red=4 help=4
T2: clarity=3 design=3 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: pass empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: pass tab help badges: fail abbreviation tooltips: fail
Fixes:- Sticky header not implemented (automated fail)
- Missing help badges for tabs (e.g., ? next to 'This Week' tab)
- No tooltips for abbreviations (WO, PM) in work order table
- Missing link from hub (main page) to this page (journey context: 'Hub should link to portfolio glance')
Alternative Presentations:Portfolio Dashboard — Better for owner as primary landing page (reduces clicks), but requires more development than current fix. Tradeoff: More comprehensive but less focused on pure status view.
Quick win: Add sticky header to maintain navigation during scrolling New page idea: Portfolio Dashboard: Main hub page with summary metrics + direct link to status board
! 3.3
properties/vendor-timeline.html
audience: mixed · depth: 3
A useful vendor timeline aggregation page hampered by unexplained abbreviations, a future date error, and poor navigation.
T1: val=4 red=4 help=3
T2: clarity=3 design=4 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: pass empty states: fail intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: pass tab help badges: fail abbreviation tooltips: fail
Fixes:- Explain 'QB' as 'QuickBooks' with a tooltip or footnote (currently used as unexplained abbreviation).
- Correct future date '2026-06-22' to current date or dynamic placeholder (e.g., 'as of [current date]').
- Expand 'VPT' abbreviation in table header (likely 'Vendor Payment Tracking') or add tooltip.
Redesigns:- Add breadcrumb/back navigation to address deep-page navigation issue (current page lacks path to parent).
Alternative Presentations:Vendor Activity Dashboard — Better for strategic decisions but requires development; current table is simpler but less actionable.
Quick win: Add 'QuickBooks' tooltip to 'QB' in the top note and date footer. New page idea: Vendor contact hub page linking to vendor details, communication tools, and payment history.
~ 3.5
properties/journey-109-pleasant.html
audience: mixed · depth: 3
The page provides necessary property-specific phase details but contains critical data inconsistencies and lacks essential term explanations.
T1: val=4 red=4 help=3
T2: clarity=2 design=4 nav=4
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: pass empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Phase timeline shows 'Done ✓' for P1 while bar indicates 90.7% completion (contradiction). Must fix data presentation.
- Missing tooltip for 'QB' in footer (PM activity · QB as of 2026-06-23) - requires explanation of abbreviation.
- No help badge for phase timeline metrics (e.g., 'behind' calculation) despite complex visual data.
Alternative Presentations:Property Summary Card — Better for Owner (primary) who needs quick status without visual complexity, but loses detailed timeline context for PM (secondary).
Phase Timeline Explorer — Superior for PM (secondary) to analyze progress, but over-engineered for Owner (primary) who only needs status.
Quick win: Replace 'Done ✓' with actual progress percentage (e.g., '90.7% complete') in phase timeline. New page idea: Property Delay Dashboard showing all properties with timeline deviations and PM contact options.
~ 3.5
properties/portfolio-capacity.html
audience: mixed · depth: 3
Valuable PM capacity view marred by critical data errors, missing help elements, and poor navigation.
T1: val=4 red=5 help=4
T2: clarity=3 design=3 nav=2
sticky column: fail sticky header: fail dual scrollbar: fail data freshness: fail empty states: fail intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: pass tab help badges: fail abbreviation tooltips: fail
Fixes:- Footer shows future date '2026-06-23' instead of current data refresh time; requires copy fix.
- Table headers not sticky (sticky_column: fail), causing loss of context during horizontal scrolling.
- Missing ? help badge for 'PM' in footer; should trigger tooltip explaining 'Project Manager'.
- Abbreviation 'PM' not explained in tooltip; requires tooltip content addition.
Alternative Presentations:Portfolio Capacity Dashboard — Better for quick scanning but requires more screen real estate; current single-page is simpler but less contextual.
Quick win: Correct future date in footer to reflect actual data refresh time. New page idea: Project timeline detail view showing individual property arcs (current 'Individual Property Arcs' note).
~ 3.5
properties/portfolio-glance.html
audience: owner · depth: 3
⚠ discoverability
High-value summary page missing from hub navigation with inconsistent data presentation and unexplained abbreviations.
T1: val=4 red=5 help=4
T2: clarity=3 design=3 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Add missing hub link (journey context: 'Missing link: Hub should link to portfolio glance')
- Explain 'Mo' abbreviation in active pipeline table (used in 'Mo Held' and 'Mo Interest' columns)
- Fix active pipeline table average row: show calculated average purchase price instead of '—'
- Add note clarifying that 'Avg Sale Price' and 'Avg Gross Spread' stats apply only to completed properties
- Standardize terminology: change 'Buy Price' to 'Purchase' in completed properties table to match active pipeline
Alternative Presentations:Portfolio Summary with Filters — Better for drill-down needs but adds complexity; current static view is sufficient for owner's high-level review
Quick win: Add tooltip to 'Mo' with 'months' explanation New page idea: Portfolio Performance Trends page showing monthly metrics (e.g., gross spread trends, hold time analysis)
~ 3.5
properties/segment-benchmarks.html
audience: mixed · depth: 3
A useful benchmark summary page with clear purpose but poor navigation and small text that hinders usability.
T1: val=4 red=4 help=4
T2: clarity=4 design=3 nav=2
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: pass empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: pass abbreviation tooltips: pass
Fixes:- Explanatory note uses 10px monospace font (hard to read) - increase to 12-14px for accessibility
- No back link or breadcrumbs on deep page (click_depth=3), making navigation difficult
Alternative Presentations:Segment Benchmarks Table — Better for precise data comparison than grid, but less visually scannable for initial overview
Quick win: Increase explanatory note font size from 10px to 14px New page idea: Per-segment detail page showing trend analysis across properties
~ 3.8
properties/properties-main.html
audience: mixed · depth: 3
A useful properties overview marred by data errors and missing context for key metrics.
T1: val=4 red=5 help=4
T2: clarity=3 design=4 nav=3
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: fail empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Empty sqft stats for property '52 Wildwood' should display 'N/A' instead of blank
- Replace '—' in 'months' badge with 'N/A' for property '32 Clinton'
- Add 'Last updated' timestamp to address data freshness failure
- Add help badges (?) for 'months in pipeline' and 'above-grade' with tooltips
- Add breadcrumb/back link to parent page for navigation depth
Alternative Presentations:Portfolio Summary View — Simpler than current grid but less detailed; better for quick executive overviews
Quick win: Add 'Last updated: [date]' below summary stats New page idea: Property Pipeline Dashboard with filters for status, location, and time metrics
~ 4.2
properties/construction-timeline.html
audience: mixed · depth: 3
A well-structured portfolio timeline page that is missing critical navigation and contains a confusing future date in the data note.
T1: val=5 red=5 help=5
T2: clarity=4 design=4 nav=2
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: pass empty states: n-a intrapage link consistency: pass tooltip viewport: pass text overlap: pass content clipping: pass expandable overflow: pass tab help badges: pass abbreviation tooltips: pass
Fixes:- Data note shows future date '2026-06-22' instead of current date; update to reflect actual data date.
- Missing back navigation path for deep page (click depth 3); add breadcrumb or back button.
- No links from property rows to detail pages; add interactive links for drill-down.
Alternative Presentations:Portfolio Dashboard — Better for holistic decision-making but overcomplicates timeline focus; tradeoff: less efficient for pure timeline analysis.
Quick win: Fix future date in data note to current date (or remove static date). New page idea: Property detail page with embedded timeline view (to complement portfolio timeline).
Reference
~ 3.5
reference/segments.html
audience: admin · depth: 2
A useful reference page for segments with clear filtering, but lacks sticky headers, back navigation, and abbreviation explanations.
T1: val=4 red=3 help=5
T2: clarity=4 design=3 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: n-a empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: fail
Fixes:- Add sticky header to table to keep headers visible during scrolling (automated checklist: sticky_header: fail)
- Add breadcrumb or back link for deep page (click_depth: 2) to improve navigation
- Add tooltip or explanation for phase abbreviations (P1/P2/P3) in table
Alternative Presentations:Cost Code Lookup with Segments View — Better for users who primarily search cost codes, but would require redesigning the lookup tool (tradeoff: less dedicated reference page)
Quick win: Implement sticky table header for better table usability New page idea: Phase Definitions Reference page explaining P1/P2/P3 in context
~ 3.8
reference/2026-05-13_chart-of-accounts.html
audience: admin · depth: 2
A well-structured reference page for the Chart of Accounts, but the non-sticky header significantly hinders usability for long tables.
T1: val=4 red=4 help=5
T2: clarity=4 design=3 nav=3
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: n-a empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Sticky header is not functioning (automated check failed). Implement CSS to maintain column headers during scrolling.
Alternative Presentations:QuickBooks Chart of Accounts (Direct Link) — Better for real-time data, but less user-friendly for internal reference. Tradeoff: accuracy vs. usability.
Interactive Chart of Accounts with Balances — More useful for financial analysis, but not needed for reference. Tradeoff: more data vs. reference simplicity.
Quick win: Add a back link to the reference index page for better navigation New page idea: A guide on how to use the Chart of Accounts for transaction entry (with examples)
~ 3.8
reference/2026-06-09_cost-code-map.html
audience: admin · depth: 3
A well-structured reference page that effectively maps cost codes to segments, but lacks a clear navigation path and explanation of key jargon.
T1: val=4 red=4 help=4
T2: clarity=4 design=4 nav=3
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: n-a empty states: n-a intrapage link consistency: pass tooltip viewport: pass text overlap: pass content clipping: pass expandable overflow: pass tab help badges: fail abbreviation tooltips: fail
Fixes:- Add tooltip explanation for representative code format (e.g., "##.0 = base code") to clarify "16.0" notation
- Replace title attribute tooltips with standard ? help badges for representative codes
Redesigns:- Add breadcrumb/back link for deep page (current click_depth 3 lacks navigation path)
Alternative Presentations:Table View — Better for sorting/searching but less visually scannable than grid for segment numbers; grid is preferable for reference context
Quick win: Add "##.0 = base code" tooltip explanation next to representative codes New page idea: Searchable cost code lookup page showing segment, representative code, and full code list
~ 4.2
reference/approval-chain.html
audience: admin · depth: 2
Clear reference for payment process but lacks VPT explanation and back navigation for deep page.
T1: val=4 red=4 help=4
T2: clarity=5 design=5 nav=3
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: n-a empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: fail
Fixes:- VPT abbreviation used 8 times without explanation; add tooltip or first-use definition
- Missing back navigation for deep page (click depth 2); add breadcrumb or back button
Alternative Presentations:Process Flowchart — Better for visual learners but less scannable for specific actions; tradeoff: more space needed
Role-Based Summary Table — More compact but loses sequential flow; tradeoff: harder to follow step progression
Quick win: Add 'VPT (Vendor Payment Tracking)' tooltip on first use of abbreviation New page idea: Vendor Reconciliation Process (for Credit/Volume Vendors exception path)
~ 4.2
reference/eod-conventions.html
audience: admin · depth: 2
A well-structured reference page that effectively summarizes EOD conventions but lacks checklist compliance and minor UI polish.
T1: val=4 red=3 help=5
T2: clarity=5 design=4 nav=4
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: n-a empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: pass tab help badges: fail abbreviation tooltips: fail
Fixes:- Add ? help badges for time zone abbreviations (ET/PHT) and QBO to meet checklist, though note-strip already explains them
- Fix sticky header (CSS tweak) to remain visible during scrolling
- Add tooltip explanations for 'Recon' (reconciliation) and 'Temp Notes' in Edmar's card
Alternative Presentations:EOD Conventions Interactive Guide — Better for new admins but requires development time; current table is sufficient for experienced admins
Quick win: Add ? badges to ET/PHT in time zone note and QBO in Edmar's card New page idea: EOD Report Dashboard: Aggregated view of all EOD reports with status indicators
~ 4.2
reference/filing-name-card.html
audience: admin · depth: 2
Clear naming convention reference with actionable examples, but lacks abbreviation explanations and navigation aids.
T1: val=4 red=4 help=5
T2: clarity=5 design=4 nav=3
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: n-a empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Add help badges (?) next to abbreviations (SOW, NFA, recon) with tooltips explaining terms
- Add back navigation link to parent reference page (e.g., 'Back to Reference Guide')
Alternative Presentations:Filing Guide (Combined) — Better for new users but less efficient for quick lookup; requires more screen space
Filing Terms (Enhanced Quick Reference) — Minimal changes with maximum impact; preserves current efficient structure
Quick win: Add tooltips for SOW (Statement of Work), NFA (No Further Action), and recon (reconciliation) in Special Rules section New page idea: Document Naming Checklist: Interactive tool to validate filenames against rules
~ 4.2
reference/iha-plan-variables.html
audience: admin · depth: 2
Essential reference for Admins with clear variable mapping, but marred by empty table rows and missing navigation breadcrumbs.
T1: val=4 red=5 help=4
T2: clarity=4 design=4 nav=4
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: n-a empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Remove empty rows (with '---') from all variable tables to eliminate visual noise and improve data clarity.
- Add breadcrumb navigation (e.g., 'Reference > Plan Outputs') to support depth-2 page navigation.
Alternative Presentations:Single-Table Reference — Better for cross-plan variable comparison but worse for plan-specific focus; increases page length significantly.
Quick win: Replace empty table rows with 'No additional variables' notes for cleaner presentation. New page idea: Variable Usage Heatmap: Visualize which variables are most frequently used across plans.
~ 4.3
reference/2026-06-08_vendor-contractor-registry.html
audience: admin · depth: 2
Essential reference page for vendor compliance with strong stats and filters, but needs sticky header and clearer compliance indicators.
T1: val=5 red=5 help=5
T2: clarity=4 design=4 nav=3
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: n-a empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: pass abbreviation tooltips: pass
Fixes:- Make header sticky (currently fails sticky_header check) to maintain navigation while scrolling through vendor list.
- Make expired COI dates more prominent (e.g., red text/bold) in compliance column to prevent missed expirations.
Redesigns:- Restructure compliance column to separate COI expiration into dedicated column with clear status (e.g., 'COI: expired 2025-01-11') instead of cluttered badges.
Alternative Presentations:Vendor Compliance Dashboard — Better for executive oversight but less useful for detailed lookup. Tradeoff: sacrifices granular data for strategic insights.
Quick win: Add 'New Vendor' button linking to vendor creation form (currently missing from reference page). New page idea: Vendor Compliance Dashboard: Visual summary of compliance health with charts and bulk action buttons.
✓ 4.5
reference/2026-05-28_cost-code-map.html
audience: admin · depth: 2
A well-structured reference map for cost codes and segments that enables admin verification, but requires minor UX improvements for accessibility and clarity.
T1: val=5 red=5 help=5
T2: clarity=4 design=4 nav=4
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: n-a empty states: n-a intrapage link consistency: pass tooltip viewport: pass text overlap: pass content clipping: pass expandable overflow: pass tab help badges: fail abbreviation tooltips: fail
Fixes:- Replace native title tooltips with ? help badges for representative codes (e.g., '16.0 ▸' should have a ? icon instead of title attribute)
- Add tooltip explanation for 'WO' abbreviation in key numbers section (currently uses 'WO' without definition)
Alternative Presentations:Segment-Based Cost Code Explorer — Better for targeted lookups but less efficient for overview than current grid. Tradeoff: more focused but requires more clicks.
Quick win: Add ? help badges to representative code tooltips (e.g., '16.0 ▸ ?') New page idea: Cost Code Detail Page: Interactive list showing all 228 codes with segment mapping, work orders, and descriptions
✓ 4.5
reference/cost-code-lookup.html
audience: admin · depth: 2
A well-structured reference page for cost codes that enables quick lookup, but missing critical explanations for phase abbreviations.
T1: val=5 red=5 help=5
T2: clarity=4 design=4 nav=4
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: n-a empty states: fail intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Missing tooltip for 'Phase' column explaining P1/P2/P3 and Non-Con abbreviations
Alternative Presentations:Cost Code System Overview — Better for onboarding new admins but less efficient for quick lookup; current page is optimal for reference use case
Quick win: Add ? help badge to 'Phase' column header with tooltip explaining P1/P2/P3/Non-Con New page idea: Cost Code Details Page: Shows full description, cost history, and related work orders per code
✓ 4.5
reference/dictionary.html
audience: admin · depth: 2
Essential reference page with strong organization but marred by copy errors and incomplete definitions.
T1: val=5 red=5 help=5
T2: clarity=4 design=4 nav=4
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: n-a empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: pass tab help badges: pass abbreviation tooltips: pass
Fixes:- Duplicate link in 'Admin Group Chat' definition ('→ See VG: Admin Junkie. → See VG: Admin Junkie.')
- Incomplete definition for 'Bill Payment' (cut off at 'for l')
- Future-dated generated timestamp (2026-06-09) in titleblock
- Non-link reference to 'VG: Admin Junkie' in definitions (should be hyperlinked)
Alternative Presentations:Search-First Reference — Better for users who know exact terms, but less efficient for browsing than current alphabet system
Contextual Term Explorer — More useful for role-based navigation but loses alphabet scanning efficiency
Quick win: Fix duplicate link in 'Admin Group Chat' definition New page idea: VG: Admin Junkie - dedicated page explaining the concept referenced in definitions
✓ 4.8
reference/index.html
audience: admin · depth: 1
A highly effective reference hub that centralizes critical lookup materials with perfect context, though missing abbreviation explanations.
T1: val=5 red=5 help=5
T2: clarity=5 design=5 nav=4
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: n-a empty states: n-a intrapage link consistency: pass tooltip viewport: pass text overlap: pass content clipping: pass expandable overflow: pass tab help badges: pass abbreviation tooltips: fail
Fixes:- Add tooltips for abbreviations (WIP, COGS, EOD, WO, IHA) used in meta text and blurb descriptions
Alternative Presentations:Reference Hub with Visual Icons — Better for visual scanning but requires icon design work; current text-based approach is more accessible for screen readers
Quick win: Add hover tooltips for WIP, COGS, EOD, WO, IHA with brief explanations New page idea: Dedicated glossary page linking from reference hub (with all abbreviations explained)
✗ 0
reference/2026-05-15_systems-index.html
audience: ? · depth: 2
T1: val=? red=? help=?
T2: clarity=? design=? nav=?
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: n-a empty states: n-a intrapage link consistency: pass
Reports
✗ 1.8
reports/portal-review/index.html
audience: mixed · depth: 3
Empty report page with no actionable information, failing to provide value or handle empty state.
T1: val=1 red=5 help=1
T2: clarity=1 design=2 nav=1
sticky column: fail sticky header: fail dual scrollbar: fail data freshness: pass empty states: fail intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Empty report with no empty state handling; users see a blank page with no guidance.
- No back navigation path for a deep page (click depth 3).
- Dual scrollbar detected (likely due to nested scrollable containers).
- Missing sticky header and sticky column for the table (required for long reports).
Alternative Presentations:Report Dashboard — More actionable with data but requires more development; tradeoff is better user experience when content exists
Quick win: Add empty state message: 'No pages have been reviewed yet. Once reviews are completed, this report will show results.' New page idea: Page showing list of reviewed pages with direct links to their reports
! 3.0
reports/actualsboard/actualsboard-non-construction-2026-06-22.html
audience: mixed · depth: 2
A dense, wide table for non-construction costs lacks sticky headers and clear variance data, hindering quick decision-making despite valuable portfolio insights.
T1: val=4 red=4 help=4
T2: clarity=2 design=2 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: pass empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Add sticky header to table to maintain column headers during horizontal scrolling (automated check failed).
- Replace blank variance cells ('—') with 'N/A' or remove column if variance is not calculated.
Redesigns:- Redesign table layout to reduce width (e.g., group properties, use vertical scrolling) to eliminate horizontal scrolling.
Alternative Presentations:Non-Construction Cost Summary — Better for quick overviews; tradeoff is loss of detailed per-property data.
Quick win: Add sticky header to table to improve usability for wide tables. New page idea: Drill-down page for individual properties showing non-construction costs over time with trend visualization.
! 3.0
reports/actualsboard/index.html
audience: owner · depth: 3
⚠ discoverability
A stale data hub lacking direct property spend links, making it unusable for owners' primary goal of tracking specific property finances.
T1: val=3 red=5 help=2
T2: clarity=2 design=4 nav=2
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: fail empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: pass tab help badges: pass abbreviation tooltips: pass
Fixes:- Replace future-dated iframe filename (actualsboard-construction-2026-06-22.html) with current data source to fix data freshness failure
- Add prominent 'View Property Spend Details' link in header to address journey friction (missing property spend detail link)
Cull:- Page serves as hub but contains no actionable data (stale iframes) and fails core purpose - should be replaced with property-focused view
Alternative Presentations:Property Actuals Dashboard — Better for owner's primary goal (specific property spend) but requires property selection step. Tradeoff: reduces click depth from 3 to 1 but removes multi-property hub capability.
Quick win: Add 'Refresh Data' button near tab bar to address data freshness New page idea: Property Actuals Dashboard: Single-page view showing actuals vs. budget for selected property with drill-down to reports
! 3.3
reports/actualsboard/actualsboard-construction-2026-06-22.html
audience: mixed · depth: 3
Essential construction cost intelligence but hampered by dense table layout, missing navigation, and unexplained abbreviations.
T1: val=4 red=4 help=5
T2: clarity=3 design=2 nav=2
sticky column: fail sticky header: fail dual scrollbar: pass data freshness: pass empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Add tooltip for 'com' abbreviation in cost rows (e.g., '+$93K com' should explain 'comparable' or 'commission')
- Add link to non-construction companion board in titleblock (currently only mentioned in subheading)
- Implement sticky headers for table (currently fails automated check)
Redesigns:- Redesign table layout to reduce horizontal scrolling (13 properties wide) - requires structural rethink
Alternative Presentations:Construction Actuals (Mobile-Optimized) — Better for mobile users but requires more vertical scrolling on desktop; tradeoff is reduced horizontal scrolling at cost of vertical space
Quick win: Add tooltip for 'com' abbreviation in cost rows New page idea: Portfolio Construction Summary: High-level view of total spend vs. estimate across all properties with drill-down
! 3.3
reports/actualsboard/actualsboard-cross-property.html
audience: mixed · depth: 3
Necessary cross-property comparison tool hampered by excessive table width and missing sticky headers.
T1: val=4 red=4 help=4
T2: clarity=3 design=3 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Sticky header is missing (automated check fail), causing column headers to disappear during table scrolling.
Redesigns:- Table displays 14 properties in a single row, requiring horizontal scrolling and making data hard to parse.
Alternative Presentations:Property Comparison Dashboard — Better for mobile use and focused comparisons, but requires more development than sticky header fix.
Quick win: Implement sticky header for table to maintain column visibility during scrolling. New page idea: Per-property comparison page allowing side-by-side selection of two properties for focused analysis.
! 3.3
reports/actualsboard/spend-board-2026-06-11.html
audience: mixed · depth: 3
A useful consolidated spend report hampered by an unresponsive table layout and missing navigation aids.
T1: val=4 red=4 help=4
T2: clarity=3 design=3 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: pass empty states: pass intrapage link consistency: pass tooltip viewport: fail text overlap: pass content clipping: fail expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Add title attributes to segment codes (e.g., '16') to explain segment names (Project Prep, etc.).
- Tooltip for Multi-Property vendors overflows viewport; implement viewport-aware tooltip positioning.
Redesigns:- Table is too wide for 7 properties; redesign to avoid horizontal scrolling (e.g., vertical property stacking or responsive columns).
Alternative Presentations:Spend Board (Vertical Properties) — Better for mobile but requires more vertical scrolling on desktop; tradeoff is improved accessibility over wide table.
Quick win: Add title attributes to all segment codes (e.g., 16). New page idea: Per-property spend drill-down page with segment-level filters.
~ 3.7
reports/actualsboard/spend-board-2026-06-09.html
audience: mixed · depth: 3
A useful financial overview hindered by excessive width, missing navigation, and unexplained segment codes.
T1: val=4 red=4 help=5
T2: clarity=4 design=3 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: pass empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Add ? help badges for segment codes (16, 18, etc.) with tooltips explaining segment names.
- Add breadcrumb/back link to parent reports page (current depth 3 has no return path).
- Fix sticky header (currently failing) to maintain header visibility during scroll.
Redesigns:- Redesign table layout to eliminate horizontal scrolling (14 columns require >1920px width).
Alternative Presentations:Mobile-Optimized Spend Summary — Better for mobile users but requires significant layout rework; tradeoff is reduced desktop screen real estate for more focused data.
Quick win: Add help badges to segment codes with tooltips explaining segment names. New page idea: Financial Dashboard: Aggregated view of spend vs. budget across all properties with trend charts.
~ 3.7
reports/actualsboard/spend-board-2026-06-10.html
audience: mixed · depth: 3
A useful spend board for active properties, but the table layout is too wide and lacks navigation aids, making it difficult to use.
T1: val=4 red=5 help=5
T2: clarity=3 design=3 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: pass empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Add back button/navigation trail for deep page (click depth 3)
- Add help badges (?) next to segment codes and "Committed" with tooltips
Redesigns:- Redesign table to reduce horizontal width (7 properties × 2 columns = 14 columns)
Alternative Presentations:Spend Dashboard — Better for strategic decisions but requires more development; tradeoff is time vs. usability for quick checks
Quick win: Add back button to header (10 min CSS/copy fix) New page idea: Budget vs Actuals trend dashboard showing monthly spend comparisons
~ 3.8
reports/actualsboard/actualsboard-insights.html
audience: mixed · depth: 2
Valuable portfolio-level insights consolidated effectively, but table usability and navigation lack critical improvements.
T1: val=4 red=4 help=5
T2: clarity=4 design=3 nav=3
sticky column: fail sticky header: fail dual scrollbar: fail data freshness: pass empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Add sticky headers/columns to deal economics table (currently fails sticky_header/sticky_column checks) for better table navigation.
- Add back navigation path (breadcrumb or 'Back' button) for this deep page (click depth 2).
Alternative Presentations:Portfolio Summary Dashboard — Better for exploration but requires more development; current page is a static summary for quick scanning.
Quick win: Implement sticky headers for the deal economics table to resolve dual_scrollbar/sticky_column failures. New page idea: Deal Comparison Dashboard: Interactive tool to filter/sort deals by margin, hold period, or cost/sqft.
~ 4.0
reports/actualsboard/2026-06-08_actualsboard-guide.html
audience: mixed · depth: 2
A well-structured guide for running the actualsboard report, but missing essential navigation elements and help tooltips.
T1: val=5 red=5 help=5
T2: clarity=4 design=3 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Replace absolute terminal path (/Users/mac/My Drive/...) with relative path to avoid user-specific paths.
- Add ? help badges for abbreviations (WO, QB) with tooltips explaining them.
- Implement sticky header to improve navigation on long pages (per automated check).
Alternative Presentations:Actualsboard Report Preview — Better for visual learners but doesn't explain how to run the report; would complement the guide rather than replace it.
Quick win: Add help badges for 'WO' (Work Order) and 'QB' (QuickBooks) in the guide text. New page idea: Actualsboard Report Preview: Live example of the report output with sample data for visual reference.
~ 4.0
reports/actualsboard/2026-06-08_budget-source-guide.html
audience: mixed · depth: 2
A well-structured guide explaining critical budget source indicators, but lacks navigation, symbol clarity, and user-friendly references.
T1: val=5 red=5 help=5
T2: clarity=4 design=3 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: pass abbreviation tooltips: pass
Fixes:- First use of 'WO' (work order) lacks explanation; should be spelled out or have tooltip on first occurrence.
- Table visual marks (†, *, ◆) not explained in table itself; rely on later section examples causing confusion.
- Source reference points to markdown file (reference/cost-codes/budget-source-taxonomy.md) instead of user-friendly link.
Alternative Presentations:Budget Source Legend (Quick Reference) — Better for quick lookup during report use, but lacks context of why sources matter (current page's strength)
Quick win: Add 'work order (WO)' on first use and include tooltip for abbreviations New page idea: Actualsboard source legend sidebar (with live examples) for quick reference during report use
~ 4.0
reports/actualsboard/spend-board-2026-06-15.html
audience: mixed · depth: 3
High-value spend summary for budget decisions, but crippled by table width and missing sticky header.
T1: val=5 red=5 help=5
T2: clarity=4 design=3 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: pass empty states: pass intrapage link consistency: pass tooltip viewport: pass text overlap: pass content clipping: pass expandable overflow: pass tab help badges: fail abbreviation tooltips: fail
Fixes:- Add sticky header to table to keep column headers visible during scrolling (automated fail).
- Add title attribute to segment codes (e.g., '16') to explain segment names (e.g., 'Project Prep').
- Add help badge (?) next to 'Committed' with tooltip explaining 'Budgeted but not yet spent'.
Alternative Presentations:Spend Summary Dashboard — Better for strategic decisions but requires more development; tradeoff is reduced immediate data access vs. current table.
Quick win: Add title attributes to segment codes and 'Committed' label. New page idea: Spend trend dashboard showing historical comparisons across properties.
~ 4.3
reports/actualsboard/2026-05-18_actualsboard-guide.html
audience: mixed · depth: 3
Essential guide for Actualsboard with clear steps but requires generic path replacement and abbreviation tooltips.
T1: val=5 red=5 help=5
T2: clarity=4 design=4 nav=3
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Replace specific terminal path '/Users/mac/My Drive/...' with generic placeholder (e.g., 'your/vg/directory') to avoid user confusion.
- Add help badges (?) for 'WO' (Work Order) and 'QB' (QuickBooks) with tooltips explaining abbreviations.
- Fix sticky header CSS (automated check failed) to maintain navigation visibility on long pages.
Alternative Presentations:Actualsboard Quick Reference — Better for experienced users needing rapid execution; tradeoff is reduced guidance for new users.
Quick win: Replace user-specific terminal path with generic placeholder in 'How to Run the Report' section. New page idea: QuickBooks Auth Troubleshooting Guide covering common token errors and browser redirects.
✓ 4.5
reports/actualsboard/2026-05-18_budget-source-guide.html
audience: mixed · depth: 3
Essential guide for interpreting actualsboard budget sources, but requires date correction and navigation fixes.
T1: val=5 red=5 help=5
T2: clarity=5 design=5 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Correct future date (2026-05-18) in 'Updated' field to current year to fix data freshness.
- Replace markdown file link ('reference/cost-codes/budget-source-taxonomy.md') with user-friendly link to actualsboard report.
- Add back navigation link (e.g., 'Back to Actualsboard') for deep-page accessibility.
Alternative Presentations:Budget Source Quick Reference — Better for PMs needing fast reference; worse for new users needing context.
Quick win: Fix future date in metadata to current year. New page idea: Interactive actualsboard demo showing source mark tooltips with live variance examples.
Work Orders
✗ 2.3
work-orders/rfw-request-for-work.html
audience: pm · depth: 3
This page is a template form without instructions, making it unusable as a submission guide despite logical section organization.
T1: val=2 red=3 help=2
T2: clarity=2 design=3 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Missing instructions for filling out the form (e.g., examples for 'What needs to be done' field)
- Header not sticky (automated check failed) - add CSS to keep masthead visible during scrolling
- No back navigation path (deep page at click depth 3) - add breadcrumb or back button
Alternative Presentations:Split Guide + Template — Better for usability (guide is reference, template is clean), but requires two pages instead of one
Quick win: Add 2-3 example sentences above the form (e.g., 'What needs to be done: Replace damaged bathroom tile' and 'Why: Tile cracked during plumbing work') New page idea: RFW Process Guide - standalone page explaining workflow, triggers, and approval steps
! 3.2
work-orders/index.html
audience: pm · depth: 1
Central work order hub is useful but suffers from missing PM roster link and inconsistent terminology, reducing its effectiveness for daily PM operations.
T1: val=4 red=4 help=3
T2: clarity=3 design=3 nav=2
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: fail empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Tab 'AP Pipeline' mislabels VPT tracker; change to 'VPT Tracker' to match purpose statement
- Missing direct link to PM roster page (journey friction: J3 requires this link from WO hub)
- Abbreviations 'RFW' and 'VPT' lack tooltips/explanations despite help badges being present
Alternative Presentations:Work Order Summary Dashboard — Better than current hub for quick decision-making (reduces tab switching), but requires data aggregation instead of iframe delegation
Quick win: Rename 'AP Pipeline' tab to 'VPT Tracker' immediately New page idea: Work Order Summary Dashboard showing open WOs, due dates, and PM roster links in single view
! 3.3
work-orders/pm-wo-roster.html
audience: pm · depth: 3
Essential reference page for PMs but lacks critical due-date data and navigation aids for core workflow needs.
T1: val=4 red=5 help=3
T2: clarity=3 design=3 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: pass empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Add sticky header (CSS fix) to address automated checklist failure
- Add ? help badges next to P0 note and phase labels (P0/P1/P2) to explain accounting categories and phase meanings
- Add breadcrumb/back link to WO hub (current journey friction: missing link from hub to roster)
Redesigns:- Add due date column to table to address PM's 'due next week' need (current page lacks this critical data)
Alternative Presentations:Work Order Dashboard — Better for PM's core need (due next week) but requires new data structure; tradeoff: less reference detail than current roster
Quick win: Add help badges for P0 note and phase labels (5-min CSS/copy fix) New page idea: Work Order Dashboard: Prioritized view showing open WOs with due dates, status, and next steps
~ 3.5
work-orders/rfws/2026-06-12_rfw-roster.html
audience: pm · depth: 3
Useful for PMs to view RFW status and costs but suffers from unexplained data, poor navigation, and missing sticky header.
T1: val=4 red=4 help=5
T2: clarity=3 design=3 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Split amounts (L/M) in Estimate/Actual columns lack explanation, causing confusion
- Header not sticky (per automated checklist), making table navigation difficult on long pages
- Data freshness check failed (likely stale date 2026-06-12 in title)
Redesigns:- No back path or breadcrumbs for deep page (click depth 3), and 'Work Orders' in eyebrow isn't a link
Alternative Presentations:RFW Dashboard — Replaces 19+ date-specific pages with one dynamic view; tradeoff is losing historical snapshot context but gaining usability
Quick win: Add tooltip to L/M split amounts explaining 'L' = Labor, 'M' = Materials New page idea: RFW Dashboard: Single page with date picker, status filters, and cost analytics
~ 3.5
work-orders/rfws/2026-06-15_rfw-roster.html
audience: pm · depth: 3
A central RFW roster page that provides key operational data but lacks clarity on key terms and navigation aids.
T1: val=4 red=5 help=4
T2: clarity=3 design=3 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Add ? help badges for 'L' and 'M' in Estimate/Actual columns and for 'Segment' to explain their meaning.
- Add breadcrumb navigation (e.g., Work Orders > RFW Registry > 2026-06-15) to enable back navigation from deep page.
- Explain 'RFW' abbreviation on page (e.g., in title or footnote) as it's critical to PM workflow.
Alternative Presentations:RFW Dashboard — Better for quick insights but less efficient for detailed RFW scanning. Tradeoff: reduces table density but requires more clicks to access specific RFWs.
Quick win: Add tooltip triggers for 'L/M' and 'Segment' with brief explanations (e.g., 'L=Labor, M=Materials'). New page idea: RFW Details Page: Clicking any RFW row opens a dedicated page with full history, approval workflow, and document attachments.
~ 3.5
work-orders/rfws/rfw-roster.html
audience: pm · depth: 3
Central RFW roster provides useful filtering and financials but suffers from data freshness issues, missing navigation links, and incomplete content.
T1: val=4 red=5 help=4
T2: clarity=3 design=3 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Title shows future date (2026-06-23) instead of current date; update to reflect actual data freshness
- Header does not stick on scroll; add sticky header CSS for better table navigation
- WO hub page (work-orders/wo-hub.html) lacks link to this roster; add direct navigation path
- Note for RFW#01 at 185 Fernwood is cut off ('Shlomo - Let’s reconsider/rev'); complete text
- Estimate/Actual columns use unexplained split labels (L/M); add tooltips or explanation
Alternative Presentations:RFW Timeline View — Better for tracking deadlines but less efficient for bulk status checks; tradeoff: more visual but less data-dense than current table
Quick win: Update title date to current date (e.g., '2024-06-23') New page idea: RFW Due Soon dashboard showing next 7 days' active RFWs with priority indicators
~ 3.7
work-orders/rfws/2026-06-22_rfw-roster.html
audience: pm · depth: 3
A functional roster page for PMs with strong financial summaries but missing critical navigation aids and unclear abbreviations.
T1: val=4 red=4 help=5
T2: clarity=4 design=3 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Add sticky header to keep filter bar visible during long scrolls (automated check: sticky_header: fail)
- Add ? help badges for RFW (Request for Work) and QB (QuickBooks) with tooltips
- Add tooltips explaining 'L' (Labor) and 'M' (Materials) in estimate/actual columns
- Add breadcrumb navigation (e.g., Home > Work Orders > RFW Roster) for deep page context
Alternative Presentations:RFW Dashboard — Better for owner audience (high-level), but less useful for PMs needing granular RFW details; tradeoff: loses table's actionable data for construction management
Quick win: Add sticky header to maintain filter access during scrolling New page idea: RFW Detail Page with full history, approval trails, and linked documents
~ 3.8
work-orders/vpt/index.html
audience: pm · depth: 3
Necessary hub for vendor payment tracking but missing critical order-tracking links and future date error reduce PM usability.
T1: val=4 red=5 help=3
T2: clarity=4 design=4 nav=3
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: fail empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Future date '2026-06-15' in 'Updated' timestamp (should be current date) causing data freshness failure.
- Abbreviation 'FM' used without explanation in meta text ('FM assigned') — requires tooltip or expansion.
- Missing link to order tracking (per journey context J4) — VPT hub should link to order tracking for cross-reference.
Alternative Presentations:Integrated VPT Board — Better user flow but requires rework of board templates; current hub is simpler to fix.
Quick win: Correct future date to actual last update date in titleblock. New page idea: Vendor Payment Detail Page — shows full payment history with work order cross-reference (would replace current board links).
~ 4.0
work-orders/2026-05-11_design-team-stamp-guide.html
audience: pm · depth: 2
Clear guide for PMs to verify design team deliverables, but marred by future revision date and missing navigation.
T1: val=4 red=4 help=5
T2: clarity=4 design=4 nav=3
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Update revision date from 2026-05-11 (future date) to current/past date to fix data freshness.
- Add back navigation path (breadcrumb or back button) for depth-2 page.
- Add tooltips/explanations for abbreviations (e.g., 'lnft' = linear feet, 'y/n' = yes/no) in table.
Alternative Presentations:Design Team Stamp Box Checklist — Better for PM action (quick verification), but less useful for design teams needing guidance. Current guide better serves dual purpose (design team instruction + PM reference).
Quick win: Add 'lnft' tooltip to table entries explaining 'linear feet' (common abbreviation). New page idea: PM Stamp Box Verification Checklist (interactive checklist for PMs to mark off delivered items).
~ 4.0
work-orders/2026-05-11_plans-cheat-sheet.html
audience: pm · depth: 2
Essential reference for PMs extracting plan variables, but lacks help for technical abbreviations and work order links.
T1: val=4 red=4 help=5
T2: clarity=4 design=4 nav=3
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: fail empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Add help badges explaining technical abbreviations (e.g., 'lnft' for linear feet) next to variable names
- Convert 'Feeds' work order tags (e.g., P3W04) into clickable links to actual work order pages
Alternative Presentations:Work Order Variables Reference — Better for quick scanning but requires more development; current card layout is simpler for reference
Quick win: Add 'lnft = linear feet' tooltip next to all variable names New page idea: Dynamic Variable Lookup: Searchable database showing all variables, plan types, and work orders they feed
~ 4.0
work-orders/rfws/2026-06-11_rfw-roster.html
audience: pm · depth: 3
A useful summary page for PMs but lacks critical explanations for financial abbreviations and has navigation issues.
T1: val=5 red=5 help=5
T2: clarity=3 design=4 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Add tooltips explaining 'L' and 'M' in financial columns (e.g., 'L' for Labor, 'M' for Materials)
- Add tooltip for 'RFW' abbreviation in table headers (Request for Work)
- Implement sticky header to maintain filter bar visibility during table scrolling
- Add '?' help badges next to 'Estimate' and 'Actual' columns for financial context
Alternative Presentations:RFW Timeline View — Better for tracking work order progression over time but less efficient for property-specific management (tradeoff: reduced context switching vs. slower filtering)
Quick win: Add 'L/M' tooltip to financial column headers (30 min) New page idea: RFW Analytics Dashboard showing trend data across properties (vs. static roster)
~ 4.0
work-orders/rfws/2026-06-14_rfw-roster.html
audience: pm · depth: 3
A well-structured RFW roster with strong filtering but missing cost explanations and navigation aids.
T1: val=4 red=4 help=5
T2: clarity=4 design=4 nav=3
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Add ? help badges next to 'Estimate' and 'Actual' columns to explain 'L' (Labor) and 'M' (Materials) abbreviations.
- Add visible back link (e.g., 'Back to Work Orders') to improve navigation from deep page.
Redesigns:- Replace fixed date in title/path (2026-06-14) with dynamic current date to avoid confusion about historical vs. current data.
Alternative Presentations:Current RFW Registry — Better for daily use (always current), trades historical access for simplicity. Historical data would require separate archive page.
Quick win: Add tooltip explanation for 'L/M' in cost columns using ? badge. New page idea: Current RFW dashboard (no date in URL) as primary entry point for PMs.
~ 4.0
work-orders/rfws/2026-06-23_rfw-roster.html
audience: pm · depth: 3
This RFW roster page provides essential PM-focused work order aggregation with strong financial summaries, but lacks critical jargon explanations and navigation safety nets.
T1: val=4 red=4 help=5
T2: clarity=4 design=4 nav=3
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Add help badges (?) next to RFW, Est/Actual, and L/M in table headers with tooltips explaining terms
- Add back navigation link to parent Work Orders page (current depth 3 has no back path)
Alternative Presentations:RFW Dashboard — Better for quick executive review but less useful for PMs needing granular RFW details; tradeoff is reduced table functionality
Quick win: Add tooltip help badges for RFW, Est/Actual, and L/M in table headers New page idea: RFW Detail Page: Consolidated view with full notes, document history, and status workflow
~ 4.0
work-orders/vpt/2026-06-12_vpt-board.html
audience: pm · depth: 3
Valuable payment dashboard with strong data organization but missing critical tooltips and sticky header functionality.
T1: val=4 red=4 help=5
T2: clarity=4 design=3 nav=4
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: pass empty states: pass intrapage link consistency: pass tooltip viewport: pass text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Sticky header missing (automated check failed), causing header to scroll out of view during table navigation
- Missing tooltips for 'FM' (Field Manager) and 'Age' (d=days) columns; add ? help badges with explanations
Alternative Presentations:Payment Status Dashboard — Better for quick executive reviews but sacrifices detailed property-level data; tradeoff is reduced context for PMs
Quick win: Add tooltips to 'FM' and 'Age' headers explaining abbreviations and 'd' notation New page idea: Vendor Payment Detail Page with payment history timeline and document audit trail
~ 4.2
work-orders/2026-05-11_non-plans-cheat-sheet.html
audience: pm · depth: 2
Essential reference for non-plans variables but marred by future-dated revision and missing abbreviation explanations.
T1: val=4 red=5 help=5
T2: clarity=4 design=4 nav=3
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: fail empty states: n-a intrapage link consistency: pass tooltip viewport: pass text overlap: pass content clipping: pass expandable overflow: pass tab help badges: fail abbreviation tooltips: fail
Fixes:- Revision date 2026-05-11 is in future (data freshness error), should be corrected to current/past date
- Missing help badges for 'F00' (Form 00) and 'WO' (Work Order) abbreviations in section labels and footer
Alternative Presentations:Estimating Variables Dashboard — Better for active construction use but requires dev work; tradeoff: more useful than static sheet but less immediately available
Quick win: Correct revision date from 2026-05-11 to current date New page idea: Estimating Variables Dashboard: Interactive table showing all variables with filters by timing event/owner
~ 4.2
work-orders/rfws/2026-06-09_rfw-roster.html
audience: pm · depth: 3
A functional RFW roster page that enables PMs to manage work orders, but suffers from dense data presentation, missing help tooltips, and a confusing future-dated title.
T1: val=5 red=5 help=5
T2: clarity=4 design=4 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Fix future-dated filename/title (2026-06-09) to current date to resolve data freshness issue
- Add tooltips for 'L' (Labor) and 'M' (Materials) in estimate columns
- Add help badges (?) for 'Segment' abbreviation in table
- Implement sticky header to remain visible during scroll
- Add back link to parent Work Orders page
Alternative Presentations:RFW Dashboard — Better for quick decisions but less detailed than current table; tradeoff is reduced context for PMs managing multiple RFWs
Quick win: Add tooltips for 'L' and 'M' in estimate columns (L=Labors, M=Materials) New page idea: RFW Details Page with integrated contractor communication history
~ 4.2
work-orders/rfws/2026-06-13_rfw-roster.html
audience: pm · depth: 3
Highly useful central hub for PMs to monitor RFW status/financials, but lacks term explanations and navigation aids.
T1: val=5 red=5 help=5
T2: clarity=4 design=4 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- RFW abbreviation not explained (appears in title/headers without definition)
- L/M labels in estimate columns lack explanation (e.g., 'L: Labor, M: Materials')
- Missing breadcrumb/navigation trail for deep page (click depth 3)
Alternative Presentations:RFW Terms Glossary — Better for new PMs but not a replacement for roster; adds clarity without disrupting current workflow
Quick win: Add 'RFW = Request for Work' tooltip to title header New page idea: RFW Terms Glossary page for onboarding PMs
~ 4.3
work-orders/rfws/2026-06-10_rfw-roster.html
audience: pm · depth: 3
High-value roster page for PMs with strong filtering but needs clarity on split costs and sticky header.
T1: val=5 red=5 help=5
T2: clarity=4 design=4 nav=3
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Estimate/Actual columns show split values (L/M) without explanation; add tooltip or label.
- Header fails to stick on scroll (sticky_header: fail), causing navigation friction for long tables.
Alternative Presentations:RFW Dashboard — Better for strategic decisions but less useful for day-to-day PM task management; tradeoff is reduced detail for overview.
Quick win: Add 'L=Lab, M=Mat' tooltip to split cost columns for immediate clarity. New page idea: RFW Detail Page: Single RFW view with full notes, document history, and approval workflow.
~ 4.3
work-orders/vpt/2026-06-11_vpt-board.html
audience: pm · depth: 3
Critical vendor payment tracker with strong summary and filtering, but lacks sticky headers and abbreviation explanations.
T1: val=5 red=5 help=5
T2: clarity=4 design=3 nav=4
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: pass empty states: pass intrapage link consistency: pass tooltip viewport: pass text overlap: pass content clipping: pass expandable overflow: pass tab help badges: fail abbreviation tooltips: fail
Fixes:- Add sticky header to table header for better usability on long tables (currently scrolls out of view)
- Add ? help badge to 'FM' column header with tooltip explaining 'Field Manager'
Alternative Presentations:Vendor Payment Dashboard — Better for high-level oversight but loses granular vendor details; tradeoff is reduced detail for faster scanning
Quick win: Implement sticky table header for persistent column headers New page idea: Work Order Detail View: Single-page deep dive with approval workflow and document history
✓ 4.5
work-orders/rfws/2026-05-27_rfw-roster.html
audience: pm · depth: 3
A well-structured roster of active RFWs for two properties, but missing help badges for key terms and a sticky header.
T1: val=4 red=4 help=5
T2: clarity=5 design=5 nav=4
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: pass empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Missing ? help badges for 'RFW' and 'QB Sub-Customer' terms (currently only explained in footer)
- Sticky header fails automated check - requires CSS fix to remain visible during scrolling
- No tooltips for abbreviations (e.g., 'RFW' not explained on hover despite being core terminology)
Alternative Presentations:RFW Dashboard — Superior for ongoing management but over-engineered for this static snapshot use case
Quick win: Add ? help badges next to 'RFW' in header and 'QB Sub-Customer' in table header New page idea: RFW management dashboard with create/edit forms (replacing command-line tool)
✓ 4.5
work-orders/vpt/2026-06-09_vpt-board.html
audience: pm · depth: 3
Highly valuable operational dashboard for PMs with clear payment pipeline visualization, but requires minor UX fixes for clarity and accessibility.
T1: val=5 red=5 help=5
T2: clarity=4 design=4 nav=4
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: pass empty states: pass intrapage link consistency: pass tooltip viewport: pass text overlap: pass content clipping: pass expandable overflow: pass tab help badges: fail abbreviation tooltips: fail
Fixes:- Missing sticky header (automated check failed) - header scrolls off-screen during table navigation
- No tooltips for abbreviations: 'PO' (Purchase Order), 'FM' (Field Manager), and 'Segment' (work type category)
- No help badges for ambiguous columns: 'Age' (days since invoice) and 'Contract' (total contract amount vs. remaining)
Alternative Presentations:Property-Specific Payment View — Better for deep dives into one property, but loses cross-property overview that's critical for PMs managing multiple sites
Quick win: Add tooltip to 'PO' header: 'PO = Purchase Order' New page idea: Vendor Payment History Dashboard showing past 6 months' payment trends
✓ 4.5
work-orders/vpt/2026-06-15_vpt-board.html
audience: pm · depth: 2
A highly functional vendor payment dashboard that enables PMs to track and act on work orders, though it lacks critical abbreviation explanations.
T1: val=5 red=5 help=5
T2: clarity=4 design=4 nav=4
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: pass empty states: pass intrapage link consistency: pass tooltip viewport: pass text overlap: pass content clipping: pass expandable overflow: pass tab help badges: fail abbreviation tooltips: fail
Fixes:- Missing help badges for filter labels (Property/Status) and no explanation for 'QC' status abbreviation in table
- No tooltip/explanation for 'FM' (Field Manager) abbreviation in table column
Alternative Presentations:Compact Work Order Summary — Better for mobile, but sacrifices detailed context needed for PM decision-making
Quick win: Add ? help badges to Property/Status filter labels with definitions New page idea: Status Definitions Reference Page (explaining all payment statuses/abbreviations)
✗ 0
work-orders/rfws/2026-06-16_rfw-roster.html
audience: ? · depth: 3
T1: val=? red=? help=?
T2: clarity=? design=? nav=?
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: fail empty states: pass intrapage link consistency: pass
Workflow
! 2.7
workflow/2026-05-08_four-stream-intake-overview.html
audience: admin · depth: 3
A visually consistent workflow diagram that lacks explanatory context and actionable elements for the admin audience.
T1: val=3 red=4 help=2
T2: clarity=2 design=3 nav=2
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: n-a empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: pass tab help badges: fail abbreviation tooltips: fail
Fixes:- Meta-block incorrectly states 'Audience: Executive / Owner' when page is for admin; update to match metadata.
- Missing stream name explanations (e.g., '01' = 'Money Out Triggers') causing confusion in diagram.
- No legend or key for stream colors/stages; diagram requires prior knowledge to interpret.
Alternative Presentations:Interactive Workflow Explorer — Superior for discovery but requires development effort; tradeoff is complexity vs. static diagram's simplicity.
Quick win: Add a 4-item legend below diagram listing streams with names (e.g., '01: Money Out Triggers') and color codes. New page idea: Stream-specific workflow pages (e.g., 'Money Out Triggers Pipeline') for deeper admin analysis.
! 2.8
workflow/index.html
audience: admin · depth: 1
This page serves as a minimal hub for workflow diagrams but is currently broken due to missing iframe content and lacks descriptive context, making it difficult for admins to navigate effectively.
T1: val=4 red=4 help=3
T2: clarity=2 design=2 nav=2
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: n-a empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: pass tab help badges: fail abbreviation tooltips: n-a
Fixes:- Missing src attributes on iframes for Admin & Design, Full Business, and Additional tabs (only first tab has valid src)
- Inconsistent tab labels vs. iframe titles (e.g., 'Admin & Design' tab vs. 'Admin, Accounting & Design Flow' iframe title)
- Missing help badges (?) for tabs to explain workflow purposes
Alternative Presentations:Workflow Directory — Better for accessibility and content discovery (no iframe loading issues), but requires reworking all workflow content
Quick win: Add correct src attributes to all iframes (e.g., 'admin-design-flow.html' instead of empty) New page idea: Workflow directory page with searchable cards showing workflow name, purpose, and direct link (replacing iframe hub)
! 3.2
workflow/2026-05-05_stream-04-flow.html
audience: admin · depth: 3
The page provides a clear visual reference for the Ops Logs workflow but lacks step explanations and navigation, making it less actionable for Admins.
T1: val=4 red=4 help=3
T2: clarity=3 design=3 nav=2
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: n-a empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Add tooltips for unexplained abbreviations (VPT, QB, WA GC) in workflow description.
- Add back navigation link to parent Stream 04 overview page.
Redesigns:- Redesign diagram to include step descriptions (e.g., hover tooltips or sidebar) instead of dense visual-only flow.
Alternative Presentations:Ops Logs Workflow Table — Better for Admins needing to understand specific steps (vs. visual flow), but loses spatial relationship of parallel processes.
Quick win: Add legend for VPT/QB/WA GC below workflow description. New page idea: Workflow Status Dashboard: Aggregates all stream statuses with gap resolution tracking.
! 3.3
workflow/2026-05-05_stream-02-flow.html
audience: admin · depth: 3
Clear visual reference for Stream 02 workflow but lacks essential legends, navigation, and abbreviation explanations.
T1: val=4 red=4 help=3
T2: clarity=4 design=3 nav=2
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: n-a empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Add color legend to diagram (e.g., 'Green: Payment screenshot, Blue: Bank feed entry') to explain visual coding
- Add tooltips for 'WA' (WhatsApp) and 'QB' (QuickBooks) in diagram captions
- Add back navigation to Stream 02 overview page (current depth=2 requires parent link)
Alternative Presentations:Stream 02 — Flow Summary (Text) — Better for screen readers but loses visual flow context; use as fallback if diagram fails accessibility checks
Quick win: Add color legend box in diagram footer (5-min CSS tweak) New page idea: Stream 02 Troubleshooting Guide: Common 'No-Match' scenarios with resolution steps
~ 3.5
workflow/2026-05-05_stream-03-flow.html
audience: admin · depth: 3
Clear visual workflow for Records stream but lacks critical accessibility features and navigation support for admin reference use.
T1: val=4 red=4 help=3
T2: clarity=4 design=4 nav=2
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: n-a empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: pass tab help badges: fail abbreviation tooltips: fail
Fixes:- Add tooltip for 'WA' abbreviation in START node (Document arrives) to explain meaning.
- Add ? help badges for key terms like 'Action-first?' and 'SLA' to explain jargon.
- Add back link to parent workflow page and stream navigation in masthead.
Alternative Presentations:Stream 03 — Records Flow (Text Summary) — Better for quick reference and accessibility, but loses visual flow context. Tradeoff: more text vs. immediate visual understanding.
Quick win: Add tooltip for 'WA' in START node text New page idea: Text-based workflow summary page for admins who prefer reference over diagrams
~ 3.5
workflow/2026-06-23_admin-design-flow.html
audience: admin · depth: 3
A well-structured workflow diagram for admin reference, but lacks actionable elements and a back navigation path.
T1: val=4 red=4 help=3
T2: clarity=4 design=4 nav=2
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: n-a empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Add back link to Operations page in header (currently only text breadcrumb) and implement ? help badges for IHA/P0.5 with tooltips explaining abbreviations
Alternative Presentations:Admin Workflow Text Summary — Better for quick reference without visual complexity, but less intuitive for understanding process flow than diagram
Quick win: Add clickable breadcrumb link to Operations page New page idea: Admin Workflow Checklist: Interactive page to track status of each flow step with owner/PM assignments
~ 3.5
workflow/2026-06-23_full-business-flow.html
audience: admin · depth: 3
A well-structured reference diagram for the full business flow, but lacks navigation aids and actionable elements for the Admin audience.
T1: val=4 red=4 help=3
T2: clarity=4 design=4 nav=2
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: n-a empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: pass tab help badges: pass abbreviation tooltips: pass
Fixes:- Missing back navigation link for deep page (click depth 3); add 'Back to Workflow Overview' link
Alternative Presentations:Interactive flow explorer — Better for discovery but over-engineered for reference-only use; tradeoff is complexity vs. usability
Quick win: Add 'Back' link to parent workflow page in header New page idea: Team-specific flow summaries (e.g., 'Admin-Only Workflow' for accounting handoffs)
~ 3.7
workflow/2026-05-05_pipeline-overview.html
audience: admin · depth: 3
Clear visual reference for intake pipeline stages but lacks navigation aids and jargon explanations.
T1: val=4 red=4 help=4
T2: clarity=4 design=4 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: n-a empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Add help badges (?) next to abbreviations like 'WA' and 'Streams' with tooltips explaining them.
- Add back navigation link to parent workflow page (e.g., in masthead or breadcrumb).
Alternative Presentations:Pipeline Stage Reference Table — Better for quick scanning but less intuitive than visual flow; tradeoff is reduced cognitive load for text-focused users vs. visual sequence understanding.
Quick win: Add tooltips for 'WA' (WhatsApp) and 'Streams' (system categories) using ? badges. New page idea: Intake Pipeline Dashboard showing real-time item counts per stage with filters.
~ 3.7
workflow/light-versions/2026-05-15_data-storage-map.html
audience: admin · depth: 3
A well-structured workflow reference for admins, but navigation is poor and key terms like 'WA' are unexplained.
T1: val=4 red=4 help=4
T2: clarity=4 design=4 nav=2
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: n-a empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Replace 'WA' with 'WhatsApp' or add tooltip explaining 'WA' as 'WhatsApp group chat' (used in Trigger/SLA sections)
- Change ambiguous branch labels (e.g., 'Yes' → 'Tagged as late/advanced?', 'No' → 'Not tagged')
- Update masthead date from 2026-05-15 to current date or remove (future-dated reference)
Redesigns:- Add back link to Stream 04 overview and links to related pages (e.g., VPT entry, Stream 01)
Alternative Presentations:Interactive Workflow Explorer — Better for active task management but requires development effort; current reference format is sufficient for static documentation
Quick win: Add tooltip for 'WA' explaining it as 'WhatsApp group chat' in Trigger section New page idea: Admin dashboard for tracking labor hour submission status (pending/audited/ready for VPT)
~ 3.7
workflow/light-versions/2026-05-15_property-capture-flow.html
audience: admin · depth: 3
Clear workflow reference for Admins but lacks essential navigation for deep page.
T1: val=4 red=4 help=4
T2: clarity=4 design=4 nav=2
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: n-a empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: pass abbreviation tooltips: pass
Fixes:- Missing back navigation link for deep page (click_depth 2).
Alternative Presentations:Interactive Flow Explorer — Superior for exploration but requires dev work; current static version suffices for reference.
Quick win: Add 'Back to Workflow Hub' link in masthead footer. New page idea: Workflow version history page showing change logs for all flow diagrams.
~ 4.0
workflow/2026-06-23_admin-accounting-flow.html
audience: admin · depth: 3
A well-designed workflow diagram that clearly outlines the accounting process but lacks back navigation and abbreviation explanations.
T1: val=4 red=4 help=4
T2: clarity=4 design=5 nav=3
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: n-a empty states: n-a intrapage link consistency: pass tooltip viewport: pass text overlap: pass content clipping: pass expandable overflow: pass tab help badges: fail abbreviation tooltips: fail
Fixes:- Add back navigation link for deep page (click depth 3)
- Add ? help badges next to abbreviations (WA, EOD) with tooltips explaining them
Alternative Presentations:Interactive Workflow Explorer — Better for active use but requires dev work; current static diagram suffices for reference but lacks interactivity
Quick win: Add 'Back to Admin Dashboard' link in header for deep pages New page idea: Portal-wide glossary page for all internal abbreviations
~ 4.2
workflow/2026-05-06_who-approves-what.html
audience: admin · depth: 3
Essential reference for admin role with clear approval structure, but navigation and technical issues hinder usability.
T1: val=5 red=5 help=5
T2: clarity=4 design=4 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: n-a empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: pass tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Implement sticky header to maintain title/navigation visibility during scrolling (automated check failed).
- Add breadcrumb/back link to parent Workflow page for proper navigation (current page lacks exit path).
Alternative Presentations:Interactive Approval Flow — Better for training but over-engineered for reference; tradeoff is development effort vs. static clarity.
Quick win: Fix sticky header implementation (CSS adjustment, <30 min). New page idea: Approval Checklist: Step-by-step task list per gate with completion tracking.
~ 4.2
workflow/light-versions/2026-05-15_stream-01-flow.html
audience: admin · depth: 3
Clear flow diagram for Admins to execute payment triggers, but navigation lacks back path and contains empty step.
T1: val=5 red=5 help=5
T2: clarity=4 design=4 nav=2
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: n-a empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Empty step 04 in 'Rate changed' branch (no action text shown)
- Missing back navigation link for deep-page context (click depth 2)
Alternative Presentations:Interactive Flow Explorer — Better for task execution but over-engineered for this static reference; current diagram suffices for understanding
Admin Checklist View — More actionable but loses visual flow context; current diagram better for process comprehension
Quick win: Add 'Back to Workflow Overview' link in masthead New page idea: Stream Comparison Matrix: Side-by-side view of all streams with triggers/owners
~ 4.3
workflow/2026-05-07_interview-guide.html
audience: admin · depth: 3
Highly actionable reference guide for Admins conducting interviews, but missing navigation and help indicators.
T1: val=4 red=4 help=5
T2: clarity=5 design=5 nav=3
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: n-a empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: pass tab help badges: fail abbreviation tooltips: pass
Fixes:- Missing back link for deep page (click depth 2); add breadcrumb or 'Back to Workflow' link
- Missing ? help badges for priority labels (P0/P1/P2) despite explanation in legend
Alternative Presentations:Tabbed Interview Guide — Better for quick reference during interviews; tradeoff is reduced context for cross-referencing questions
Quick win: Add 'Back to Workflow Documents' link in header/footer New page idea: Interview Guide Index: Master list of all guides with dates/rounds/statuses
Forms
~ 3.8
forms/2026-05-27_estimating_form-00-pre-contract.html
audience: admin · depth: None
Well-structured reference sheet for Form 00, but missing critical help elements and navigation aids.
T1: val=4 red=4 help=4
T2: clarity=4 design=4 nav=3
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: n-a empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: fail abbreviation tooltips: fail
Fixes:- Missing help badges for complex terms (ADU, IHA) and unexplained abbreviations in field hints
- No links to related forms (e.g., Form 01) or back navigation path
Alternative Presentations:Forms Library — Better for discoverability than individual form pages, but requires new page creation; tradeoff is reduced context for specific form details
Quick win: Add ? help badges next to ADU and IHA with tooltips explaining the terms New page idea: Central Forms Library page listing all forms with purpose, timing, and direct links
Guides
~ 4.3
guides/2026-05-18_property-dropbox-quick-reference.html
audience: admin · depth: None
Highly actionable quick reference for filing, but navigation and sticky header issues prevent full usability.
T1: val=4 red=5 help=5
T2: clarity=5 design=4 nav=3
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: n-a empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Add breadcrumb navigation (e.g., 'Guides > Property Dropbox Quick Reference') to replace browser back button for better context
- Fix sticky header failure to maintain header visibility during scrolling
Alternative Presentations:Interactive Filing Assistant — Better for new admins but requires development; current page is sufficient for experienced admins
Quick win: Add 'Back to Guides' link in header to resolve navigation depth issue New page idea: Property Dropbox File Type Guide (categorizing documents by type instead of folder)
Reference
~ 3.7
reference/2026-06-08_rate-cards.html
audience: admin · depth: None
A well-structured reference page for labor rates with clear status indicators, but hindered by excessive table length, missing navigation, and incomplete detail.
T1: val=4 red=5 help=4
T2: clarity=4 design=3 nav=2
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: n-a empty states: pass intrapage link consistency: pass tooltip viewport: n-a text overlap: n-a content clipping: n-a expandable overflow: n-a tab help badges: n-a abbreviation tooltips: n-a
Fixes:- Missing back link to parent reference section (e.g., 'Back to Reference' in header/footer).
Redesigns:- Labor rate table has 53 rows without filtering/search, making it difficult to find specific contractors (e.g., 'Pedro' appears 4 times).
Alternative Presentations:Hector Crew Rate Card (Summary) — Better accuracy (avoids misleading 'Rate Cards' title) but requires updating all internal links; tradeoff is minor naming change vs. persistent confusion.
Quick win: Add 'Back to Reference' link in header/footer to fix navigation. New page idea: Rate Card Management dashboard for admins to update contractor statuses, add new entries, and populate detailed pages.
~ 4.0
reference/labor-rates.html
audience: admin · depth: None
Reference page provides essential labor rate data with good filtering but lacks sticky header and clear empty state handling.
T1: val=4 red=4 help=5
T2: clarity=4 design=4 nav=3
sticky column: n-a sticky header: fail dual scrollbar: n-a data freshness: n-a empty states: fail intrapage link consistency: pass tooltip viewport: pass text overlap: pass content clipping: pass expandable overflow: pass tab help badges: pass abbreviation tooltips: pass
Fixes:- Make table header sticky to maintain column headers during vertical scrolling (current header disappears with table content).
- Implement proper empty state display: show 'No contractors match the current filter' when filtered results are empty (currently hidden by default).
- Remove unnecessary '#' column from table to reduce visual clutter and improve data focus.
- Clarify rate label: change 'Rate / Day' to 'Rate (per day)' for unambiguous interpretation.
Alternative Presentations:Labor Rates with Search — Better for users knowing specific contractor names, but current filter/sort suffices for most reference use cases. Tradeoff: adds one input field but reduces need for multiple filters.
Quick win: Update 'Rate / Day' label to 'Rate (per day)' in table header. New page idea: Labor Rate Management Dashboard (for PMs to update rates, with version history and approval workflow).
~ 4.2
reference/2026-05-13_glossary.html
audience: admin · depth: None
Essential reference for admin team but suffers from structural errors and missing navigation.
T1: val=4 red=5 help=5
T2: clarity=4 design=4 nav=3
sticky column: n-a sticky header: n-a dual scrollbar: n-a data freshness: n-a empty states: n-a intrapage link consistency: pass tooltip viewport: n-a text overlap: pass content clipping: pass expandable overflow: n-a tab help badges: pass abbreviation tooltips: pass
Fixes:- Two identical
E
sections causing structural confusion (Edmar into QB and EOD report should be one section) - Source paths (e.g., reference/operations/workflows/...) are plain text instead of clickable links
- Missing back navigation link for deep page (click depth 3)
Alternative Presentations:Glossary with search — Better for large glossaries (100+ terms) but over-engineered for current size; tradeoff is added complexity vs. immediate usability
Quick win: Merge duplicate E sections and make source paths into relative links New page idea: Glossary search page with filterable terms
Data Consistency (0 discrepancies)
All checked data points consistent across pages.
Fix Backlog (282 items)
- Empty report with no empty state handling; users see a blank page with no guidance.
- No back navigation path for a deep page (click depth 3).
- Dual scrollbar detected (likely due to nested scrollable containers).
- Missing sticky header and sticky column for the table (required for long reports).
- Add direct link to property spend detail page (missing per owner journey J1)
- Fix Portfolio Glance tab iframe to load correct content (currently empty)
- Address data freshness failure (automated check) by ensuring property data updates
- Data is stale (updated in 2026-06-23, a future date); update data source to reflect current dates.
- Abbreviation 'QB' used without explanation; add tooltip defining 'QB' (e.g., 'QuickBooks spend').
- Missing instructions for filling out the form (e.g., examples for 'What needs to be done' field)
- Header not sticky (automated check failed) - add CSS to keep masthead visible during scrolling
- No back navigation path (deep page at click depth 3) - add breadcrumb or back button
- Empty state note is vague; should specify timeline or link to PM chat ingestion process
- Add empty state message to table (e.g., 'No phase performance data available') to prevent confusion
- Explain P1/P2/P3 phases and QB abbreviation via tooltips or footnote
- Add breadcrumb/back link for navigation from deep page (click depth 3)
- Meta-block incorrectly states 'Audience: Executive / Owner' when page is for admin; update to match metadata.
- Missing stream name explanations (e.g., '01' = 'Money Out Triggers') causing confusion in diagram.
- No legend or key for stream colors/stages; diagram requires prior knowledge to interpret.
- Missing src attributes on iframes for Admin & Design, Full Business, and Additional tabs (only first tab has valid src)
- Inconsistent tab labels vs. iframe titles (e.g., 'Admin & Design' tab vs. 'Admin, Accounting & Design Flow' iframe title)
- Missing help badges (?) for tabs to explain workflow purposes
- Table headers are missing (empty ), making activity data unreadable. Add headers like 'Property' and 'Activities'.
- Footer shows fixed date '2026-06-23' while header says 'Updated today'—inconsistent data freshness. Use dynamic date.
- Abbreviation 'PM' used without explanation in header. Add tooltip or brief clarification (e.g., 'PM: Project Manager').
- Missing help badge on 'Date range' button. Add ? icon with tooltip explaining date range functionality.
- Timeline data is outdated (data_freshness: fail); update to reflect current property activity.
- Future dates (2025-2026) shown in timeline contradict '2011–present' claim; remove future dates.
- Abbreviation 'Mo' (for months) used without explanation; add tooltip or legend.
- No back link to main properties page; add breadcrumb or back button.
- Add sticky header to table to maintain column headers during horizontal scrolling (automated check failed).
- Replace blank variance cells ('—') with 'N/A' or remove column if variance is not calculated.
- Replace future-dated iframe filename (actualsboard-construction-2026-06-22.html) with current data source to fix data freshness failure
- Add prominent 'View Property Spend Details' link in header to address journey friction (missing property spend detail link)
- Replace '—' with 'N/A' for missing sqft data to avoid confusion; add tooltip explaining 'AG' (e.g., 'AG: Above Ground') for 'Sqft (AG)' header.
- Add back navigation link to parent Financials page (current page lacks breadcrumb/back path).
- Update 'Updated 2026-06-22' to current date (data freshness fail)
- Add tooltip explanation for 'EDD' column header (abbreviation_tooltips fail)
- Tab 'AP Pipeline' mislabels VPT tracker; change to 'VPT Tracker' to match purpose statement
- Missing direct link to PM roster page (journey friction: J3 requires this link from WO hub)
- Abbreviations 'RFW' and 'VPT' lack tooltips/explanations despite help badges being present
- Add tooltips for unexplained abbreviations (VPT, QB, WA GC) in workflow description.
- Add back navigation link to parent Stream 04 overview page.
- Add explanation for 'Gaps' (16) and clarify [GAP] notation in 'Recorded' stage description
- Fix sticky header (currently fails) for better navigation on long pages
- Break dense stage descriptions into bullet points for scannability
- Header incorrectly states 'COMPLETED' when 0/49 work orders are complete; change to 'IN PROGRESS' or similar
- Add ? help badges for work order codes (P1, P2, W01a) to explain abbreviations
- Add back navigation to properties list and links to related pages (e.g., PM dashboard)
- Replace monospace font in table with standard sans-serif for portal consistency
- Add empty state message for VPT table (currently empty, causing confusion)
- Add ? help badges to table headers (e.g., 'Segment', 'Contract') for jargon explanation
- Fix sticky header issue (automated checklist shows failure)
- Add back navigation path for deep page (click depth 3)
- Sticky header not implemented (automated fail)
- Missing help badges for tabs (e.g., ? next to 'This Week' tab)
- No tooltips for abbreviations (WO, PM) in work order table
- Missing link from hub (main page) to this page (journey context: 'Hub should link to portfolio glance')
- Explain 'QB' as 'QuickBooks' with a tooltip or footnote (currently used as unexplained abbreviation).
- Correct future date '2026-06-22' to current date or dynamic placeholder (e.g., 'as of [current date]').
- Expand 'VPT' abbreviation in table header (likely 'Vendor Payment Tracking') or add tooltip.
- Add tooltip for 'com' abbreviation in cost rows (e.g., '+$93K com' should explain 'comparable' or 'commission')
- Add link to non-construction companion board in titleblock (currently only mentioned in subheading)
- Implement sticky headers for table (currently fails automated check)
- Sticky header is missing (automated check fail), causing column headers to disappear during table scrolling.
- Add title attributes to segment codes (e.g., '16') to explain segment names (Project Prep, etc.).
- Tooltip for Multi-Property vendors overflows viewport; implement viewport-aware tooltip positioning.
- Add sticky header (CSS fix) to address automated checklist failure
- Add ? help badges next to P0 note and phase labels (P0/P1/P2) to explain accounting categories and phase meanings
- Add breadcrumb/back link to WO hub (current journey friction: missing link from hub to roster)
- Add color legend to diagram (e.g., 'Green: Payment screenshot, Blue: Bank feed entry') to explain visual coding
- Add tooltips for 'WA' (WhatsApp) and 'QB' (QuickBooks) in diagram captions
- Add back navigation to Stream 02 overview page (current depth=2 requires parent link)
- Add help badge to 'Used At' column header to explain its meaning (e.g., 'Property where material is installed').
- Make page header sticky to maintain table column headers during scrolling.
- Style empty state (currently hidden) to display clear message when no results match filters.
- Phase timeline shows 'Done ✓' for P1 while bar indicates 90.7% completion (contradiction). Must fix data presentation.
- Missing tooltip for 'QB' in footer (PM activity · QB as of 2026-06-23) - requires explanation of abbreviation.
- No help badge for phase timeline metrics (e.g., 'behind' calculation) despite complex visual data.
- Footer shows future date '2026-06-23' instead of current data refresh time; requires copy fix.
- Table headers not sticky (sticky_column: fail), causing loss of context during horizontal scrolling.
- Missing ? help badge for 'PM' in footer; should trigger tooltip explaining 'Project Manager'.
- Abbreviation 'PM' not explained in tooltip; requires tooltip content addition.
- Add missing hub link (journey context: 'Missing link: Hub should link to portfolio glance')
- Explain 'Mo' abbreviation in active pipeline table (used in 'Mo Held' and 'Mo Interest' columns)
- Fix active pipeline table average row: show calculated average purchase price instead of '—'
- Add note clarifying that 'Avg Sale Price' and 'Avg Gross Spread' stats apply only to completed properties
- Standardize terminology: change 'Buy Price' to 'Purchase' in completed properties table to match active pipeline
- Explanatory note uses 10px monospace font (hard to read) - increase to 12-14px for accessibility
- No back link or breadcrumbs on deep page (click_depth=3), making navigation difficult
- Add sticky header to table to keep headers visible during scrolling (automated checklist: sticky_header: fail)
- Add breadcrumb or back link for deep page (click_depth: 2) to improve navigation
- Add tooltip or explanation for phase abbreviations (P1/P2/P3) in table
- Split amounts (L/M) in Estimate/Actual columns lack explanation, causing confusion
- Header not sticky (per automated checklist), making table navigation difficult on long pages
- Data freshness check failed (likely stale date 2026-06-12 in title)
- Add ? help badges for 'L' and 'M' in Estimate/Actual columns and for 'Segment' to explain their meaning.
- Add breadcrumb navigation (e.g., Work Orders > RFW Registry > 2026-06-15) to enable back navigation from deep page.
- Explain 'RFW' abbreviation on page (e.g., in title or footnote) as it's critical to PM workflow.
- Title shows future date (2026-06-23) instead of current date; update to reflect actual data freshness
- Header does not stick on scroll; add sticky header CSS for better table navigation
- WO hub page (work-orders/wo-hub.html) lacks link to this roster; add direct navigation path
- Note for RFW#01 at 185 Fernwood is cut off ('Shlomo - Let’s reconsider/rev'); complete text
- Estimate/Actual columns use unexplained split labels (L/M); add tooltips or explanation
- Add tooltip for 'WA' abbreviation in START node (Document arrives) to explain meaning.
- Add ? help badges for key terms like 'Action-first?' and 'SLA' to explain jargon.
- Add back link to parent workflow page and stream navigation in masthead.
- Add back link to Operations page in header (currently only text breadcrumb) and implement ? help badges for IHA/P0.5 with tooltips explaining abbreviations
- Missing back navigation link for deep page (click depth 3); add 'Back to Workflow Overview' link
- Update 'Updated' timestamp from future date (2026-06-23) to current date to resolve data freshness failure.
- Implement sticky header to maintain filter bar visibility during scrolling (currently fails sticky_header check).
- Missing back link to parent reference section (e.g., 'Back to Reference' in header/footer).
- Add ? help badges for segment codes (16, 18, etc.) with tooltips explaining segment names.
- Add breadcrumb/back link to parent reports page (current depth 3 has no return path).
- Fix sticky header (currently failing) to maintain header visibility during scroll.
- Add back button/navigation trail for deep page (click depth 3)
- Add help badges (?) next to segment codes and "Committed" with tooltips
- Add sticky header to keep filter bar visible during long scrolls (automated check: sticky_header: fail)
- Add ? help badges for RFW (Request for Work) and QB (QuickBooks) with tooltips
- Add tooltips explaining 'L' (Labor) and 'M' (Materials) in estimate/actual columns
- Add breadcrumb navigation (e.g., Home > Work Orders > RFW Roster) for deep page context
- Add help badges (?) next to abbreviations like 'WA' and 'Streams' with tooltips explaining them.
- Add back navigation link to parent workflow page (e.g., in masthead or breadcrumb).
- Replace 'WA' with 'WhatsApp' or add tooltip explaining 'WA' as 'WhatsApp group chat' (used in Trigger/SLA sections)
- Change ambiguous branch labels (e.g., 'Yes' → 'Tagged as late/advanced?', 'No' → 'Not tagged')
- Update masthead date from 2026-05-15 to current date or remove (future-dated reference)
- Missing back navigation link for deep page (click_depth 2).
- Missing help badges for complex terms (ADU, IHA) and unexplained abbreviations in field hints
- No links to related forms (e.g., Form 01) or back navigation path
- Sticky header fails (automated check), causing header to scroll out of view during long page navigation.
- Empty sqft stats for property '52 Wildwood' should display 'N/A' instead of blank
- Replace '—' in 'months' badge with 'N/A' for property '32 Clinton'
- Add 'Last updated' timestamp to address data freshness failure
- Add help badges (?) for 'months in pipeline' and 'above-grade' with tooltips
- Add breadcrumb/back link to parent page for navigation depth
- Sticky header is not functioning (automated check failed). Implement CSS to maintain column headers during scrolling.
- Add tooltip explanation for representative code format (e.g., "##.0 = base code") to clarify "16.0" notation
- Replace title attribute tooltips with standard ? help badges for representative codes
- Add sticky headers/columns to deal economics table (currently fails sticky_header/sticky_column checks) for better table navigation.
- Add back navigation path (breadcrumb or 'Back' button) for this deep page (click depth 2).
- Future date '2026-06-15' in 'Updated' timestamp (should be current date) causing data freshness failure.
- Abbreviation 'FM' used without explanation in meta text ('FM assigned') — requires tooltip or expansion.
- Missing link to order tracking (per journey context J4) — VPT hub should link to order tracking for cross-reference.
- Add help badges (?) next to technical keys (e.g., `appliance_finish_brass`) with explanatory tooltips
- Fix sticky header to remain visible during scrolling
- Price for fixed assemblies (e.g., $1,083 – $1,083) should display as single number (e.g., $1,083) to avoid confusion
- Property addresses in 'Used at' section (e.g., '63 Montclair') should be hyperlinked to corresponding property pages
- Abbreviation 'CC' (in 'CC processing fee') should be explained as 'credit card' or replaced with full term
- Link to IHA document formatted as code block (`
iha-plan-template-variables.md`) instead of standard hyperlink, causing confusion and potential non-clickability - Missing back navigation path for deep page (click depth 3), violating portal navigation standards
- Sticky header missing (automated fail) - implement CSS to keep header visible during scrolling
- No help badges for technical terms (Ollama, vector index, cluster) - add ? tooltips with explanations
- Abbreviations like 'Ollama' and 'vector index' not explained - add glossary tooltips
- Status Board card description is truncated in HTML (cut off mid-sentence)
- Make table header sticky to maintain column headers during vertical scrolling (current header disappears with table content).
- Implement proper empty state display: show 'No contractors match the current filter' when filtered results are empty (currently hidden by default).
- Remove unnecessary '#' column from table to reduce visual clutter and improve data focus.
- Clarify rate label: change 'Rate / Day' to 'Rate (per day)' for unambiguous interpretation.
- Replace absolute terminal path (/Users/mac/My Drive/...) with relative path to avoid user-specific paths.
- Add ? help badges for abbreviations (WO, QB) with tooltips explaining them.
- Implement sticky header to improve navigation on long pages (per automated check).
- First use of 'WO' (work order) lacks explanation; should be spelled out or have tooltip on first occurrence.
- Table visual marks (†, *, ◆) not explained in table itself; rely on later section examples causing confusion.
- Source reference points to markdown file (reference/cost-codes/budget-source-taxonomy.md) instead of user-friendly link.
- Add sticky header to table to keep column headers visible during scrolling (automated fail).
- Add title attribute to segment codes (e.g., '16') to explain segment names (e.g., 'Project Prep').
- Add help badge (?) next to 'Committed' with tooltip explaining 'Budgeted but not yet spent'.
- Update revision date from 2026-05-11 (future date) to current/past date to fix data freshness.
- Add back navigation path (breadcrumb or back button) for depth-2 page.
- Add tooltips/explanations for abbreviations (e.g., 'lnft' = linear feet, 'y/n' = yes/no) in table.
- Add help badges explaining technical abbreviations (e.g., 'lnft' for linear feet) next to variable names
- Convert 'Feeds' work order tags (e.g., P3W04) into clickable links to actual work order pages
- Add tooltips explaining 'L' and 'M' in financial columns (e.g., 'L' for Labor, 'M' for Materials)
- Add tooltip for 'RFW' abbreviation in table headers (Request for Work)
- Implement sticky header to maintain filter bar visibility during table scrolling
- Add '?' help badges next to 'Estimate' and 'Actual' columns for financial context
- Add ? help badges next to 'Estimate' and 'Actual' columns to explain 'L' (Labor) and 'M' (Materials) abbreviations.
- Add visible back link (e.g., 'Back to Work Orders') to improve navigation from deep page.
- Add help badges (?) next to RFW, Est/Actual, and L/M in table headers with tooltips explaining terms
- Add back navigation link to parent Work Orders page (current depth 3 has no back path)
- Sticky header missing (automated check failed), causing header to scroll out of view during table navigation
- Missing tooltips for 'FM' (Field Manager) and 'Age' (d=days) columns; add ? help badges with explanations
- Add back navigation link for deep page (click depth 3)
- Add ? help badges next to abbreviations (WA, EOD) with tooltips explaining them
- Boards section head incorrectly states '2 BOARDS' when 3 boards exist (Actuals, Insight, Comp Performance)
- Missing tooltips for key terms: 'EOM' (End of Month), 'Non-Construction', 'Comp Performance' (Comparables Performance)
- Explain 'WO' as abbreviation for 'Work Order' on first use (e.g., 'WO (Work Order) code' in Step 3)
- Add direct link to Vendor Payment Tracker (VPT) sheet from Step 3
- Add breadcrumb navigation for deep page (current click depth 2)
- Add tooltips for unexplained terms like 'Stream 02', 'JJ Crew', and 'QB' (QuickBooks) to prevent confusion for new Admins.
- Link 'Transaction Query Sheet' and 'Vendor Reconciliation Sheets' from Key Workflows section to actual resources.
- Complete truncated 'Daily Output' section (currently cut off mid-sentence in HTML).
- Add back navigation to parent Operations page (currently no breadcrumb/back link).
- Link to capture form points to markdown file (00-pre-contract.md) instead of rendered internal page; update to proper URL
- Draft version number (Draft 3) conflicts with filename date (2026-05-29) - verify and correct date consistency
- Link 'Scope Library page' text to actual page URL instead of plain text
- Add back navigation link to parent 'Guides' page for click depth 2 context
- Data note shows future date '2026-06-22' instead of current date; update to reflect actual data date.
- Missing back navigation path for deep page (click depth 3); add breadcrumb or back button.
- No links from property rows to detail pages; add interactive links for drill-down.
- Two identical
E
sections causing structural confusion (Edmar into QB and EOD report should be one section) - Source paths (e.g., reference/operations/workflows/...) are plain text instead of clickable links
- Missing back navigation link for deep page (click depth 3)
- VPT abbreviation used 8 times without explanation; add tooltip or first-use definition
- Missing back navigation for deep page (click depth 2); add breadcrumb or back button
- Add ? help badges for time zone abbreviations (ET/PHT) and QBO to meet checklist, though note-strip already explains them
- Fix sticky header (CSS tweak) to remain visible during scrolling
- Add tooltip explanations for 'Recon' (reconciliation) and 'Temp Notes' in Edmar's card
- Add help badges (?) next to abbreviations (SOW, NFA, recon) with tooltips explaining terms
- Add back navigation link to parent reference page (e.g., 'Back to Reference Guide')
- Remove empty rows (with '---') from all variable tables to eliminate visual noise and improve data clarity.
- Add breadcrumb navigation (e.g., 'Reference > Plan Outputs') to support depth-2 page navigation.
- Revision date 2026-05-11 is in future (data freshness error), should be corrected to current/past date
- Missing help badges for 'F00' (Form 00) and 'WO' (Work Order) abbreviations in section labels and footer
- Fix future-dated filename/title (2026-06-09) to current date to resolve data freshness issue
- Add tooltips for 'L' (Labor) and 'M' (Materials) in estimate columns
- Add help badges (?) for 'Segment' abbreviation in table
- Implement sticky header to remain visible during scroll
- Add back link to parent Work Orders page
- RFW abbreviation not explained (appears in title/headers without definition)
- L/M labels in estimate columns lack explanation (e.g., 'L: Labor, M: Materials')
- Missing breadcrumb/navigation trail for deep page (click depth 3)
- Implement sticky header to maintain title/navigation visibility during scrolling (automated check failed).
- Add breadcrumb/back link to parent Workflow page for proper navigation (current page lacks exit path).
- Empty step 04 in 'Rate changed' branch (no action text shown)
- Missing back navigation link for deep-page context (click depth 2)
- Sticky header fails (CSS issue) - header does not remain visible during scroll
- Inconsistent table headers: 'Scale' vs 'Notes' column labels cause confusion (e.g., P0W14 uses Notes, P1W03 uses Scale)
- No back navigation path for deep page (click_depth: 3) - add breadcrumb or 'Back to Reference' link
- Missing back navigation path for depth-2 page (no breadcrumb or 'Back' link)
- Inconsistent link styling: vendor-plan-template-variables.md link uses code block instead of standard link
- Add breadcrumb navigation (e.g., 'Guides > Property Dropbox Quick Reference') to replace browser back button for better context
- Fix sticky header failure to maintain header visibility during scrolling
- Term 'RFW' (used in 'RFW Authorization') is unexplained in key numbers section. Add tooltip or expand to 'Request for Work' for clarity.
- Missing back navigation link for secondary page (click depth 2) - should include breadcrumb or 'Back' button
- Sticky header broken (header doesn't stick on scroll), small CSS fix needed
- Missing help badges for technical terms (e.g., WO, Segment, Cost Code) — add ? icons with explanations
- No tooltips for abbreviations (e.g., WO, Segment) — implement hover tooltips for all acronyms
- Missing back navigation for deep page (click_depth 2) — add breadcrumb or back button
- Make header sticky (currently fails sticky_header check) to maintain navigation while scrolling through vendor list.
- Make expired COI dates more prominent (e.g., red text/bold) in compliance column to prevent missed expirations.
- Replace specific terminal path '/Users/mac/My Drive/...' with generic placeholder (e.g., 'your/vg/directory') to avoid user confusion.
- Add help badges (?) for 'WO' (Work Order) and 'QB' (QuickBooks) with tooltips explaining abbreviations.
- Fix sticky header CSS (automated check failed) to maintain navigation visibility on long pages.
- Estimate/Actual columns show split values (L/M) without explanation; add tooltip or label.
- Header fails to stick on scroll (sticky_header: fail), causing navigation friction for long tables.
- Add sticky header to table header for better usability on long tables (currently scrolls out of view)
- Add ? help badge to 'FM' column header with tooltip explaining 'Field Manager'
- Missing back link for deep page (click depth 2); add breadcrumb or 'Back to Workflow' link
- Missing ? help badges for priority labels (P0/P1/P2) despite explanation in legend
- Remove 'Generated' and 'Source' metadata from title block as they provide no value to Admins
- Add tooltips for abbreviations (IHA, WO, PM, VG) used in card metadata
- Replace browser title tooltips with ? help badges for representative cost code indicators (e.g., '16.0 ▸' should have a ? icon)
- Missing back path for click_depth=2 page (add breadcrumb or 'Back to Guides' link)
- CoConstruct not explained on first use (add tooltip or brief definition)
- Unexplained abbreviations (VPT, EOD, QB) used in content without tooltips or expansion
- Replace native title tooltips with ? help badges for representative codes (e.g., '16.0 ▸' should have a ? icon instead of title attribute)
- Add tooltip explanation for 'WO' abbreviation in key numbers section (currently uses 'WO' without definition)
- Missing tooltip for 'Phase' column explaining P1/P2/P3 and Non-Con abbreviations
- Duplicate link in 'Admin Group Chat' definition ('→ See VG: Admin Junkie. → See VG: Admin Junkie.')
- Incomplete definition for 'Bill Payment' (cut off at 'for l')
- Future-dated generated timestamp (2026-06-09) in titleblock
- Non-link reference to 'VG: Admin Junkie' in definitions (should be hyperlinked)
- Correct future date (2026-05-18) in 'Updated' field to current year to fix data freshness.
- Replace markdown file link ('reference/cost-codes/budget-source-taxonomy.md') with user-friendly link to actualsboard report.
- Add back navigation link (e.g., 'Back to Actualsboard') for deep-page accessibility.
- Missing ? help badges for 'RFW' and 'QB Sub-Customer' terms (currently only explained in footer)
- Sticky header fails automated check - requires CSS fix to remain visible during scrolling
- No tooltips for abbreviations (e.g., 'RFW' not explained on hover despite being core terminology)
- Missing sticky header (automated check failed) - header scrolls off-screen during table navigation
- No tooltips for abbreviations: 'PO' (Purchase Order), 'FM' (Field Manager), and 'Segment' (work type category)
- No help badges for ambiguous columns: 'Age' (days since invoice) and 'Contract' (total contract amount vs. remaining)
- Missing help badges for filter labels (Property/Status) and no explanation for 'QC' status abbreviation in table
- No tooltip/explanation for 'FM' (Field Manager) abbreviation in table column
- Missing back link for deep page (click depth 2) - should link to parent forms directory
- Sticky header failure (automated) - requires CSS fix to maintain navigation access
- Add back link to guides index (current page is click_depth=2 but lacks navigation path)
- Fix sticky_header failure (header doesn't stay visible while scrolling)
- Missing tooltips for key abbreviations (WO, QB, Conf, n) and terms (Easy WOs/Hard WOs) used without explanation.
- Reference to 'tools-systems/dropbox.md' appears as code block instead of clickable link
- Missing back navigation link for deep page (click depth 2)
- Add tooltips for abbreviations (WIP, COGS, EOD, WO, IHA) used in meta text and blurb descriptions
Redesign Queue (23 items)
- Tab labels lack explanatory text (e.g., 'Assembly History' needs brief description), forcing users to click to understand purpose. Help badges are present but insufficient without on-page context.
- No breadcrumbs/back navigation for deep page (click depth 3); implement navigation trail.
- Redesign table layout to reduce width (e.g., group properties, use vertical scrolling) to eliminate horizontal scrolling.
- Replace static table with interactive table featuring sort/filter by hold period, profit, and date ranges.
- Redesign diagram to include step descriptions (e.g., hover tooltips or sidebar) instead of dense visual-only flow.
- Redesign VPT table to reduce column count and improve readability (current layout is dense with small font)
- Add breadcrumb/back navigation to address deep-page navigation issue (current page lacks path to parent).
- Redesign table layout to reduce horizontal scrolling (13 properties wide) - requires structural rethink
- Table displays 14 properties in a single row, requiring horizontal scrolling and making data hard to parse.
- Table is too wide for 7 properties; redesign to avoid horizontal scrolling (e.g., vertical property stacking or responsive columns).
- Add due date column to table to address PM's 'due next week' need (current page lacks this critical data)
- Standardize property names in dropdown (e.g., replace '2087 Dogwood, 120 Beverly' with consistent property IDs).
- No back path or breadcrumbs for deep page (click depth 3), and 'Work Orders' in eyebrow isn't a link
- Consolidate redundant 'Status' and 'Order Status' columns to eliminate confusion (column headers suggest duplicate data).
- Labor rate table has 53 rows without filtering/search, making it difficult to find specific contractors (e.g., 'Pedro' appears 4 times).
- Redesign table layout to eliminate horizontal scrolling (14 columns require >1920px width).
- Redesign table to reduce horizontal width (7 properties × 2 columns = 14 columns)
- Add back link to Stream 04 overview and links to related pages (e.g., VPT entry, Stream 01)
- Deliverables table (21 items) is overly dense and hard to scan; requires restructuring for admin usability.
- Add breadcrumb/back link for deep page (current click_depth 3 lacks navigation path)
- Guide covers only Properties hub despite portal having multiple hubs; requires structural rewrite to include all hubs (Construction, Finance, etc.)
- Replace fixed date in title/path (2026-06-14) with dynamic current date to avoid confusion about historical vs. current data.
- Restructure compliance column to separate COI expiration into dedicated column with clear status (e.g., 'COI: expired 2025-01-11') instead of cluttered badges.
Cull Candidates (4 items)
Page exists solely as an iframe container for existing pages, providing no unique value or context. Admins can access all content directly via other pages without this hub.
Page serves as hub but contains no actionable data (stale iframes) and fails core purpose - should be replaced with property-focused view
Remove 'Sink' row with 'not needed' status (redundant content)
Code blocks lack syntax highlighting - causes readability issues for technical steps
Forward Roadmap
New Page Candidates
- A guide on how to use the Chart of Accounts for transaction entry (with examples)
- Actualsboard Report Preview: Live example of the report output with sample data for visual reference.
- Actualsboard source legend sidebar (with live examples) for quick reference during report use
- Admin Workflow Checklist: Interactive page to track status of each flow step with owner/PM assignments
- Admin dashboard for tracking labor hour submission status (pending/audited/ready for VPT)
- Approval Checklist: Step-by-step task list per gate with completion tracking.
- Assembly Estimate Dashboard showing active vs. historical assemblies with edit capabilities
- Budget vs Actuals trend dashboard showing monthly spend comparisons
- Central Forms Library page listing all forms with purpose, timing, and direct links
- Cost Code Detail Page: Interactive list showing all 228 codes with segment mapping, work orders, and descriptions
- Cost Code Details Page: Shows full description, cost history, and related work orders per code
- Cost Code Lookup Tool: Interactive interface to search cost codes and see segment/work order mappings
- Cost Code Lookup: Searchable page to find segment mappings for specific cost codes (reduces grid scanning)
- Cost Code Reference Guide: Master list of active codes with descriptions and usage examples
- Cost Code Reference Hub: Interactive map of all cost codes to work order packets
- Cost Code Reference Hub: Interactive table of all 228 cost codes with filters, descriptions, and related work orders.
- Cost Library Explorer: Filterable interface showing raw QB data behind rate cards with reconciliation flags.
- Current RFW dashboard (no date in URL) as primary entry point for PMs.
- Deal Comparison Dashboard: Interactive tool to filter/sort deals by margin, hold period, or cost/sqft.
- Dedicated 'VPT Commitments' page with filtering/sorting for detailed view
- Dedicated glossary page for all internal terms (IHA, WO, PM, VG, etc.)
- Dedicated glossary page linking from reference hub (with all abbreviations explained)
- Document Naming Checklist: Interactive tool to validate filenames against rules
- Drill-down page for individual properties showing non-construction costs over time with trend visualization.
- Dynamic Variable Lookup: Searchable database showing all variables, plan types, and work orders they feed
- EOD Report Dashboard: Aggregated view of all EOD reports with status indicators
- Estimating Variables Dashboard: Interactive table showing all variables with filters by timing event/owner
- Filing validation checklist for admins to verify document compliance before uploading
- Financial Dashboard: Aggregated view of spend vs. budget across all properties with trend charts.
- Financial Glossary page with tooltips for all terms used across reports
- Gap Tracker dashboard showing all 16 gaps with owners/statuses
- Glossary search page with filterable terms
- IHA Plan Tracker Dashboard: Visual summary of all 19 plans with status, owner, and link to templates
- Intake Pipeline Dashboard showing real-time item counts per stage with filters.
- Intake Variable Status Dashboard showing reconciliation gaps and pending updates
- Interactive actualsboard demo showing source mark tooltips with live variance examples.
- Interactive intake form with auto-calculated holding costs based on field inputs
- Internal Terminology Glossary page linking to all guide pages with explained terms.
- Interview Guide Index: Master list of all guides with dates/rounds/statuses
- Labor Rate Management Dashboard (for PMs to update rates, with version history and approval workflow).
- Materials Dashboard: Single page showing order status, property selection deadlines, and assembly progress with actionable filters.
- Materials Usage Report showing material distribution across properties for inventory planning.
- PM Chat Ingestion Status page showing real-time processing queue
- PM Stamp Box Verification Checklist (interactive checklist for PMs to mark off delivered items).
- PM dashboard showing all properties with pending work orders (prioritized by completion %)
- Page showing list of reviewed pages with direct links to their reports
- Per-property comparison page allowing side-by-side selection of two properties for focused analysis.
- Per-property spend drill-down page with segment-level filters.
- Per-segment detail page showing trend analysis across properties
- Performance Dashboard: Summary view with ROI charts, average hold period, and filterable date ranges.
- Permitting Status Dashboard: Real-time view of active permit submissions with owner/PM/contractor status.
- Phase Definitions Reference page explaining P1/P2/P3 in context
- Phase Performance Drill-Down: Per-property view with exportable data
- Portal Glossary page linking all abbreviations to full terms with context
- Portal-wide glossary page for all internal abbreviations
- Portfolio Construction Summary: High-level view of total spend vs. estimate across all properties with drill-down
- Portfolio Dashboard: Main hub page with summary metrics + direct link to status board
- Portfolio Glance: High-level summary of activity metrics (e.g., '12 active properties, 47 activities this week') linking to detailed log.
- Portfolio Performance Trends page showing monthly metrics (e.g., gross spread trends, hold time analysis)
- Project timeline detail view showing individual property arcs (current 'Individual Property Arcs' note).
- Properties list with timeline filter (show active properties only) instead of historical view.
- Property Actuals Dashboard: Single-page view showing actuals vs. budget for selected property with drill-down to reports
- Property Data Status Dashboard - shows real-time data completeness per property
- Property Delay Dashboard showing all properties with timeline deviations and PM contact options.
- Property Dropbox File Type Guide (categorizing documents by type instead of folder)
- Property Material Status Dashboard (aggregated view across all properties)
- Property Pipeline Dashboard with filters for status, location, and time metrics
- Property Spend Detail page with drill-down capabilities for owner spend analysis
- Property detail page with embedded timeline view (to complement portfolio timeline).
- Property-level phase comparison tab within property detail view (reduces click depth).
- Property-specific scope library showing all assemblies used at a property with direct links
- QuickBooks Auth Troubleshooting Guide covering common token errors and browser redirects.
- RFW Analytics Dashboard showing trend data across properties (vs. static roster)
- RFW Dashboard: Single page with date picker, status filters, and cost analytics
- RFW Detail Page with full history, approval trails, and linked documents
- RFW Detail Page: Consolidated view with full notes, document history, and status workflow
- RFW Detail Page: Single RFW view with full notes, document history, and approval workflow.
- RFW Details Page with integrated contractor communication history
- RFW Details Page: Clicking any RFW row opens a dedicated page with full history, approval workflow, and document attachments.
- RFW Due Soon dashboard showing next 7 days' active RFWs with priority indicators
- RFW Process Guide - standalone page explaining workflow, triggers, and approval steps
- RFW Terms Glossary page for onboarding PMs
- RFW management dashboard with create/edit forms (replacing command-line tool)
- Rate Card Management dashboard for admins to update contractor statuses, add new entries, and populate detailed pages.
- Role-specific navigation guides (e.g., 'PM Construction Dashboard Guide', 'Admin Vendor Payments Guide')
- Scope Library preview page showing live assembly examples with price ranges
- Searchable cost code lookup page showing segment, representative code, and full code list
- Spend trend dashboard showing historical comparisons across properties.
- Status Definitions Reference Page (explaining all payment statuses/abbreviations)
- Stream 02 Troubleshooting Guide: Common 'No-Match' scenarios with resolution steps
- Stream Comparison Matrix: Side-by-side view of all streams with triggers/owners
- Stream-specific workflow pages (e.g., 'Money Out Triggers Pipeline') for deeper admin analysis.
- Team-specific flow summaries (e.g., 'Admin-Only Workflow' for accounting handoffs)
- Technical Glossary Page - centralized reference for all portal abbreviations
- Text-based workflow summary page for admins who prefer reference over diagrams
- VG: Admin Junkie - dedicated page explaining the concept referenced in definitions
- Variable Usage Heatmap: Visualize which variables are most frequently used across plans.
- Vendor Compliance Dashboard: Visual summary of compliance health with charts and bulk action buttons.
- Vendor Payment Detail Page with payment history timeline and document audit trail
- Vendor Payment Detail Page — shows full payment history with work order cross-reference (would replace current board links).
- Vendor Payment History Dashboard showing past 6 months' payment trends
- Vendor Payment Order Cross-Reference Page showing linked payments/orders with one-click navigation.
- Vendor Payment Tracker (VPT) Usage Guide with screen captures
- Vendor Plan Extraction Checklist: Interactive form to validate variables against actual vendor plans
- Vendor Reconciliation Process (for Credit/Volume Vendors exception path)
- Vendor contact hub page linking to vendor details, communication tools, and payment history.
- WO Category Quick Reference: Summary table with WO codes, key variables, and companion file links
- Work Order Dashboard: Prioritized view showing open WOs with due dates, status, and next steps
- Work Order Detail View: Single-page deep dive with approval workflow and document history
- Work Order Summary Dashboard showing open WOs, due dates, and PM roster links in single view
- Workflow Status Dashboard: Aggregates all stream statuses with gap resolution tracking.
- Workflow directory page with searchable cards showing workflow name, purpose, and direct link (replacing iframe hub)
- Workflow version history page showing change logs for all flow diagrams.
Alternative Presentation Options
Report Dashboard — reports/portal-review/index.htmlDashboard with key metrics and interactive table instead of static report
vs. current: More actionable with data but requires more development; tradeoff is better user experience when content exists
Materials Dashboard — materials/index.htmlSingle-page view showing real-time materials status with filters and key metrics instead of tab navigation.
vs. current: Better than current hub because it eliminates unnecessary navigation to separate pages and provides immediate value. Tradeoff: Requires data aggregation effort but removes redundant page.
Properties Dashboard — properties/index.htmlSingle-page view with key metrics, direct links, and no iframes
vs. current: More efficient than tabbed iframes but requires full redesign; trades simplicity for immediate usability
Property Detail Phase Comparison — properties/phase-comparison.htmlEmbed comparison within property detail page as a tab.
vs. current: Better context for users but increases property page complexity; tradeoff: reduced navigation depth vs. potential clutter.
Split Guide + Template — work-orders/rfw-request-for-work.htmlSeparate 'RFW Guide' page with instructions and 'RFW Template' page for form filling
vs. current: Better for usability (guide is reference, template is clean), but requires two pages instead of one
PM Process Insights (with data) — guides/pm-process-insights.htmlPopulated version showing actual workflow patterns
vs. current: Would be better when data exists, but current empty state is worse than no page (since it creates false expectation)
Phase Performance Dashboard — properties/phase-performance.htmlInteractive chart-based view showing phase variance trends across properties
vs. current: Better for quick pattern recognition but requires more development effort than current table
Interactive Workflow Explorer — workflow/2026-05-08_four-stream-intake-overview.htmlDraggable diagram with hover tooltips showing stream details and stage metrics.
vs. current: Superior for discovery but requires development effort; tradeoff is complexity vs. static diagram's simplicity.
Workflow Directory — workflow/index.htmlList of workflow cards with icons, short descriptions, and direct links instead of tabbed iframes
vs. current: Better for accessibility and content discovery (no iframe loading issues), but requires reworking all workflow content
Portfolio Activity Calendar — properties/activity-log.htmlCalendar view showing activity density per day across properties with color-coded events.
vs. current: Better for spotting trends but less suitable for detailed activity review. Tradeoff: visual scanning vs. data precision.
Properties Timeline Table — properties/timeline.htmlTable view with columns for property address, purchase date, renovation start, sale date, and duration.
vs. current: Better for detailed data lookup but less visual for duration; tradeoff: more data at a glance vs. visual summary.
Non-Construction Cost Summary — reports/actualsboard/actualsboard-non-construction-2026-06-22.htmlSummary view with key metrics (total actuals, variance) per segment, with link to detailed table.
vs. current: Better for quick overviews; tradeoff is loss of detailed per-property data.
Property Actuals Dashboard — reports/actualsboard/index.htmlSingle-page view showing actuals vs. budget for one property with summary metrics and direct report links
vs. current: Better for owner's primary goal (specific property spend) but requires property selection step. Tradeoff: reduces click depth from 3 to 1 but removes multi-property hub capability.
Performance Dashboard — financial-reports/comp-performance.htmlInteractive summary with charts and filters instead of raw table.
vs. current: Better for decision-making but requires more development; current table is simpler but less actionable.
Material Selection Summary — materials/selections/106-cleveland.htmlSingle-page overview with status heatmaps instead of tabbed tables
vs. current: Better for quick status checks but loses granular detail; tradeoff: less efficient for deep dives into specific materials
Work Order Summary Dashboard — work-orders/index.htmlSingle-page view with key metrics (open WOs, due dates) and direct links to PM roster
vs. current: Better than current hub for quick decision-making (reduces tab switching), but requires data aggregation instead of iframe delegation
Ops Logs Workflow Table — workflow/2026-05-05_stream-04-flow.htmlTable view showing each step, responsible party, status, and action required.
vs. current: Better for Admins needing to understand specific steps (vs. visual flow), but loses spatial relationship of parallel processes.
Intake Operations Flowchart — guides/2026-05-18_intake-playbook.htmlVisual diagram of pipeline stages with color-coded streams
vs. current: Better for quick understanding but less detailed for reference; tradeoff is reduced text detail for visual clarity
2087 Dogwood — Work Order Summary — properties/2087-dogwood-recap.htmlSimplified view showing only completion percentage and top 3 pending items
vs. current: Faster for quick status checks but loses detailed work order context; better for mobile view
Cash Flow Dashboard — properties/cash-flow.htmlVisual summary with charts and key metrics instead of table
vs. current: Better for quick overview but requires more development; tradeoff is less detail than table view
Portfolio Dashboard — properties/property-status-board.htmlSingle-page hub replacing current main page with status board as core component
vs. current: Better for owner as primary landing page (reduces clicks), but requires more development than current fix. Tradeoff: More comprehensive but less focused on pure status view.
Vendor Activity Dashboard — properties/vendor-timeline.htmlInteractive chart-based view showing vendor spend trends across properties with drill-down.
vs. current: Better for strategic decisions but requires development; current table is simpler but less actionable.
Construction Actuals (Mobile-Optimized) — reports/actualsboard/actualsboard-construction-2026-06-22.htmlStack properties vertically on mobile, horizontal scroll on desktop with sticky headers
vs. current: Better for mobile users but requires more vertical scrolling on desktop; tradeoff is reduced horizontal scrolling at cost of vertical space
Property Comparison Dashboard — reports/actualsboard/actualsboard-cross-property.htmlInteractive dashboard with property selector and responsive table that adapts to screen size.
vs. current: Better for mobile use and focused comparisons, but requires more development than sticky header fix.
Spend Board (Vertical Properties) — reports/actualsboard/spend-board-2026-06-11.htmlProperties listed vertically with segments as columns; eliminates horizontal scrolling.
vs. current: Better for mobile but requires more vertical scrolling on desktop; tradeoff is improved accessibility over wide table.
Work Order Dashboard — work-orders/pm-wo-roster.htmlPrioritized view showing open WOs with due dates, status, and next steps
vs. current: Better for PM's core need (due next week) but requires new data structure; tradeoff: less reference detail than current roster
Stream 02 — Flow Summary (Text) — workflow/2026-05-05_stream-02-flow.htmlText-based version with numbered steps instead of diagram
vs. current: Better for screen readers but loses visual flow context; use as fallback if diagram fails accessibility checks
Materials Library (Simplified) — estimating/materials-library.htmlReplace 'Used At' with 'Properties' column showing comma-separated property list.
vs. current: Better for quick reference but less clear for filtering; tradeoff is simplicity vs. data clarity.
Multi-Property Filter — estimating/materials-library.htmlReplace single-select property dropdown with multi-select for filtering multiple properties.
vs. current: More flexible for Admins but increases complexity; tradeoff is power vs. usability.
Property Summary Card — properties/journey-109-pleasant.htmlSingle-property overview with phase progress as percentage (not bar chart) and key metrics.
vs. current: Better for Owner (primary) who needs quick status without visual complexity, but loses detailed timeline context for PM (secondary).
Phase Timeline Explorer — properties/journey-109-pleasant.htmlInteractive timeline with hoverable phase details and delay explanations.
vs. current: Superior for PM (secondary) to analyze progress, but over-engineered for Owner (primary) who only needs status.
Portfolio Capacity Dashboard — properties/portfolio-capacity.htmlConsolidated view with weekly bar chart, heatmap, and active project list in one dashboard.
vs. current: Better for quick scanning but requires more screen real estate; current single-page is simpler but less contextual.
Portfolio Summary with Filters — properties/portfolio-glance.htmlDynamic summary with active/completed/historical filters and sortable columns
vs. current: Better for drill-down needs but adds complexity; current static view is sufficient for owner's high-level review
Segment Benchmarks Table — properties/segment-benchmarks.htmlTable layout showing segment, avg duration, avg cost, and variance
vs. current: Better for precise data comparison than grid, but less visually scannable for initial overview
Cost Code Lookup with Segments View — reference/segments.htmlMerge segments reference into cost code lookup tool with toggle for segment view
vs. current: Better for users who primarily search cost codes, but would require redesigning the lookup tool (tradeoff: less dedicated reference page)
RFW Dashboard — work-orders/rfws/2026-06-12_rfw-roster.htmlSingle page with date filter, status toggles, and cost visualization instead of fixed-date page
vs. current: Replaces 19+ date-specific pages with one dynamic view; tradeoff is losing historical snapshot context but gaining usability
RFW Dashboard — work-orders/rfws/2026-06-15_rfw-roster.htmlSummary view with financial charts, active RFW heatmaps, and property filters instead of table.
vs. current: Better for quick insights but less efficient for detailed RFW scanning. Tradeoff: reduces table density but requires more clicks to access specific RFWs.
RFW Timeline View — work-orders/rfws/rfw-roster.htmlHorizontal timeline showing RFWs by approval date with due date markers
vs. current: Better for tracking deadlines but less efficient for bulk status checks; tradeoff: more visual but less data-dense than current table
Stream 03 — Records Flow (Text Summary) — workflow/2026-05-05_stream-03-flow.htmlStep-by-step textual description of workflow with clear action items
vs. current: Better for quick reference and accessibility, but loses visual flow context. Tradeoff: more text vs. immediate visual understanding.
Admin Workflow Text Summary — workflow/2026-06-23_admin-design-flow.htmlConcise step-by-step text version with responsible parties and deadlines
vs. current: Better for quick reference without visual complexity, but less intuitive for understanding process flow than diagram
Interactive flow explorer — workflow/2026-06-23_full-business-flow.htmlClickable phases showing team responsibilities and documents
vs. current: Better for discovery but over-engineered for reference-only use; tradeoff is complexity vs. usability
Order Status Dashboard — materials/order-tracking.htmlSummary cards (e.g., 'Pending: 5', 'Delivered: 12') above table with drill-down capability.
vs. current: Better for quick status overview but less suitable for detailed row inspection; current table view better for admin's granular needs.
Hector Crew Rate Card (Summary) — reference/2026-06-08_rate-cards.htmlRename page to reflect specific crew focus instead of generic 'Rate Cards' title.
vs. current: Better accuracy (avoids misleading 'Rate Cards' title) but requires updating all internal links; tradeoff is minor naming change vs. persistent confusion.
Mobile-Optimized Spend Summary — reports/actualsboard/spend-board-2026-06-09.htmlSingle-column view showing properties vertically with segment breakdowns as expandable sections.
vs. current: Better for mobile users but requires significant layout rework; tradeoff is reduced desktop screen real estate for more focused data.
Spend Dashboard — reports/actualsboard/spend-board-2026-06-10.htmlInteractive table with property filters and trend charts
vs. current: Better for strategic decisions but requires more development; tradeoff is time vs. usability for quick checks
RFW Dashboard — work-orders/rfws/2026-06-22_rfw-roster.htmlSummary view with financial charts and status heatmaps instead of table
vs. current: Better for owner audience (high-level), but less useful for PMs needing granular RFW details; tradeoff: loses table's actionable data for construction management
Pipeline Stage Reference Table — workflow/2026-05-05_pipeline-overview.htmlText-based table listing all six stages with columns for stage number, name, owner, actions, and examples.
vs. current: Better for quick scanning but less intuitive than visual flow; tradeoff is reduced cognitive load for text-focused users vs. visual sequence understanding.
Interactive Workflow Explorer — workflow/light-versions/2026-05-15_data-storage-map.htmlClickable flowchart with status indicators and direct links to related channels
vs. current: Better for active task management but requires development effort; current reference format is sufficient for static documentation
Interactive Flow Explorer — workflow/light-versions/2026-05-15_property-capture-flow.htmlClickable diagram with step details on hover and stream filtering.
vs. current: Superior for exploration but requires dev work; current static version suffices for reference.
Forms Library — forms/2026-05-27_estimating_form-00-pre-contract.htmlSingle hub page listing all forms with purpose, timing, and direct links
vs. current: Better for discoverability than individual form pages, but requires new page creation; tradeoff is reduced context for specific form details
Permitting Process Flowchart — guides/2026-06-01_design-permitting.htmlVisual flowchart replacing text-based workflow with decision points and handoff triggers.
vs. current: Better for quick process understanding but less detailed for reference; tradeoff: reduced text density vs. loss of granular deliverables data.
Portfolio Summary View — properties/properties-main.htmlSingle-page overview with key metrics (active properties, sqft, sales) and drill-down to detailed reports
vs. current: Simpler than current grid but less detailed; better for quick executive overviews
QuickBooks Chart of Accounts (Direct Link) — reference/2026-05-13_chart-of-accounts.htmlLink directly to the QuickBooks chart of accounts, which is the source of truth.
vs. current: Better for real-time data, but less user-friendly for internal reference. Tradeoff: accuracy vs. usability.
Interactive Chart of Accounts with Balances — reference/2026-05-13_chart-of-accounts.htmlA version that shows balances (with a note that they are not current) and allows filtering by balance range.
vs. current: More useful for financial analysis, but not needed for reference. Tradeoff: more data vs. reference simplicity.
Table View — reference/2026-06-09_cost-code-map.htmlTabular format with Segment, Name, Representative Code, and Cost Code Count columns
vs. current: Better for sorting/searching but less visually scannable than grid for segment numbers; grid is preferable for reference context
Portfolio Summary Dashboard — reports/actualsboard/actualsboard-insights.htmlInteractive chart-based view with drill-down to deal economics table.
vs. current: Better for exploration but requires more development; current page is a static summary for quick scanning.
Integrated VPT Board — work-orders/vpt/index.htmlMerge AP Pipeline and Construction views into single interactive board with order tracking links.
vs. current: Better user flow but requires rework of board templates; current hub is simpler to fix.
Filtered Assembly History — estimating/assembly-history.htmlAdd date/property filters to quickly locate entries instead of full table
vs. current: Better for frequent users needing specific entries, but current full-history view is sufficient for reference use case
Scope Library with Property Filter — estimating/scope-library.htmlFilterable scope library showing assemblies by property (e.g., 'Show all at 63 Montclair')
vs. current: Better for property-focused work but less efficient for general estimating; current page better for quick reference
Scope Library with Expanded Details — estimating/scope-library.htmlClick-to-expand detailed scope views with related page links
vs. current: Better for deep dives but reduces scanning efficiency; current page optimizes for bulk reference
Interactive Variable Explorer — forms/2026-05-29_vendor-plan-template-variables.htmlExpandable sections showing variable dependencies with live examples from actual vendor plans
vs. current: Better for PMs needing to troubleshoot extraction issues, but over-engineered for Admin reference needs
Modular Workflow Guide — guides/2026-06-04_wa-ingest-guide.htmlBreak into three micro-pages: Exporting, Running, and Troubleshooting
vs. current: Better for scanning but requires more navigation; current single-page is acceptable for this short workflow
Portal Hub Directory — guides/portal-guide.htmlSingle-page hub index with brief descriptions and direct links to each hub's dedicated guide
vs. current: More efficient than current fragmented approach; tradeoff is slightly longer initial page but eliminates navigation confusion
Labor Rates with Search — reference/labor-rates.htmlAdd search input to filter bar for direct contractor name lookup.
vs. current: Better for users knowing specific contractor names, but current filter/sort suffices for most reference use cases. Tradeoff: adds one input field but reduces need for multiple filters.
Actualsboard Report Preview — reports/actualsboard/2026-06-08_actualsboard-guide.htmlLive example of the report output with sample data, showing structure without instructions.
vs. current: Better for visual learners but doesn't explain how to run the report; would complement the guide rather than replace it.
Budget Source Legend (Quick Reference) — reports/actualsboard/2026-06-08_budget-source-guide.htmlMinimal page showing only table of source types with visual examples and confidence levels
vs. current: Better for quick lookup during report use, but lacks context of why sources matter (current page's strength)
Spend Summary Dashboard — reports/actualsboard/spend-board-2026-06-15.htmlInteractive view with filters, trend charts, and drill-down to property details.
vs. current: Better for strategic decisions but requires more development; tradeoff is reduced immediate data access vs. current table.
Design Team Stamp Box Checklist — work-orders/2026-05-11_design-team-stamp-guide.htmlChecklist format for PMs to verify each drawing against required fields.
vs. current: Better for PM action (quick verification), but less useful for design teams needing guidance. Current guide better serves dual purpose (design team instruction + PM reference).
Work Order Variables Reference — work-orders/2026-05-11_plans-cheat-sheet.htmlSingle-page table view with columns: Variable, Description, Plan Type, Work Orders
vs. current: Better for quick scanning but requires more development; current card layout is simpler for reference
RFW Timeline View — work-orders/rfws/2026-06-11_rfw-roster.htmlChronological view of RFWs with date-based filtering instead of property-based
vs. current: Better for tracking work order progression over time but less efficient for property-specific management (tradeoff: reduced context switching vs. slower filtering)
Current RFW Registry — work-orders/rfws/2026-06-14_rfw-roster.htmlDynamic page showing today's RFWs without date in title/path.
vs. current: Better for daily use (always current), trades historical access for simplicity. Historical data would require separate archive page.
RFW Dashboard — work-orders/rfws/2026-06-23_rfw-roster.htmlVisual summary with pie charts (active/closed), financial trend graphs, and property heatmaps
vs. current: Better for quick executive review but less useful for PMs needing granular RFW details; tradeoff is reduced table functionality
Payment Status Dashboard — work-orders/vpt/2026-06-12_vpt-board.htmlSimplified view showing only payment status percentages and top 5 overdue items
vs. current: Better for quick executive reviews but sacrifices detailed property-level data; tradeoff is reduced context for PMs
Interactive Workflow Explorer — workflow/2026-06-23_admin-accounting-flow.htmlClickable stages showing real-time system links and contact info
vs. current: Better for active use but requires dev work; current static diagram suffices for reference but lacks interactivity
Financial Reports Dashboard — financial-reports/index.htmlSingle-page view with filterable report types (Boards, Monthly, Yearly) and sortable date columns
vs. current: Better for large report volumes but over-engineered for current 15-report scope; current structure is simpler for owner's needs
Invoice Process Flowchart — guides/2026-05-06_invoice-journey.htmlVisual flowchart showing step dependencies with system icons
vs. current: Better for quick reference but less detailed for step-by-step execution. Tradeoff: reduces text density but loses input/output specificity.
Reconciliation Process (with Embedded Glossary) — guides/2026-05-18_reconciliation-process.htmlGuide page with inline term explanations in parentheses (e.g., 'QB (QuickBooks)') instead of tooltips.
vs. current: Better for quick reference but less clean; use if Admins prefer minimal popups over text clutter.
Property Intake Checklist (Interactive Form) — guides/2026-05-29_property-intake-checklist.htmlDynamic form that auto-calculates holding costs/budget as fields are filled, with validation
vs. current: Better for active data entry but requires development effort; current static version is sufficient for reference use
Interactive Data Flow Simulator — guides/2026-06-03_assembly-estimating-guide.htmlDrag-and-drop visualization of quote ingestion → approval → budget generation
vs. current: Better for new Admins but requires development effort; current text version is sufficient for reference
Portfolio Dashboard — properties/construction-timeline.htmlIntegrated view with timeline + key metrics (e.g., budget vs. actual) in single dashboard.
vs. current: Better for holistic decision-making but overcomplicates timeline focus; tradeoff: less efficient for pure timeline analysis.
Glossary with search — reference/2026-05-13_glossary.htmlSingle-page glossary with search bar and filterable terms
vs. current: Better for large glossaries (100+ terms) but over-engineered for current size; tradeoff is added complexity vs. immediate usability
Process Flowchart — reference/approval-chain.htmlVisual diagram showing all steps with arrows instead of numbered list
vs. current: Better for visual learners but less scannable for specific actions; tradeoff: more space needed
Role-Based Summary Table — reference/approval-chain.htmlTable with columns: Role, Action, System, VPT Status
vs. current: More compact but loses sequential flow; tradeoff: harder to follow step progression
EOD Conventions Interactive Guide — reference/eod-conventions.htmlInteractive table with hover explanations for abbreviations and time zone converters
vs. current: Better for new admins but requires development time; current table is sufficient for experienced admins
Filing Guide (Combined) — reference/filing-name-card.htmlSingle page with 'Quick Reference' tab and 'Full Guide' tab
vs. current: Better for new users but less efficient for quick lookup; requires more screen space
Filing Terms (Enhanced Quick Reference) — reference/filing-name-card.htmlCurrent page with added tooltips and back link
vs. current: Minimal changes with maximum impact; preserves current efficient structure
Single-Table Reference — reference/iha-plan-variables.htmlConsolidated table showing all variables across all plans with plan columns.
vs. current: Better for cross-plan variable comparison but worse for plan-specific focus; increases page length significantly.
Estimating Variables Dashboard — work-orders/2026-05-11_non-plans-cheat-sheet.htmlDynamic table with search/filter by timing event, owner, and variable type
vs. current: Better for active construction use but requires dev work; tradeoff: more useful than static sheet but less immediately available
RFW Dashboard — work-orders/rfws/2026-06-09_rfw-roster.htmlSummary view with financial charts and minimal table (RFW#, Status, Estimate)
vs. current: Better for quick decisions but less detailed than current table; tradeoff is reduced context for PMs managing multiple RFWs
RFW Terms Glossary — work-orders/rfws/2026-06-13_rfw-roster.htmlStandalone reference page explaining all RFW-related terms and abbreviations
vs. current: Better for new PMs but not a replacement for roster; adds clarity without disrupting current workflow
Interactive Approval Flow — workflow/2026-05-06_who-approves-what.htmlDrag-and-drop flowchart showing gate dependencies with role-specific tooltips.
vs. current: Better for training but over-engineered for reference; tradeoff is development effort vs. static clarity.
Interactive Flow Explorer — workflow/light-versions/2026-05-15_stream-01-flow.htmlClickable steps showing real-time role assignments and tool links
vs. current: Better for task execution but over-engineered for this static reference; current diagram suffices for understanding
Admin Checklist View — workflow/light-versions/2026-05-15_stream-01-flow.htmlChecklist format with pre-filled roles and SLA deadlines
vs. current: More actionable but loses visual flow context; current diagram better for process comprehension
Interactive Variable Calculator — forms/2026-05-13_estimating-variables-by-wo.htmlDynamic tool where admins input property data to auto-generate cost formulas
vs. current: Better for PMs applying formulas but unnecessary for admin reference; current page suffices for reference needs
IHA Plan Template Summary — forms/2026-05-29_iha-plan-template-variables.htmlHigh-level table listing all 19 plans with tracker numbers, owners, and direct links to detailed sections
vs. current: Better for quick reference (replaces scrolling through 19 sections), but loses detailed variable tables. Tradeoff: faster access vs. comprehensive detail.
Interactive Filing Assistant — guides/2026-05-18_property-dropbox-quick-reference.htmlDynamic tool where users select document type to auto-generate correct folder path and filename
vs. current: Better for new admins but requires development; current page is sufficient for experienced admins
QuickBooks Integration Walkthrough — guides/2026-05-27_cost-code-system-explainer.htmlStep-by-step guide showing how cost codes map to QuickBooks entries with screenshots.
vs. current: Better for new Admins learning the system but less useful for reference; current page is more efficient for established users.
Phase-Based Data Checklist — guides/2026-05-29_property-data-lifecycle.htmlSimplified checklist view per phase instead of timeline
vs. current: Better for quick verification but loses flow context; tradeoff: less visual storytelling for complex lifecycle
Cost Code System Cheat Sheet — guides/2026-06-08_cost-code-system.htmlCondensed reference table of common cost codes with segment mappings for quick daily use
vs. current: Better for speed during work, but sacrifices depth of current reference; tradeoff is reduced detail for faster access
Vendor Compliance Dashboard — reference/2026-06-08_vendor-contractor-registry.htmlSummary view with charts showing compliance status distribution and expiration trends.
vs. current: Better for executive oversight but less useful for detailed lookup. Tradeoff: sacrifices granular data for strategic insights.
Actualsboard Quick Reference — reports/actualsboard/2026-05-18_actualsboard-guide.htmlCondensed version with only essential commands and key sections (no detailed explanations).
vs. current: Better for experienced users needing rapid execution; tradeoff is reduced guidance for new users.
RFW Dashboard — work-orders/rfws/2026-06-10_rfw-roster.htmlConsolidated view with visualizations (e.g., active RFWs by property, cost trends) instead of table.
vs. current: Better for strategic decisions but less useful for day-to-day PM task management; tradeoff is reduced detail for overview.
Vendor Payment Dashboard — work-orders/vpt/2026-06-11_vpt-board.htmlConsolidated view with drill-down to properties instead of table
vs. current: Better for high-level oversight but loses granular vendor details; tradeoff is reduced detail for faster scanning
Tabbed Interview Guide — workflow/2026-05-07_interview-guide.htmlSeparate tabs for each respondent (Owner, PM, Admin) instead of scrolling
vs. current: Better for quick reference during interviews; tradeoff is reduced context for cross-referencing questions
Forms Directory — forms/index.htmlSimple list view with form names, dates, and brief descriptions
vs. current: Simpler but loses visual hierarchy and relationship context shown in current card grouping
Segment Table View — guides/2026-05-28_cost-code-map.htmlReplace grid with sortable table showing segment number, name, cost code count, and representative code
vs. current: Better for quick scanning of specific segments but less visually engaging than grid; tradeoff is reduced visual density for more structured data
Cost Code Change Workflow — guides/2026-06-01_cost-code-change-sop.htmlVisual flowchart showing decision points for change types and system updates
vs. current: Better for quick reference but less detailed than current SOP; would complement rather than replace
Guides Search Interface — guides/index.htmlSearchable index with filters for category, date, and keyword
vs. current: Better for >20 guides but currently over-engineered; tradeoff is adding complexity for minimal current need
Segment-Based Cost Code Explorer — reference/2026-05-28_cost-code-map.htmlInteractive table where admins select a segment to see all associated cost codes and work orders
vs. current: Better for targeted lookups but less efficient for overview than current grid. Tradeoff: more focused but requires more clicks.
Cost Code System Overview — reference/cost-code-lookup.htmlDetailed explanation of cost code structure including phase definitions
vs. current: Better for onboarding new admins but less efficient for quick lookup; current page is optimal for reference use case
Search-First Reference — reference/dictionary.htmlPrioritize search bar over alphabet navigation with instant filtering
vs. current: Better for users who know exact terms, but less efficient for browsing than current alphabet system
Contextual Term Explorer — reference/dictionary.htmlGroup terms by department (e.g., Accounting, Operations) instead of alphabet
vs. current: More useful for role-based navigation but loses alphabet scanning efficiency
Budget Source Quick Reference — reports/actualsboard/2026-05-18_budget-source-guide.htmlCondensed version with only table and key examples for quick lookup.
vs. current: Better for PMs needing fast reference; worse for new users needing context.
RFW Dashboard — work-orders/rfws/2026-05-27_rfw-roster.htmlDynamic view with filters, status indicators, and bulk actions across all properties
vs. current: Superior for ongoing management but over-engineered for this static snapshot use case
Property-Specific Payment View — work-orders/vpt/2026-06-09_vpt-board.htmlSingle-property focus with embedded pipeline summary instead of global view
vs. current: Better for deep dives into one property, but loses cross-property overview that's critical for PMs managing multiple sites
Compact Work Order Summary — work-orders/vpt/2026-06-15_vpt-board.htmlSingle-column view showing only critical items (vendor, amount, status, age) with expandable details
vs. current: Better for mobile, but sacrifices detailed context needed for PM decision-making
Intake Variable Registry (Interactive Table) — forms/2026-05-27_intake-variable-registry.htmlFilterable table with live status indicators for each variable
vs. current: Better for active debugging but requires development; current static version suffices for reference use case
Interactive Packet Directory — guides/2026-06-01_work-order-packets-master.htmlSearchable table with filters for phase, cost code, and name
vs. current: Better for discovery but requires development; current table suffices for reference use case
Interactive Rate Card Table — forms/rate-cards.htmlFilterable table with live confidence score visualization and 'data source' drilldowns.
vs. current: Better for dynamic searching but over-engineered for reference use; tradeoff is complexity vs. static clarity.
Filing Guide (Interactive) — guides/2026-05-13_filing-guide.htmlDynamic tool where admins input document type to auto-generate filename and filing path
vs. current: Better for speed but requires dev work; current static guide is sufficient for reference
Reference Hub with Visual Icons — reference/index.htmlReplace text kickers with intuitive icons (e.g., chart icon for Chart of Accounts)
vs. current: Better for visual scanning but requires icon design work; current text-based approach is more accessible for screen readers
Generated 2026-06-23 by portal_review pipeline · VG Home Buyers LLC