01 — CONTEXT: Homepage
Input definitions, validation rules, and what each mode requires.
Mode 1 Inputs — Build Homepage
| Input | Required | Example | Used For |
|---|---|---|---|
| Brand variant | Yes | cyp or aos | Determines color palette, fonts, tone, asset URLs |
| Brand name | Yes | "Practice Builders" | Header, footer, meta tags, OG tags |
| Tagline / descriptor | Yes | "AI Skills for Professional Services" | Meta description, header subtext |
| Domain URL | Yes | https://thepracticebuilders.ai | Header logo link, OG URL, canonical |
| Owner name | Yes | "Kathryn Brown" | Header byline, about section, footer |
| Owner photo URL | Yes | Cloudinary/CDN hosted image | About hero background |
| Logo URL | Yes | CDN-hosted PNG or SVG | Header logo |
| Hero headline | Yes | "AI skills built on your real practice data — ready in minutes." | Hero section H1 |
| Hero subheadline | Yes | "Start with a single skill..." | Hero supporting copy |
| Target audience descriptor | Yes | "For Consultants, CPAs & Advisors" | Hero eyebrow |
| Featured product name | Yes | "Client Intelligence Brief" | Featured product section, hero side panel, CTAs |
| Featured product URL | Yes | https://thepracticebuilders.ai/cib | All CTA buttons for free offer |
| Featured product description | Yes | "Paste recent client emails into any AI assistant..." | Featured product section body copy |
| Featured product sample output | Yes | 4-5 bullet preview of what the skill produces | Featured product "Sample Output" panel |
| Paid offer name | Yes | "The Build" | Paid offer section heading |
| Paid offer URL | Yes | https://thepracticebuilders.ai/the-build | Paid offer CTA |
| Paid offer description | Yes | "3 sessions. 3 skills..." | Paid offer body copy |
| Paid offer logistics | Yes | When, Format, Price, What You Keep | 2x2 logistics grid |
| About copy | Yes | 2-3 paragraphs, first person or third person | About hero content |
| Testimonial(s) | Yes | At least 1 with quote, attribution, and company | Proof section + pull quote section |
| Contact email | Yes | kathryn@creatingyourplan.com | Footer |
| Social links | No | LinkedIn URL, Substack URL | Footer |
| Navigation items | No | Default: [Featured Product anchor, Paid Offer anchor, About anchor] | Header nav |
| Privacy/Terms/Disclaimer URLs | No | creatingyourplan.com/privacy-policy | Footer legal links |
| Pattern/Problem copy | Yes | 2-3 paragraphs naming the problem the audience faces | Problem section |
Validation Rules — Mode 1
- Brand variant must be specified before building. CYP and AOS use different palettes, fonts, and tone. Do not mix them. If unclear, ask.
- Owner photo must be a hosted URL, not a local file. The homepage is deployed to Convertri or a static host — local paths break.
- At least one testimonial with a real name and company. Anonymous quotes ("A satisfied client") do not build credibility on a homepage.
- Featured product must have a working URL. The homepage primary CTA drives to this page. A dead link is worse than no homepage.
- Paid offer logistics must be complete. If dates, price, or format are TBD, use a placeholder like "Coming Soon" but never leave the section blank or remove it.
- All copy must pass voice.md and copy-qc.md before inclusion. Homepage copy is the first thing a prospect reads. AI tells on the homepage destroy credibility before the visitor reaches any offer page.
- No internal acronyms in any visible text. Spell out "Client Intelligence Brief" — never "CIB." Spell out "Practice Builders" — never "PB." See copy-qc.md P1 rule on internal shorthand.
Mode 2 Inputs — Improve This Kit
| Input | Required | Source | Used For |
|---|---|---|---|
| Kit location | Yes | content/frameworks/kit-homepage/ | Which kit to improve |
| Trigger | Yes | QC failure, manual output changes, or system suggestion | Determines which files to update |
| Updated output | If applicable | The corrected HTML file | Replaces file 03 (golden example) |
| QC findings | If applicable | Specific checklist items that failed | Updates file 04 (quality) |
| Process changes | If applicable | Steps wrong, missing, or in wrong order | Updates file 05 (output skill) |
Validation Rules — Mode 2
- Always read the current kit files before making changes.
- Changes propagate — if you update the golden example, check whether the output skill and quality checklist still match.
- Never remove a quality check without a reason.
- Document what changed and why:
Mode 3 Inputs — Update Content
| Input | Required | Source | Used For |
|---|---|---|---|
| Current homepage HTML | Yes | The deployed or latest version | Base file to modify |
| What changed | Yes | "New event dates," "New testimonial," "Updated price" | Identifies which sections to touch |
| New content | Yes | The replacement copy, dates, URLs, etc. | Swapped into the appropriate section |
Validation Rules — Mode 3
- Do not change section order or architecture in Mode 3. That requires Mode 1.
- Run the quality checklist after content swaps — even small changes can break responsive layout or violate copy rules.
- If the update touches testimonials, verify the footer disclaimer still covers the testimonial context accurately.
Input Priority Hierarchy
When inputs conflict or are ambiguous:
- The golden example wins for structure, section order, and visual patterns
- Kathryn's explicit direction wins for copy, positioning, and audience framing
- Brand reference files win for colors, fonts, and voice (visual-style-cyp.md or visual-style.md + voice.md)
- copy-qc.md wins for AI pattern detection — any flagged copy gets rewritten regardless of source
External QC Dependencies
This kit's output contains customer-facing prose and brand voice. The following external files are mandatory QC gates:
| File | Location | When to Run | What It Catches |
|---|---|---|---|
| voice.md | business-aos/reference/core/voice.md | Before writing any copy | Wrong vocabulary, wrong tone, forbidden words |
| copy-qc.md | business-aos/reference/brand/copy-qc.md | After all copy is written, before visual review | AI-generated patterns (11 checks, P1/P2/P3 severity) |
| visual-style-cyp.md | business-aos/reference/brand/visual-style-cyp.md | During build (CYP variant) | Wrong colors, fonts, component patterns |
| visual-style.md | business-aos/reference/brand/visual-style.md | During build (AOS variant) | Wrong colors, fonts, component patterns |