🏗️ AI Website Project Structure

Organization Plan & Implementation Guide

Date: February 14, 2026 | Version: 1.0 | Status: Planning Complete

Core Concept

Traditional Approach:
"Here's information about AI" → Static knowledge transfer

Our Approach:
"Here's information about AI + here's how we created it together" → Dynamic demonstration of collaboration

The Value Proposition:
Users learn AI concepts while simultaneously seeing effective AI-human partnership in action.

Proposed Directory Structure

AI/ (Root - your main AI section) │ ├── AI-NEW.html (index) ← NEW landing page (collaboration theme) │ ├── collaboration/ ← NEW SECTION - The Differentiator │ ├── project-diary.html (INDEX of all diary entries) │ ├── 2026-02-14-PROJECT-DIARY.html (Day 1 full entry) │ ├── 2026-02-15-PROJECT-DIARY.html (Day 2 full entry - I'll create) │ ├── 2026-MM-DD-PROJECT-DIARY.html (future entries...) │ ├── working-with-ai.html ← Effective prompting & patterns │ ├── use-case-documentation.html ← Craig's doc workflow │ └── lessons-learned.html ← Evolving insights │ ├── TMA/ ← KEEP - existing structure │ ├── AI/ ← Current AI fundamentals (10 files) │ │ ├── AI-Components.html │ │ ├── AI-Types-Detail.html │ │ ├── AI-Capabilities.html │ │ ├── AI-ML-Approaches.html │ │ ├── AI_Cat-Type-Use.html │ │ ├── AI-Cat_use_List_deepseek.html │ │ ├── AI-Cat_use_List_II-grok.html │ │ ├── AI_types_ai-x.html │ │ ├── AI-Functionality.html │ │ └── AI-Application.html │ │ │ └── LLM/ ← Current LLM deep-dive (5 files) │ ├── LLM-Fundamental-Components.html │ ├── LLM-Neural-Network-Structure.html │ ├── LLM-Tokenization.html │ ├── LLM-Capabilities.html │ └── LLM-Capabilities_MORE.html │ ├── learning/ ← REORGANIZE - gather materials │ ├── Assesment_and_.html │ ├── AI_learning_plan_ai-x.html │ ├── Recommended_Learning_Path-AI-LLM.html │ └── AI-Cat_use_List_ai-x.html │ ├── resources/ ← NEW - consolidate references │ ├── tools-comparison.html │ ├── Suggested-AI-Books.html │ ├── glossary.html ← NEW │ ├── external-links.html │ └── Databricks-Big-Book-Of-GenAI-FINAL.pdf │ └── architecture/ ← NEW - advanced technical ├── ai-architecture-framework.html ├── the-stack.html ├── llm-architecture.html └── neural-networks-deep.html

Migration Plan

Phase 1: Create New Sections (Week 1)

  1. Build /collaboration/ directory [PRIORITY 1]
    • Convert PROJECT-DIARY.md to HTML
    • Create working-with-ai.html
    • Document Craig's workflow
    • Start lessons-learned.html
  2. Replace landing page
    • Test AI-NEW.html
    • Backup current AI-NEW.html → AI-OLD.html
    • Deploy AI-NEW.html as AI-NEW.html
  3. Create /learning/ and /resources/ directories
    • Move files from root to appropriate subdirs
    • Update all internal links
    • Test navigation

Phase 2: Enhance Existing Content (Week 2)

  1. Refine TMA/AI/ content
    • Add navigation breadcrumbs
    • Add "back to index" links
    • Ensure consistent styling
    • Cross-link related topics
  2. Refine TMA/LLM/ content
    • Same improvements as AI section
    • Add progression indicators
    • Link to collaboration examples

Phase 3: Add Meta-Content (Week 3)

  1. Build /architecture/ section
    • Refactor ai-architecture-framework.html
    • Create new advanced pages
    • Link to collaboration diary entries
  2. Create supporting pages
    • Glossary (extract terms)
    • External links compilation
    • Tools comparison matrix

Phase 4: Polish & Launch (Week 4)

  1. Final touches
    • Consistent footer on all pages
    • Mobile testing
    • Link validation
    • Spell check
    • Add "last updated" dates
  2. Meta-documentation
    • Update project diary with completion
    • Write final lessons-learned summary
    • Document collaboration stats

The Collaboration Section (What Makes Us Unique)

project-diary.html

working-with-ai.html

use-case-documentation.html

lessons-learned.html

Content Principles:
  1. Transparency: Show the work, not just results
  2. Attribution: Note which AI created what content
  3. Honesty: Include failures and iterations
  4. Practicality: Focus on real use cases
  5. Evolution: Update as we learn more

Navigation Strategy

Primary Navigation (from landing page)

  1. AI-Human Collaboration ← Featured, what makes us unique
  2. New to AI? ← Entry point for beginners
  3. AI Fundamentals ← Core concepts
  4. Large Language Models ← Deep dive
  5. AI Tools I Use ← Practical recommendations
  6. Resources & Reading ← Reference materials
  7. AI for Unix/Linux ← Specialized tools

Secondary Navigation (breadcrumbs)

AI Home > Collaboration > Project Diary > Day 1 AI Home > Fundamentals > AI Components AI Home > LLM > Neural Network Structure

Tertiary Navigation (related links)

At bottom of each content page:

Styling Consistency

Color Scheme (Keep Current)

Card Style

Badges

Success Criteria

Content Quality

Collaboration Documentation

User Experience

Unique Value

Rollout Timeline

Week Focus
Week 1 Foundation - Create collaboration directory, new landing page, convert diary
Week 2 Content - Reorganize materials, refactor architecture, update links
Week 3 Enhancement - Add breadcrumbs, cross-linking, create glossary
Week 4 Launch - Final QA, link validation, mobile testing, deploy
Ongoing Maintenance - Weekly diary updates, monthly reviews, continuous improvement