Portfolio Project Structure - Instructions for Claude¶

This document provides context and guidelines for working on Christos's DevOps/SRE portfolio projects. These projects demonstrate skills for transitioning from telecommunications DevOps to industries such as aerospace, defense, fintech, healthcare and other sectors with longer time-to-market.

🎯 Career Goals Context¶

Current Role: Telecommunications DevOps/Release Management
Target Roles: DevOps Engineer, SRE, Cloud Engineer, Platform Engineer, Infrastructure Engineer
Target Industries: Aerospace/Defense (Surrey, UK), Financial Services, Healthcare Tech, Enterprise SaaS, Government
Location: Surrey, UK
Work Preference: Fully remote or hybrid roles

Certification Path: - HashiCorp Certified: Terraform Associate (in progress) - Certified Kubernetes Administrator (CKA) (planned) - Certified Kubernetes Application Developer (CKAD) (planned) - Red Hat Certified Specialist in Ansible Automation (planned)

📁 Project Structure Overview¶

portfolio-root/
├── CLAUDE.md                           # This file - context for Claude
├── README.md                           # Portfolio overview and navigation
│
├── mini-projects/                      # Foundational learning projects
│   ├── 1-terraform-docker-nginx/       # Project 1: Terraform basics
│   │   ├── README.md
│   │   ├── terraform/
│   │   ├── docker/
│   │   └── docs/
│   │
│   ├── 2-k8s-python-app/               # Project 2: Kubernetes fundamentals
│   │   ├── README.md
│   │   ├── k8s/
│   │   ├── app/
│   │   └── docs/
│   │
│   └── 3-ansible-docker-demo/          # Project 3: Ansible automation
│       ├── README.md
│       ├── playbook.yml
│       ├── inventory.ini
│       ├── templates/
│       ├── target/
│       └── LEARNING_NOTES.md
│
├── christosm.dev/                      # Zensical static site
│   ├── README.md
│   ├── content/
│   ├── static/
│   └── config/
│
└── vps-sandbox-platform/               # Advanced showcase project
    ├── README.md
    ├── backend/
    ├── terraform/
    ├── k8s/
    └── docs/

📋 Project Descriptions¶

1. terraform-docker-nginx¶

Purpose: Demonstrate Terraform fundamentals and Infrastructure as Code
Technologies: Terraform, Docker, NGINX
Complexity: Beginner-friendly, foundational
Certification Alignment: Terraform Associate

Key Concepts: - Terraform providers (Docker provider) - Resource management (containers, networks, volumes) - State management - Variables and outputs - Basic infrastructure provisioning

Typical Tasks: - Create Terraform configurations for Docker containers - Provision NGINX web servers - Manage container lifecycle - Document infrastructure decisions

2. k8s-python-app¶

Purpose: Demonstrate Kubernetes fundamentals and application deployment
Technologies: Kubernetes (Minikube/K3s), Python (Flask/FastAPI), Docker
Complexity: Intermediate
Certification Alignment: CKA, CKAD

Key Concepts: - Kubernetes objects (Pods, Deployments, Services) - ConfigMaps and Secrets - Resource limits and requests - Health checks (liveness/readiness probes) - Ingress controllers - Basic monitoring

Typical Tasks: - Create Kubernetes manifests - Deploy Python applications - Configure service discovery - Implement health checks - Troubleshoot deployments

3. ansible-docker-demo¶

Purpose: Demonstrate Ansible automation and configuration management
Technologies: Ansible, Docker, Linux
Complexity: Beginner-intermediate
Certification Alignment: Red Hat Ansible Automation

Key Concepts: - Ansible playbooks - Inventory management - Idempotent operations - Jinja2 templating - Role-based organization - Container management with Ansible

Typical Tasks: - Write Ansible playbooks - Configure Docker hosts - Manage container deployments - Automate infrastructure tasks - Document automation patterns

4. christosm.dev (Zensical)¶

Purpose: Static site generator for technical documentation and portfolio
Technologies: Static Site Generator (Hugo/Jekyll/Next.js), Markdown, HTML/CSS
Complexity: Varies

Key Concepts: - Static site generation - Content management - Documentation as code - Responsive design - Deployment pipelines

Typical Tasks: - Generate documentation sites - Create blog posts - Maintain portfolio content - Deploy to hosting platforms

5. vps-sandbox-platform¶

Purpose: Advanced showcase project demonstrating production-grade skills
Technologies: Docker, Kubernetes, Terraform, FastAPI, Security hardening
Complexity: Advanced
Certification Alignment: All certifications

Key Concepts: - Multi-phase architecture (Docker → Kubernetes) - Defense-in-depth security - Production deployment patterns - Resource management - Monitoring and observability - Enterprise patterns

Typical Tasks: - Production-grade implementations - Security hardening - Performance optimization - Comprehensive documentation - Interview preparation materials

🎨 Documentation Standards¶

Every Project Should Have:¶

1. README.md at root level containing:

   • Project overview and purpose
   • Technologies used
   • Quick start guide
   • Architecture overview
   • Links to detailed documentation

2. docs/ directory with:

   • Detailed documentation
   • Architecture diagrams (when applicable)
   • Deployment guides
   • Troubleshooting guides
   • Interview talking points

3. Code quality:

   • Clear comments explaining complex logic
   • Consistent formatting
   • Security best practices
   • Error handling
   • Logging where appropriate

4. Configuration files:

   • .gitignore (exclude secrets, temporary files)
   • Example configuration files (.example suffix)
   • Clear documentation of required variables

🔐 Security Guidelines¶

Critical: Never commit sensitive information to version control.

Always exclude: - API keys, tokens, passwords - Private SSH keys - Cloud provider credentials - .tfstate files (use remote backend) - Personal information - VPS IP addresses (unless necessary)

Always include: - .example files for configuration templates - Documentation on how to obtain/configure secrets - Security best practices in documentation - References to security features implemented

📝 Working with Claude Guidelines¶

Context Provision¶

When starting work on a project, provide: - Which project (by number/name) - Current phase or goal - Specific technologies involved - Any blockers or issues

Code Creation¶

• Verbose explanations: Christos prefers detailed explanations when introducing new concepts
• Complete codebases: Provide full, working code rather than snippets
• Documentation: Include README files with context
• Progressive complexity: Start simple, build up to advanced

File Management¶

• Always use /home/claude as working directory
• Move final outputs to /mnt/user-data/outputs/
• Create zip files for multi-file projects
• Maintain project structure consistently

Documentation Style¶

• Clear, professional tone
• Suitable for portfolio/interview use
• Include "why" not just "how"
• Career context and talking points
• Certification alignment notes

🎯 Career Alignment¶

For Each Project, Consider:¶

Interview Talking Points: - What problem does it solve? - What technologies/patterns does it demonstrate? - What decisions did you make and why? - What would you do differently at scale?

Certification Relevance: - Which exam topics does it cover? - How can it be used as study material? - What hands-on practice does it provide?

Industry Relevance: - Aerospace/Defense: Emphasize security, reliability - Financial Services: Highlight compliance, audit trails - Healthcare: Focus on data protection, reliability - Government: Showcase security clearance suitability

🔄 Project Evolution¶

Projects may evolve through phases:

1. Phase 1: Foundation - Basic working implementation
2. Phase 2: Production - Hardening, security, monitoring
3. Phase 3: Advanced - Scaling, optimization, advanced features

Document each phase separately to show progression and learning.

📊 Success Criteria¶

Each project should: - ✅ Run successfully (locally and/or deployed) - ✅ Have comprehensive documentation - ✅ Demonstrate best practices - ✅ Include security considerations - ✅ Provide interview material - ✅ Align with certification goals - ✅ Be portfolio-ready (public GitHub)

🚀 Deployment Targets¶

Development/Testing: - Local machine (WSL, Docker Desktop) - Minikube (Kubernetes) - Local Docker daemon

Production/Demo: - Contabo VPS (primary) - Cloud providers (AWS, GCP, Azure) - optional - GitHub Pages (static sites)

📞 Communication Style¶

Christos prefers: - Detailed technical explanations - Complete working examples - Comprehensive documentation - Progressive learning approach - Career-focused context - Interview preparation insights

Avoid: - Oversimplification without context - Partial code snippets without full examples - Assumptions about prior knowledge - Generic advice without career relevance

🎓 Learning Philosophy¶

These projects serve multiple purposes: 1. Hands-on learning - Build real skills through practice 2. Certification preparation - Align with exam objectives 3. Portfolio building - Demonstrate capabilities to employers 4. Interview preparation - Provide discussion material 5. Career transition - Bridge from telecoms to target industries

Each project should support all five purposes where possible.

📖 Quick Reference Commands¶

Starting a New Project Session¶

# Navigate to project
cd /home/claude/<project-name>

# Check project structure
ls -la

# Review README
cat README.md

Completing Work¶

# Copy to outputs
cp -r /home/claude/<project-name> /mnt/user-data/outputs/

# Or create zip
cd /mnt/user-data/outputs
zip -r <project-name>.zip <project-name>/

# Present to user
# Use present_files tool

File Organization¶

# Create standard structure
mkdir -p {terraform,k8s,ansible,docs,scripts}

# Create standard files
touch README.md .gitignore

🔄 Iterative Development¶

Projects will be developed iteratively: 1. Initial implementation - Get it working 2. Documentation - Explain what was built 3. Enhancement - Add features/complexity 4. Optimization - Improve performance/security 5. Interview prep - Add talking points

Each iteration should be clearly documented.

📝 Notes for Claude¶

• Christos is hands-on and wants to understand the "why" behind decisions
• Security is important (targeting SC clearance roles)
• Documentation should be interview-ready
• Code should be production-quality where possible
• Always think about how projects demonstrate skills for target roles
• Link concepts to certification exam topics when relevant

🎯 Current Focus¶

As of this document's creation, the current priorities are:

1. Mini projects (1-3) - ✅ Complete and documented
2. christosm.dev - Documentation site with auto-sync system implemented
3. vps-sandbox-platform - Planning phase (not yet started)
4. Terraform certification preparation - Ongoing
5. Kubernetes learning - Preparing for CKA
6. Portfolio organization - Structuring projects for presentation

📊 Project Status Tracking¶

Use these markers in project READMEs:

• 🚧 Planning - Concept and architecture phase
• 🏗️ In Development - Active implementation
• ✅ Complete - Working and documented
• 🚀 Deployed - Live on VPS or cloud
• 📝 Documented - Interview-ready documentation
• 🎯 Portfolio Ready - Public and presentable

Last Updated: February 4, 2026
Portfolio Owner: Christos
Career Focus: DevOps/SRE/Cloud/Platform Engineering
Geographic Focus: UK (Surrey), Fully Remote
Target Industries: Aerospace, Defense, FinTech, HealthTech, Enterprise SaaS

Quick Project Reference¶

Use this table to quickly understand project status and focus areas.