🎨 Theme PR: Visual Improvements for saga.asisaga.com

Source: saga.asisaga.com β€” frontend audit (2026-03-21)
Target: ASISaga/theme.asisaga.com
Priority: High β€” multiple critical frontend-skill failures identified


Context

A frontend-skill audit of saga.asisaga.com identified the following categories of visual failure:

The fix requires a combination of new ontological variants (this PR) and theme component enhancements (this PR). The subdomain will update its SCSS and HTML to use the new variants once merged.


πŸ”§ Component Enhancements (No New Variants)

Enhancement 1 β€” transcendent-hero.html: Add image parameter

File: _includes/transcendent-hero.html
Change: Add image and image_alt parameters. When provided, render the image as a full-bleed background with the text column floating over a dark tonal area of the image.

Proposed HTML change:




<section id="" 
  class="transcendent-hero   "
  >

  

  <!-- existing consciousness-background div remains for cases without image -->
  <div class="consciousness-background" >
    ...
  </div>
  ...

Proposed CSS in _sass/components/sacred/transcendent-hero.scss:

.transcendent-hero {
  // When image is provided via CSS custom property
  &:has(.transcendent-hero__image) {
    // Full bleed: no inherited gutters
    position: relative;
    overflow: hidden;
    
    .consciousness-background {
      opacity: 0.4; // Reduce gradient overlay when real image is present
    }
  }
  
  &__image {
    position: absolute;
    inset: 0;
    background-image: var(--hero-image);
    background-size: cover;
    background-position: center 30%; // Position toward top for faces/key subjects
    z-index: 0;
    
    // Dark overlay scrim for text contrast
    &::after {
      content: '';
      position: absolute;
      inset: 0;
      background: linear-gradient(
        to right,
        oklch(0.05 0.02 260 / 0.85) 0%,   // Strong dark left β€” text lives here
        oklch(0.05 0.02 260 / 0.50) 50%,
        oklch(0.05 0.02 260 / 0.25) 100%   // Image visible on right
      );
    }
  }
  
  // Text content must always sit above the image
  .transcendent-hero-content {
    position: relative;
    z-index: 1;
  }
}

Rationale: The hero currently has no visual anchor. With a real image, the brand name β€œASI Saga” becomes unmistakable against a rich photographic backdrop. The left-to-right gradient scrim keeps WCAG AA contrast while showing the image on the right side.


Enhancement 2 β€” post.html layout: Surface post image as hero

File: _layouts/post.html
Change: When page.image is set in front matter, pass it to transcendent-hero.html at the top of the post, creating a rich visual opening for each article.

Proposed HTML change:

---
layout: default
---




<genesis-environment logic="focused">
  <genesis-entity nature="primary">
    <article class="post-layout">
      
      

<header class="post__header">
  
  <genesis-cognition intent="axiom">
    <h1 class="post__title">🎨 Theme PR: Visual Improvements for saga.asisaga.com</h1>
  </genesis-cognition>
  
  
  
  
  
</header>

      
      ...

Rationale: Posts that declare image: in front matter deserve that image to anchor the reading experience. β€œThe Three Voices of AI” has a real banner β€” it should be the first thing a reader sees.


🧩 Ontological Propositions (New Variants)


Proposition 1 β€” genesis-cognition('heading')

🧩 Ontological Proposition

Source Node: saga.asisaga.com

Intent (The β€˜What’): A secondary heading scale for article titles within listings, section titles, and content headings β€” semantically distinct from the thesis-level axiom.

Context (The β€˜Why’):
The existing axiom variant uses clamp(2rem, 5vw, 3.5rem) β€” designed for a page’s singular central headline. When used for every blog post title in a list of 10, the result is 10 identical 32–56px screaming headlines with no hierarchy. There is no heading variant in the 6-item Cognition category that addresses secondary/tertiary heading scales. gloss is too small (annotations). discourse has no heading weight. axiom is too large and should remain reserved for the primary page heading.

Proposed Role:

Use Cases:

  1. saga.asisaga.com: Blog listing post titles β€” currently wrongly using axiom; need a scale that reads clearly as titles but doesn’t overpower the brand or each other in a list
  2. research.asisaga.com: Research paper titles in an archive listing β€” same pattern: multiple titles competing at hero scale
  3. docs.asisaga.com: Section headings in documentation β€” h2/h3 headings that structure long-form content
  4. community.asisaga.com: Thread titles in discussion boards β€” must be readable, scannable, not overwhelming

Universal Applicability:

Suggested Implementation:

/**
 * @category Cognition
 * @variant 'heading'
 * @origin PR from saga.asisaga.com (frontend-skill audit 2026-03)
 * @intent Secondary heading β€” article titles in listings, section h2/h3 headings
 * @since v5.0
 */
@else if $intent == 'heading' {
  // Secondary heading β€” article/section titles, below axiom, above discourse
  font-size: clamp(1.25rem, 2.5vw, 1.75rem);  // 20–28px
  font-weight: 700;
  letter-spacing: -0.02em;
  line-height: 1.25;
  color: oklch(0.10 0.01 250);  // Deep black, same as axiom
  font-family: var(--font-consciousness, -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif);
  
  @media (max-width: 767px) {
    font-size: 1.25rem;
    line-height: 1.3;
  }
  
  @media (min-width: 768px) and (max-width: 1023px) {
    font-size: 1.5rem;
  }
  
  @media (min-width: 1024px) {
    font-size: 1.75rem;
  }
}

Success Criteria:


Proposition 2 β€” genesis-entity('editorial')

🧩 Ontological Proposition

Source Node: saga.asisaga.com

Intent (The β€˜What’): An entity type for editorial content entries (blog posts, articles, research papers in a listing) that presents content WITHOUT card chrome β€” no border, no background surface β€” just structured content with internal spacing.

Context (The β€˜Why’):
The existing secondary entity creates a visible card (light-grey background, border, padding). In an editorial/blog context this creates the β€œGeneric SaaS card grid” failure. latent reduces opacity which is semantically wrong (the post is NOT inactive). primary is even heavier chrome. There is no card-less entity type in the current 6+10 variants β€” all entity variants apply a surface treatment (background, border, or shadow). An editorial listing item is a typographic entity, not a surface.

Proposed Role:

Use Cases:

  1. saga.asisaga.com: Blog post listing items β€” each post should be a clean typographic row with date, title, excerpt, and optional category tags. No card border.
  2. research.asisaga.com: Research paper listings β€” academic content should feel precise and surface-less
  3. docs.asisaga.com: Article index entries in documentation table of contents
  4. community.asisaga.com: Discussion thread entries in a feed

Universal Applicability:

Suggested Implementation:

/**
 * @category Entity
 * @variant 'editorial'
 * @origin PR from saga.asisaga.com (frontend-skill audit 2026-03)
 * @intent Card-less editorial content entry for blog/article listings
 * @since v5.0
 */
@else if $nature == 'editorial' {
  // Editorial entry: typographic presence without card chrome
  background: transparent;
  border: none;
  border-top: 1px solid oklch(0.90 0.005 220);  // Subtle divider only
  padding: var(--padding-entity-secondary, clamp(1rem, 2vw, 1.5rem)) 0;
  box-shadow: none;
  border-radius: 0;  // No rounded corners β€” this is a document row, not a card
  
  // Optional featured treatment for first/hero items in editorial feed
  &.editorial-featured {
    border-top: 2px solid oklch(0.65 0.15 85);  // Gold accent for first item
    padding-top: var(--padding-entity-aggregate, clamp(2rem, 4vw, 3rem));
  }
  
  // Hover: subtle text emphasis, no surface change
  &:hover {
    background: transparent;
    border-top-color: oklch(0.75 0.10 85);
  }
  
  @media (prefers-contrast: high) {
    border-top-color: oklch(0.50 0 0);
    
    &.editorial-featured {
      border-top-color: oklch(0.60 0 0);
      border-top-width: 3px;
    }
  }
}

Success Criteria:


Proposition 3 β€” genesis-environment('editorial-feed')

🧩 Ontological Proposition

Source Node: saga.asisaga.com

Intent (The β€˜What’): A blog/editorial listing layout that promotes the first item to a featured, full-width position and flows the remaining items in a compact readable list below it.

Context (The β€˜Why’):
chronological stacks all items identically in a single column at equal visual weight. distributed (bento grid) treats all items as autonomous entities of equal prominence. Neither creates the editorial hierarchy where the most recent/primary item is visually dominant over the rest. This is a distinct semantic pattern: a list with one featured leader and a supporting tail β€” used in every major editorial publication, every news site, every editorial blog.

Proposed Role:

Use Cases:

  1. saga.asisaga.com: Homepage blog listing β€” latest post featured full-width at top, remaining 9 posts as compact list entries below
  2. research.asisaga.com: Latest research/publications page β€” featured recent paper prominent, older papers as reference list
  3. docs.asisaga.com: What’s-new or changelog page β€” latest release featured, prior releases as compact list
  4. community.asisaga.com: Community discussion feed β€” pinned/featured discussion prominent over recent activity

Universal Applicability:

Suggested Implementation:

/**
 * @category Environment
 * @variant 'editorial-feed'
 * @origin PR from saga.asisaga.com (frontend-skill audit 2026-03)
 * @intent Blog/editorial listing with featured-first hierarchy
 * @since v5.0
 */
@else if $logic == 'editorial-feed' {
  // Time-ordered editorial feed with prominent first item
  display: grid;
  grid-template-columns: 1fr;
  position: relative;
  
  // Featured first item spans full width and receives larger treatment
  > :first-child {
    // First child is featured β€” environment provides spacing/layout,
    // genesis-entity('editorial') with .editorial-featured handles the visual treatment
    padding-bottom: clamp(2rem, 4vw, 3rem);
    margin-bottom: clamp(1rem, 2vw, 1.5rem);
    position: relative;
    
    // Visual separator between featured and list
    &::after {
      content: '';
      position: absolute;
      bottom: 0;
      left: 0;
      right: 0;
      height: 1px;
      background: linear-gradient(
        to right,
        transparent,
        oklch(0.75 0.10 85 / 0.5),
        transparent
      );
    }
  }
  
  // Remaining items form a compact list
  > :not(:first-child) {
    // Compact list treatment β€” spacing tighter than featured item
    gap: 0;
  }
  
  // Desktop: featured item gets left ~65% width, allows optional side column
  @media (min-width: 1024px) {
    grid-template-columns: 1fr;
    
    // Option: if layout supports featured + sidebar pattern, enable via modifier
    &.with-sidebar {
      grid-template-columns: 2fr 1fr;
      gap: clamp(2rem, 4vw, 3rem);
      
      // Featured item spans only the main column
      > :first-child {
        grid-column: 1;
        grid-row: 1 / span 3;
        padding-bottom: 0;
        
        &::after {
          display: none;
        }
      }
      
      // Remaining items fill the sidebar column
      > :not(:first-child) {
        grid-column: 2;
      }
    }
  }
  
  // Mobile: full single column, featured item slightly more padding
  @media (max-width: 767px) {
    gap: 0;
    
    > :first-child {
      padding-bottom: 1.5rem;
      margin-bottom: 0.75rem;
    }
  }
}

Success Criteria:


Proposition 4 β€” genesis-atmosphere('cosmic')

🧩 Ontological Proposition

Source Node: saga.asisaga.com

Intent (The β€˜What’): A rich deep-space atmospheric backdrop for blog sections and mission-adjacent content β€” darker than the neutral page background, evoking the ASI Saga cosmic identity, without being as heavy or ceremony-specific as sacred.

Context (The β€˜Why’):
The blog listing section on the homepage renders on the same neutral white background as everything else. For a site about Artificial Superintelligence and consciousness, the blog section deserves atmospheric depth β€” the feeling of reading from the edge of the known universe. The void atmosphere is too extreme (near-black, maximum contrast). The sacred atmosphere is ceremony-specific (gold accent line, reserved for genesis content). neutral is featureless. There is no in-between atmosphere that evokes cosmic depth without ceremony heaviness.

Proposed Role:

Use Cases:

  1. saga.asisaga.com: Blog listing section background β€” the section where all posts are listed should feel like the cosmos, not an office intranet
  2. research.asisaga.com: Research archive section β€” deep-space feel appropriate for profound academic content
  3. docs.asisaga.com: Content sections within long-form documentation where depth/context should feel expansive
  4. analytics.asisaga.com: Background for AI insight panels or predictive sections

Universal Applicability:

Suggested Implementation:

/**
 * @category Atmosphere
 * @variant 'cosmic'
 * @origin PR from saga.asisaga.com (frontend-skill audit 2026-03)
 * @intent Deep-space atmospheric backdrop β€” deeper than neutral, lighter than void
 * @since v5.0
 */
@else if $vibe == 'cosmic' {
  // Deep cosmic background β€” expressive but not ceremonial
  background: 
    radial-gradient(
      ellipse at 20% 50%,
      oklch(0.12 0.04 260 / 0.8) 0%,
      transparent 60%
    ),
    radial-gradient(
      ellipse at 80% 20%,
      oklch(0.10 0.03 250 / 0.6) 0%,
      transparent 50%
    ),
    oklch(0.09 0.02 255);  // Deep cosmic base
  color: oklch(0.92 0.005 90);  // Off-white text β€” softer than pure white
  position: relative;
  
  // Subtle star-field texture via noise (pure CSS, no images)
  &::before {
    content: '';
    position: absolute;
    inset: 0;
    background-image: 
      radial-gradient(1px 1px at 20% 30%, oklch(0.99 0 0 / 0.3) 0%, transparent 100%),
      radial-gradient(1px 1px at 40% 70%, oklch(0.99 0 0 / 0.2) 0%, transparent 100%),
      radial-gradient(1px 1px at 60% 15%, oklch(0.99 0 0 / 0.25) 0%, transparent 100%),
      radial-gradient(1px 1px at 80% 55%, oklch(0.99 0 0 / 0.2) 0%, transparent 100%),
      radial-gradient(1px 1px at 95% 85%, oklch(0.99 0 0 / 0.15) 0%, transparent 100%);
    pointer-events: none;
    z-index: 0;
  }
  
  // Content above star texture
  > * {
    position: relative;
    z-index: 1;
  }
  
  @media (prefers-contrast: high) {
    background: oklch(0.05 0 0);
    color: oklch(0.99 0 0);
    
    &::before {
      display: none;
    }
  }
}

Success Criteria:


πŸ“‹ Subdomain Implementation Plan

Once this PR is merged into the theme, saga.asisaga.com will update:

_sass/_blog-listing.scss

.blog-listing {
  @include genesis-environment('editorial-feed');  // was: chronological
  @include genesis-atmosphere('cosmic');            // NEW: deep-space blog section

  .container {
    // Remove genesis-entity('primary') β€” no white frame around listing
  }
}

.blog-post-card {
  @include genesis-entity('editorial');            // was: entity('secondary') + state('stable')

  &__title {
    @include genesis-cognition('heading');          // was: axiom (too large)

    a {
      @include genesis-synapse('navigate');
    }
  }

  &__date {
    @include genesis-cognition('gloss');
  }

  &__excerpt {
    @include genesis-cognition('discourse');
  }

  &__categories {
    @include genesis-environment('distributed');
  }

  &__category {
    @include genesis-entity('latent');
    @include genesis-cognition('protocol');
  }

  &__link {
    @include genesis-synapse('navigate');
    @include genesis-cognition('motive');
  }
}

index.html


πŸ” Self-Review Checklist


πŸ“š References