🏗️ 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)
- Build /collaboration/ directory [PRIORITY 1]
- Convert PROJECT-DIARY.md to HTML
- Create working-with-ai.html
- Document Craig's workflow
- Start lessons-learned.html
- Replace landing page
- Test AI-NEW.html
- Backup current AI-NEW.html → AI-OLD.html
- Deploy AI-NEW.html as AI-NEW.html
- 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)
- Refine TMA/AI/ content
- Add navigation breadcrumbs
- Add "back to index" links
- Ensure consistent styling
- Cross-link related topics
- Refine TMA/LLM/ content
- Same improvements as AI section
- Add progression indicators
- Link to collaboration examples
Phase 3: Add Meta-Content (Week 3)
- Build /architecture/ section
- Refactor ai-architecture-framework.html
- Create new advanced pages
- Link to collaboration diary entries
- Create supporting pages
- Glossary (extract terms)
- External links compilation
- Tools comparison matrix
Phase 4: Polish & Launch (Week 4)
- Final touches
- Consistent footer on all pages
- Mobile testing
- Link validation
- Spell check
- Add "last updated" dates
- 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
- Daily/weekly entries documenting our work
- Shows decision-making process
- Includes "dead ends" and iterations
- Demonstrates honest collaboration
- Format: chronological blog-style
working-with-ai.html
- Effective prompting techniques
- When to use AI vs. when not to
- How to validate AI outputs
- Collaboration patterns that work
- Based on Craig's actual experience
use-case-documentation.html
- Craig's knowledge transfer project
- How AI accelerates documentation
- Quality control strategies
- Real examples from Linux pages
- Metrics: pages created, time saved
lessons-learned.html
- Evolving insights (updated regularly)
- What works / what doesn't
- Unexpected benefits
- Challenges overcome
- Tips for others
Content Principles:
- Transparency: Show the work, not just results
- Attribution: Note which AI created what content
- Honesty: Include failures and iterations
- Practicality: Focus on real use cases
- Evolution: Update as we learn more
Navigation Strategy
Primary Navigation (from landing page)
- AI-Human Collaboration ← Featured, what makes us unique
- New to AI? ← Entry point for beginners
- AI Fundamentals ← Core concepts
- Large Language Models ← Deep dive
- AI Tools I Use ← Practical recommendations
- Resources & Reading ← Reference materials
- 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:
- Related Topics (same section)
- Next Steps (logical progression)
- Back to Index
- Collaboration Diary (relevant entry)
Styling Consistency
Color Scheme (Keep Current)
- Background: #f5ebcc (beige/cream)
- Primary: #006600 to #009900 (green gradient)
- Accent: #f5eb99 (light yellow)
- Text: #333 (dark gray)
- Links: #005500 (dark green)
Card Style
- Rounded corners (8px)
- Subtle shadow on hover
- Border-left accent color
- Transition animations
Badges
- NEW: Green (#51cf66)
- FEATURED: Red (#ff6b6b)
- Source tags: Gray italic
Success Criteria
Content Quality
- All information accurate and current
- Clear progression from beginner to advanced
- Practical examples throughout
- Attribution for AI-generated content
Collaboration Documentation
- Transparent process documentation
- Regular diary updates
- Honest assessment of successes/failures
- Actionable insights for others
User Experience
- Intuitive navigation
- Fast load times
- Mobile-friendly
- Accessible to all users
Unique Value
- Demonstrably different from other AI edu sites
- Provides meta-learning (AI + collaboration)
- Shows real-world application
- Evolves over time
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 |