# ============================================
# HCS FRAMEWORK CLIENT VARIABLES
# ============================================

# --- Business Context (REQUIRED) ---
business_name: ""
primary_domain: ""
business_industry: ""
business_focus_topics: []            # 3-7 topics this site is genuinely the authority on

# --- Content Audit Baseline (REQUIRED) ---
total_content_pieces: 0
content_publication_rate: ""         # "high_volume" (>10/week), "medium" (1-5/week), "low" (<1/week)
content_creation_method: ""          # "in_house_experts", "freelancers", "ai_assisted", "outsourced", "mixed"
average_content_length: 0            # Words

# --- Audience (REQUIRED) ---
primary_audience_description: ""     # Who is this content actually for?
audience_pain_points: []             # 3-5 specific problems they're trying to solve
audience_expertise_level: ""         # "beginner", "intermediate", "expert", "mixed"

# --- Content Strategy Honesty Check (REQUIRED — answer truthfully) ---
publishes_for_search_intent_only: false  # Be honest. Were any articles published only because keywords had volume?
publishes_thin_content: false        # Articles under 500 words on substantive topics
publishes_aggregated_content: false  # Content that mostly summarizes others without adding value
uses_ai_for_bulk_content: false
ai_content_review_quality: ""        # "minimal", "moderate", "rigorous", "expert_review_required"
content_serves_genuine_user_need: ""  # 1-10 self-rating of how well content serves users vs ranks

# --- Helpful Content Markers (RECOMMENDED) ---
has_about_us_explaining_purpose: false
has_author_bios_with_credentials: false
has_original_research: false
has_first_hand_experience_demonstrated: false
has_clear_topical_focus: false
has_practical_value_per_article: false
publishes_only_what_audience_needs: false

# --- SEO-First Anti-Patterns (RECOMMENDED — be honest) ---
has_pages_targeting_high_volume_low_intent_keywords: false
has_doorway_pages: false
has_thin_aggregator_pages: false
has_AI_content_passed_off_as_expert: false
has_content_promising_what_it_doesnt_deliver: false
has_clickbait_titles_not_matching_content: false
has_padded_content_to_hit_word_count: false

# --- Refresh & Maintenance (REQUIRED) ---
content_review_cadence: ""           # "monthly", "quarterly", "annually", "never"
has_content_decay_process: false
retires_outdated_content: false
consolidates_redundant_content: false

<aside class="original-value" aria-label="What this article adds">
  <h3>What This Article Adds</h3>
  <p>Most articles on {{TOPIC}} cover {{COMMON_COVERAGE}}. This article goes further with:</p>
  <ul>
    <li>{{ORIGINAL_CONTRIBUTION_1}}</li>
    <li>{{ORIGINAL_CONTRIBUTION_2}}</li>
    <li>{{ORIGINAL_CONTRIBUTION_3}}</li>
  </ul>
</aside>

<nav class="article-coverage" aria-label="What this article covers">
  <h2>What This Guide Covers</h2>
  <ol>
    {{LIST_OF_SECTIONS_WITH_LINKS_TO_HEADINGS}}
  </ol>
</nav>

<article class="article hcs-compliant">
  <!-- Metadata header -->
  <header>
    <h1>{{ACCURATE_TITLE_THAT_MATCHES_CONTENT}}</h1>

    <div class="article-byline">
      <img src="{{AUTHOR_PHOTO}}" alt="{{AUTHOR_NAME}}">
      <p>By <a href="/authors/{{AUTHOR_SLUG}}/" rel="author">{{AUTHOR_NAME}}</a></p>
      <p class="byline-credentials">{{RELEVANT_CREDENTIALS_FOR_THIS_TOPIC}}</p>
      <time datetime="{{PUBLISHED}}">Published {{PUBLISHED_HUMAN}}</time>
      <time datetime="{{UPDATED}}">Updated {{UPDATED_HUMAN}}</time>
    </div>

    {{IF_AI_USED}}
    <aside class="ai-disclosure">
      This article {{AI_USAGE_LEVEL}}. Reviewed and verified by {{REVIEWER_NAME}}.
    </aside>
    {{/IF}}
  </header>

  <!-- Original value indicator -->
  <aside class="original-value">
    <h2>What This Article Adds</h2>
    <ul>
      {{ORIGINAL_CONTRIBUTIONS}}
    </ul>
  </aside>

  <!-- Coverage promise (if comprehensive guide) -->
  {{IF_COMPREHENSIVE_GUIDE}}
  <nav class="article-coverage">
    <h2>What This Guide Covers</h2>
    {{TOC}}
  </nav>
  {{/IF}}

  <!-- Article body — substantive content -->
  <div class="article-body">
    {{CONTENT_THAT_DELIVERS_ON_THE_TITLE_PROMISE}}

    <!-- First-hand experience callout when applicable -->
    {{IF_PRACTICAL_CONTENT}}
    <aside class="experience-callout">
      <h3>How I Know This Works</h3>
      <p>{{SPECIFIC_EXPERIENCE_DETAILS}}</p>
    </aside>
    {{/IF}}

    <!-- Original imagery, screenshots, data visualizations -->
    {{ORIGINAL_VISUAL_CONTENT}}

    <!-- Failure cases for practical content -->
    {{IF_LONG_FORM_PRACTICAL}}
    <section class="failures-edge-cases">
      <h2>What Doesn't Work</h2>
      {{SPECIFIC_FAILURES_OR_EDGE_CASES}}
    </section>
    {{/IF}}
  </div>

  <!-- End cleanly: takeaway, next step, or related -->
  <footer>
    <section class="article-takeaway">
      <h2>Key Takeaway</h2>
      <p>{{ONE_SENTENCE_TAKEAWAY}}</p>
    </section>

    <section class="article-next-step">
      <h2>Next Step</h2>
      <p>{{SPECIFIC_RECOMMENDATION_FOR_THE_READER}}</p>
    </section>

    {{REFERENCES_IF_FACTUAL_CONTENT}}
    {{AUTHOR_BOX}}
    {{RELATED_ARTICLES_GENUINELY_RELATED}}
  </footer>
</article>

Primary Topics (we are the authority):
1. {{TOPIC_1}} - {{WHY_WE_ARE_AUTHORITY}}
2. {{TOPIC_2}} - {{WHY_WE_ARE_AUTHORITY}}
3. {{TOPIC_3}} - {{WHY_WE_ARE_AUTHORITY}}

Secondary Topics (we have meaningful coverage):
1. {{TOPIC_4}}
2. {{TOPIC_5}}

Topics We Don't Cover (and why):
- {{ADJACENT_TOPIC}} - {{REASON_NOT_COVERED}}

<article class="topical-hub" itemscope itemtype="https://schema.org/CollectionPage">
  <h1>{{TOPIC_NAME}}</h1>

  <section class="hub-introduction">
    <p>{{200_400_WORD_AUTHORITATIVE_INTRO_DEMONSTRATING_DEPTH}}</p>
  </section>

  <section class="hub-our-perspective">
    <h2>Our Perspective on {{TOPIC}}</h2>
    <p>{{WHAT_MAKES_THIS_SITES_TAKE_ON_THE_TOPIC_DISTINCTIVE}}</p>
  </section>

  <section class="hub-content-organized">
    <h2>{{TOPIC}} — Complete Coverage</h2>

    <h3>Foundations</h3>
    <ul>{{FOUNDATIONAL_ARTICLES}}</ul>

    <h3>Practical Application</h3>
    <ul>{{PRACTICAL_ARTICLES}}</ul>

    <h3>Advanced Topics</h3>
    <ul>{{ADVANCED_ARTICLES}}</ul>

    <h3>Original Research</h3>
    <ul>{{RESEARCH_ARTICLES}}</ul>
  </section>

  <section class="hub-related-pillars">
    <h2>Related Topics We Cover</h2>
    <ul>{{LINKS_TO_RELATED_HUBS}}</ul>
  </section>

  <section class="hub-not-covered">
    <h2>Topics We Don't Cover (And Where to Find Them)</h2>
    <p>{{HONEST_GUIDANCE_TO_OTHER_AUTHORITATIVE_SOURCES}}</p>
  </section>
</article>

<article class="about-page">
  <h1>About {{BUSINESS_NAME}}</h1>

  <section class="why-we-exist">
    <h2>Why We Exist</h2>
    <p>{{SPECIFIC_PROBLEM_THE_SITE_SOLVES_FOR_AUDIENCE}}</p>
    <p>{{HOW_THE_SITE_IS_DIFFERENT_FROM_ALTERNATIVES}}</p>
  </section>

  <section class="who-we-are">
    <h2>Who We Are</h2>
    <p>{{FOUNDER_BIO_WITH_RELEVANT_EXPERIENCE}}</p>
    <p>{{TEAM_INFO_IF_APPLICABLE}}</p>
  </section>

  <section class="what-we-cover">
    <h2>What We Cover</h2>
    <ul>{{LIST_OF_PRIMARY_PILLARS_WITH_LINKS}}</ul>
  </section>

  <section class="what-we-dont-cover">
    <h2>What We Don't Cover</h2>
    <p>{{HONEST_DESCRIPTION_OF_TOPICS_OUTSIDE_SCOPE}}</p>
  </section>

  <section class="our-process">
    <h2>How We Create Content</h2>
    <ul>
      <li>{{CONTENT_CREATION_PROCESS_DETAIL}}</li>
      <li>{{REVIEW_PROCESS_DETAIL}}</li>
      <li>{{FACT_CHECKING_DETAIL}}</li>
      <li>{{IF_AI_USED_HOW}}</li>
    </ul>
    <p>See our <a href="/editorial-policy/">editorial policy</a> for full details.</p>
  </section>

  <section class="our-relationships">
    <h2>Our Relationships and Commitments</h2>
    <p>{{INDEPENDENCE_STATEMENT}}</p>
    <p>{{ANY_AFFILIATE_OR_PARTNERSHIP_CONTEXT}}</p>
    <p>See our <a href="/disclosure/">full disclosures</a>.</p>
  </section>

  <section class="contact">
    <h2>How to Reach Us</h2>
    <p>{{CONTACT_INFO}}</p>
    <p>Editorial questions: <a href="mailto:editorial@{{DOMAIN}}">editorial@{{DOMAIN}}</a></p>
  </section>
</article>

<aside class="ai-content-disclosure">
  <h3>About this article</h3>
  <p>{{SPECIFIC_DESCRIPTION_OF_HOW_AI_WAS_USED}}</p>
  <p>This article was reviewed and edited by {{REVIEWER_NAME}}, {{CREDENTIALS}}.</p>
  <p>{{REVIEWER_NAME}} verified all factual claims, citations, and recommendations. They take professional responsibility for the accuracy of this content.</p>
  <p>See our <a href="/disclosure/">full AI use policy</a>.</p>
</aside>

<details class="article-changelog">
  <summary>Last updated {{UPDATED_DATE}} — see what changed</summary>
  <ul>
    <li><time datetime="{{UPDATE_1_DATE}}">{{UPDATE_1_DATE_HUMAN}}</time>: {{WHAT_CHANGED}}</li>
    <li><time datetime="{{UPDATE_2_DATE}}">{{UPDATE_2_DATE_HUMAN}}</time>: {{WHAT_CHANGED}}</li>
    <li><time datetime="{{UPDATE_3_DATE}}">{{UPDATE_3_DATE_HUMAN}}</time>: {{WHAT_CHANGED}}</li>
  </ul>
</details>

# HCS Framework Implementation Report

**Project**: {{BUSINESS_NAME}}
**Implementation Date**: {{TODAY}}

## Summary
- Total content audited: {{COUNT}}
- Content kept (high quality): {{COUNT}}
- Content refreshed substantively: {{COUNT}}
- Content consolidated: {{COUNT}}
- Content removed: {{COUNT}}

## Topical Pillars Defined
{{LIST_OF_PILLARS}}

## Hub Pages Created
{{LIST_OF_HUB_URLS}}

## About Page Updated
{{STATUS_AND_KEY_ADDITIONS}}

## AI Use Policy
{{POLICY_STATUS}}

## HCS Markers Installed Per Article Type
{{TABLE}}

## Items Flagged for Manual Review
{{LIST}}

## Validation Results
{{AUTOMATED_AND_MANUAL_RESULTS}}

## Sign-Off
Implementation complete: {{DATE}}

# HCS Framework Audit Report

**Site**: {{BUSINESS_NAME}}
**Audit Date**: {{TODAY}}

## Executive Summary
{{ONE_PARAGRAPH_ASSESSMENT}}

**Overall Score**: {{X}}/54
**Status**: {{STATUS}}

## Topical Focus Assessment
{{FINDINGS}}

## Content Quality Distribution
- High-quality content: {{PERCENTAGE}}%
- Acceptable content: {{PERCENTAGE}}%
- Thin/derivative content: {{PERCENTAGE}}%

## Critical HCS Failures
{{LIST_WITH_REMEDIATION}}

## Per-Article Findings (Sample of 10%)
{{DETAILED_FINDINGS}}

## Site-Wide Findings
{{DETAILED_FINDINGS}}

## Recommended Remediation Order
1. Critical: {{PRIORITY_1}}
2. High: {{PRIORITY_2}}
3. Medium: {{PRIORITY_3}}

## Estimated Remediation Effort
{{HOURS}}

## Sign-Off