AI Agent Guidelines for Javiator’s Blog

This document provides a high-level overview for AI agents working with this blog project. For detailed implementation guidelines, refer to the Cursor rules in .cursor/rules/.

Project Overview

This is a Jekyll-based blog showcasing “Tenant Management: An Evolutionary Project” - a systematic approach to architectural evolution through 5 different technology stacks and architectural approaches.

Cursor Rules Structure

This project uses the modern Cursor rules format with .cursor/rules/ directory containing .mdc files:

Quick Reference

Evolution Structure

Evolution 1: Single-File Foundation (✅ Complete)
Evolution 2: Modular Architecture (✅ Complete)  
Evolution 3: Java Enterprise Stack (🔄 Active)
Evolution 4: AI-Enhanced Interface (📋 Planned)
Evolution 5: Conversational Interface (📋 Planned)

Current Status

Key Principles

  1. Progressive Complexity: Each evolution builds upon previous learnings
  2. Technology Mastery: Deep dive into different technology stacks
  3. Architectural Patterns: From simple to enterprise-ready architectures
  4. Decision Making: Documented reasoning behind each architectural choice
  5. Portfolio Value: Comprehensive case study in software evolution

Essential Guidelines

Post Creation

Post Structure Template

# Post Title

<!-- Evolution Post Navigation Component -->
<div class="evolution-post-navigation">
  <div class="evolution-context">
    <div class="context-header">
      <h4>Evolution Context</h4>
    </div>
    <div class="context-content">
      <p><strong>Project:</strong> <a href="/projects/tenant-management/">Tenant Management: An Evolutionary Project</a></p>
      <p><strong>Evolution:</strong> <a href="/projects/tenant-management/evolution-/"></a></p>
      <p><strong>Focus:</strong> </p>
      <p><strong>Status:</strong> 
        
          📋 Planned
        
      </p>
    </div>
  </div>
  
  <div class="post-navigation">
    <div class="nav-section">
      <h4>Evolution Navigation</h4>
      <ul>
        <li><a href="/projects/tenant-management/evolution-/">Evolution  Overview</a></li>
        
        
      </ul>
    </div>
    
    <div class="nav-section">
      <h4>Project Navigation</h4>
      <ul>
        <li><a href="/projects/tenant-management/">Project Overview</a></li>
        <li><a href="/projects/tenant-management/posts/">All Posts</a></li>
        <li><a href="/projects/">All Projects</a></li>
      </ul>
    </div>
  </div>
</div>

<style>
.evolution-post-navigation {
  background: #f8f9fa;
  border: 1px solid #e9ecef;
  border-radius: 8px;
  padding: 1.5rem;
  margin: 2rem 0;
  display: grid;
  grid-template-columns: 1fr 1fr;
  gap: 2rem;
}

.evolution-context {
  background: #e3f2fd;
  border-left: 4px solid #2196f3;
  padding: 1rem 1.5rem;
  border-radius: 0 4px 4px 0;
}

.evolution-context h4 {
  margin: 0 0 0.75rem 0;
  color: #1976d2;
  font-size: 1rem;
  font-weight: 600;
}

.evolution-context p {
  margin: 0.5rem 0;
  font-size: 0.9rem;
  color: #424242;
}

.evolution-context a {
  color: #1976d2;
  text-decoration: none;
  font-weight: 500;
}

.evolution-context a:hover {
  text-decoration: underline;
}

.post-navigation {
  display: flex;
  flex-direction: column;
  gap: 1.5rem;
}

.nav-section h4 {
  margin: 0 0 1rem 0;
  color: #495057;
  font-size: 1rem;
  font-weight: 600;
}

.nav-section ul {
  list-style: none;
  padding: 0;
  margin: 0;
}

.nav-section li {
  margin-bottom: 0.5rem;
}

.nav-section a {
  color: #007bff;
  text-decoration: none;
  font-size: 0.9rem;
  display: block;
  padding: 0.25rem 0;
  transition: color 0.2s ease;
}

.nav-section a:hover {
  color: #0056b3;
  text-decoration: underline;
}

@media (max-width: 768px) {
  .evolution-post-navigation {
    grid-template-columns: 1fr;
    gap: 1.5rem;
  }
}
</style>


## Post Content...

<!-- Evolution Posts Navigation Component -->
<div class="evolution-posts-navigation">
  <div class="posts-header">
    <h4>Posts in </h4>
    <p>Explore other posts in this evolution to understand the complete learning journey.</p>
  </div>
  
  <div class="posts-grid">
    
    
      <div class="post-card">
        <div class="post-meta">
          <span class="post-date">August 30, 2025</span>
          <span class="post-categories">Learning, Architecture</span>
        </div>
        <h5><a href="/learning/architecture/welcome-to-my-blog/">Welcome to My Learning Journey!</a></h5>
        <p class="post-excerpt">Welcome to my corner of the internet where I share my journey of learning and growing in the world of technology and ...</p>
        <div class="post-tags">
          
            <span class="tag">intro</span>
          
            <span class="tag">learning</span>
          
            <span class="tag">architecture</span>
          
        </div>
      </div>
    
      <div class="post-card">
        <div class="post-meta">
          <span class="post-date">August 31, 2025</span>
          <span class="post-categories">Learning, Requirements, Analysis</span>
        </div>
        <h5><a href="/learning/requirements/analysis/tenant-management-requirements/">Landlord-Tenant Management System: Requirements and Objectives</a></h5>
        <p class="post-excerpt">Today I’m documenting the requirements for a Landlord-Tenant Management System - a specialized application designed f...</p>
        <div class="post-tags">
          
            <span class="tag">requirements</span>
          
            <span class="tag">objectives</span>
          
            <span class="tag">user-stories</span>
          
        </div>
      </div>
    
      <div class="post-card">
        <div class="post-meta">
          <span class="post-date">September 01, 2025</span>
          <span class="post-categories">Learning, full-stack-development, Python</span>
        </div>
        <h5><a href="/learning/full-stack-development/python/tenant-management-app-singlefile/">Building a Full-Stack Property Management App: Single File Version</a></h5>
        <p class="post-excerpt">Today I want to share my experience building a comprehensive Tenant Management App - a full-stack web application tha...</p>
        <div class="post-tags">
          
            <span class="tag">flask</span>
          
            <span class="tag">sqlalchemy</span>
          
            <span class="tag">property-management</span>
          
        </div>
      </div>
    
      <div class="post-card">
        <div class="post-meta">
          <span class="post-date">September 15, 2025</span>
          <span class="post-categories">Learning, Architecture, Refactoring</span>
        </div>
        <h5><a href="/learning/architecture/refactoring/tenant-management-modular-monolith/">From Single-File to Modular Monolith: Refactoring the Tenant Management App</a></h5>
        <p class="post-excerpt">Following up on my previous post about the single-file tenant management app, today I want to share the next step - r...</p>
        <div class="post-tags">
          
            <span class="tag">flask</span>
          
            <span class="tag">fastapi</span>
          
            <span class="tag">react</span>
          
        </div>
      </div>
    
      <div class="post-card">
        <div class="post-meta">
          <span class="post-date">September 30, 2025</span>
          <span class="post-categories">Learning, Architecture, system-design</span>
        </div>
        <h5><a href="/learning/architecture/system-design/tenant-management-system-architecture/">Tenant Management System: Modular Monolith Architecture</a></h5>
        <p class="post-excerpt">Building on our modular monolith evolution, today I want to dive deep into the system architecture of the Tenant Mana...</p>
        <div class="post-tags">
          
            <span class="tag">modular-monolith</span>
          
            <span class="tag">system-architecture</span>
          
            <span class="tag">component-architecture</span>
          
        </div>
      </div>
    
      <div class="post-card">
        <div class="post-meta">
          <span class="post-date">October 06, 2025</span>
          <span class="post-categories">Learning, Technology, AI, Development</span>
        </div>
        <h5><a href="/learning/technology/ai/development/cursor-ai-automation-modern-development/">Cursor: AI-Powered Automation in Modern Development</a></h5>
        <p class="post-excerpt">I’ve been absolutely amazed by how Cursor is revolutionizing software development. The ability to describe what you w...</p>
        <div class="post-tags">
          
            <span class="tag">cursor</span>
          
            <span class="tag">ai-ide</span>
          
            <span class="tag">automation</span>
          
        </div>
      </div>
    
      <div class="post-card">
        <div class="post-meta">
          <span class="post-date">October 09, 2025</span>
          <span class="post-categories">Learning, Development, Java</span>
        </div>
        <h5><a href="/learning/development/java/tenant-management-java-transition/">Tenant Management App: Spring Boot and React Transition</a></h5>
        <p class="post-excerpt">Today I kicked off a new chapter for the Tenant Management application by rebuilding it as a React + Spring Boot proj...</p>
        <div class="post-tags">
          
            <span class="tag">tenant-management</span>
          
            <span class="tag">spring-boot</span>
          
            <span class="tag">react</span>
          
        </div>
      </div>
    
      <div class="post-card">
        <div class="post-meta">
          <span class="post-date">October 10, 2025</span>
          <span class="post-categories">Learning, Architecture, System Design</span>
        </div>
        <h5><a href="/learning/architecture/system%20design/tenant-management-java-architecture/">Tenant Management Java Stack: System Architecture</a></h5>
        <p class="post-excerpt">Building on the hands-on migration I shared in Tenant Management App: Spring Boot and React Transition, this post doc...</p>
        <div class="post-tags">
          
            <span class="tag">spring-boot</span>
          
            <span class="tag">react</span>
          
            <span class="tag">system-architecture</span>
          
        </div>
      </div>
    
      <div class="post-card">
        <div class="post-meta">
          <span class="post-date">October 11, 2025</span>
          <span class="post-categories">Learning, Development, Demo</span>
        </div>
        <h5><a href="/learning/development/demo/tenant-management-app-demo-webui/">Tenant Management App Demo (WebUI)</a></h5>
        <p class="post-excerpt">Following the architectural foundation established in Tenant Management Java Stack: System Architecture, this post pr...</p>
        <div class="post-tags">
          
            <span class="tag">tenant-management</span>
          
            <span class="tag">spring-boot</span>
          
            <span class="tag">react</span>
          
        </div>
      </div>
    
      <div class="post-card">
        <div class="post-meta">
          <span class="post-date">November 03, 2025</span>
          <span class="post-categories">Learning, Development, AI Integration</span>
        </div>
        <h5><a href="/learning/development/ai-integration/tenant-management-api-mcp-conversion/">Tenant Management API to MCP Conversion: Bridging Enterprise Apps with AI</a></h5>
        <p class="post-excerpt">Today marks a significant milestone in the Tenant Management evolutionary journey: we’re taking our first step into t...</p>
        <div class="post-tags">
          
            <span class="tag">tenant-management</span>
          
            <span class="tag">mcp</span>
          
            <span class="tag">model-context-protocol</span>
          
        </div>
      </div>
    
      <div class="post-card">
        <div class="post-meta">
          <span class="post-date">November 07, 2025</span>
          <span class="post-categories">Learning, Development, AI Integration, Demo</span>
        </div>
        <h5><a href="/learning/development/ai-integration/tenant-management-mcp-ai-powered-insights/">Unlocking Unlimited Possibilities: AI-Powered On-Demand Insights with Tenant Management MCP</a></h5>
        <p class="post-excerpt">In our previous post, we explored the technical foundation of converting our Tenant Management REST API into an MCP s...</p>
        <div class="post-tags">
          
            <span class="tag">tenant-management</span>
          
            <span class="tag">mcp</span>
          
            <span class="tag">model-context-protocol</span>
          
        </div>
      </div>
    
      <div class="post-card">
        <div class="post-meta">
          <span class="post-date">November 22, 2025</span>
          <span class="post-categories">Learning, AI Integration, Product Strategy</span>
        </div>
        <h5><a href="/learning/ai-integration/product-strategy/roadmap-to-introduce-ai-in-your-applications/">Roadmap to introduce AI in your applications</a></h5>
        <p class="post-excerpt">Most teams want AI in their products, but ripping out familiar workflows to bolt on a chatbot rarely ends well. This ...</p>
        <div class="post-tags">
          
            <span class="tag">ai-roadmap</span>
          
            <span class="tag">chat-interface</span>
          
            <span class="tag">voice</span>
          
        </div>
      </div>
    
  </div>
  
  <div class="evolution-summary">
    <h5>Evolution Summary</h5>
    <p><strong>Total Posts:</strong> 12</p>
    <p><strong>Focus:</strong> </p>
    <p><strong>Technologies:</strong> 
      
    </p>
  </div>
</div>

<style>
.evolution-posts-navigation {
  background: #ffffff;
  border: 1px solid #e9ecef;
  border-radius: 8px;
  padding: 2rem;
  margin: 2rem 0;
}

.posts-header h4 {
  margin: 0 0 0.5rem 0;
  color: #495057;
  font-size: 1.2rem;
  font-weight: 600;
}

.posts-header p {
  margin: 0 0 1.5rem 0;
  color: #6c757d;
  font-size: 0.9rem;
}

.posts-grid {
  display: grid;
  grid-template-columns: repeat(auto-fit, minmax(300px, 1fr));
  gap: 1.5rem;
  margin-bottom: 2rem;
}

.post-card {
  background: #f8f9fa;
  border: 1px solid #e9ecef;
  border-radius: 6px;
  padding: 1.5rem;
  transition: transform 0.2s ease, box-shadow 0.2s ease;
}

.post-card:hover {
  transform: translateY(-2px);
  box-shadow: 0 4px 12px rgba(0, 0, 0, 0.1);
}

.post-meta {
  display: flex;
  justify-content: space-between;
  align-items: center;
  margin-bottom: 0.75rem;
  font-size: 0.8rem;
  color: #6c757d;
}

.post-date {
  font-weight: 500;
}

.post-categories {
  background: #e9ecef;
  padding: 0.25rem 0.5rem;
  border-radius: 4px;
  font-size: 0.75rem;
}

.post-card h5 {
  margin: 0 0 0.75rem 0;
  font-size: 1.1rem;
  font-weight: 600;
}

.post-card h5 a {
  color: #007bff;
  text-decoration: none;
}

.post-card h5 a:hover {
  text-decoration: underline;
}

.post-excerpt {
  margin: 0 0 1rem 0;
  color: #495057;
  font-size: 0.9rem;
  line-height: 1.4;
}

.post-tags {
  display: flex;
  flex-wrap: wrap;
  gap: 0.5rem;
}

.tag {
  background: #007bff;
  color: white;
  padding: 0.25rem 0.5rem;
  border-radius: 4px;
  font-size: 0.75rem;
  font-weight: 500;
}

.evolution-summary {
  background: #e3f2fd;
  border-left: 4px solid #2196f3;
  padding: 1rem 1.5rem;
  border-radius: 0 4px 4px 0;
}

.evolution-summary h5 {
  margin: 0 0 0.75rem 0;
  color: #1976d2;
  font-size: 1rem;
  font-weight: 600;
}

.evolution-summary p {
  margin: 0.5rem 0;
  font-size: 0.9rem;
  color: #424242;
}

@media (max-width: 768px) {
  .posts-grid {
    grid-template-columns: 1fr;
  }
  
  .evolution-posts-navigation {
    padding: 1.5rem;
  }
}
</style>


## Key Learnings

Required Metadata

# Evolutionary Project Fields (REQUIRED)
project: "Tenant Management"
project_type: "evolutionary"
evolution: "Evolution X: [Name]"
evolution_number: X
evolution_focus: "[Focus Area]"

Evolution Context

Project: Tenant Management: An Evolutionary Project

Evolution:

Focus:

Status: 📋 Planned

Evolution Navigation

Project Navigation

` - Evolution context and navigation (includes project branding)

Posts in

Explore other posts in this evolution to understand the complete learning journey.

August 30, 2025 Learning, Architecture
Welcome to My Learning Journey!

Welcome to my corner of the internet where I share my journey of learning and growing in the world of technology and ...

intro learning architecture
August 31, 2025 Learning, Requirements, Analysis
Landlord-Tenant Management System: Requirements and Objectives

Today I’m documenting the requirements for a Landlord-Tenant Management System - a specialized application designed f...

requirements objectives user-stories
September 01, 2025 Learning, full-stack-development, Python
Building a Full-Stack Property Management App: Single File Version

Today I want to share my experience building a comprehensive Tenant Management App - a full-stack web application tha...

flask sqlalchemy property-management
September 15, 2025 Learning, Architecture, Refactoring
From Single-File to Modular Monolith: Refactoring the Tenant Management App

Following up on my previous post about the single-file tenant management app, today I want to share the next step - r...

flask fastapi react
September 30, 2025 Learning, Architecture, system-design
Tenant Management System: Modular Monolith Architecture

Building on our modular monolith evolution, today I want to dive deep into the system architecture of the Tenant Mana...

modular-monolith system-architecture component-architecture
October 06, 2025 Learning, Technology, AI, Development
Cursor: AI-Powered Automation in Modern Development

I’ve been absolutely amazed by how Cursor is revolutionizing software development. The ability to describe what you w...

cursor ai-ide automation
October 09, 2025 Learning, Development, Java
Tenant Management App: Spring Boot and React Transition

Today I kicked off a new chapter for the Tenant Management application by rebuilding it as a React + Spring Boot proj...

tenant-management spring-boot react
October 10, 2025 Learning, Architecture, System Design
Tenant Management Java Stack: System Architecture

Building on the hands-on migration I shared in Tenant Management App: Spring Boot and React Transition, this post doc...

spring-boot react system-architecture
October 11, 2025 Learning, Development, Demo
Tenant Management App Demo (WebUI)

Following the architectural foundation established in Tenant Management Java Stack: System Architecture, this post pr...

tenant-management spring-boot react
November 03, 2025 Learning, Development, AI Integration
Tenant Management API to MCP Conversion: Bridging Enterprise Apps with AI

Today marks a significant milestone in the Tenant Management evolutionary journey: we’re taking our first step into t...

tenant-management mcp model-context-protocol
November 07, 2025 Learning, Development, AI Integration, Demo
Unlocking Unlimited Possibilities: AI-Powered On-Demand Insights with Tenant Management MCP

In our previous post, we explored the technical foundation of converting our Tenant Management REST API into an MCP s...

tenant-management mcp model-context-protocol
November 22, 2025 Learning, AI Integration, Product Strategy
Roadmap to introduce AI in your applications

Most teams want AI in their products, but ripping out familiar workflows to bolt on a chatbot rarely ends well. This ...

ai-roadmap chat-interface voice
Evolution Summary

Total Posts: 12

Focus:

Technologies:

` - Related posts in same evolution

Success Criteria

For New Content

For Updates

Detailed Guidelines

For comprehensive implementation details, refer to:

This framework represents a learning-first approach to software development, where each evolution serves both practical and educational purposes.