PlantUML Ent Kit

Entity Modeling Toolkit + Reference Architecture Catalogue + Agentic CI/CD

Live Site: keugenek.github.io/plantuml-ent-kit

---

🚀 Quick Links

Section	Description
Catalogue	Reference architectures & patterns
Git Flows	Agentic CI/CD workflow documentation
AGENTS.md	Instructions for AI agents
Skills	Reusable agent skills

---

🤖 Agentic Workflows

This repository demonstrates fully agentic CI/CD:

Git Flow Tiers

Flow	Automation	Best For
Simplified GitFlow	20%	Small teams, learning git
Agentic Team Flow	70%	Teams wanting oversight
Full Agentic Flow	95%	Mature codebases

DORA Metrics (This Repo)

Metric	Before	After
Deploy Frequency	Weekly	Hourly
Lead Time	Days	Minutes
MTTR	Hours	Instant

Workflow Files

• .github/workflows/agentic-review.yml - AI code review on PRs
• .github/workflows/agentic-deploy.yml - Auto-deploy with self-healing
• .github/workflows/plantuml.yml - Auto-render diagrams
• .github/workflows/pages.yml - Deploy to GitHub Pages

---

📚 Reference Architecture Catalogue

Entity Models

Model	Description
CRM System	Customer Relationship Management
E-Commerce	Online store architecture
LMS	Learning Management System
CMS	Content Management System

AI/LLM Patterns

Pattern	Description
LLM Tool Call	Function calling pattern
Context Management	RAG, compaction, sliding windows
MCP Architecture	Model Context Protocol
Skills Pattern	Modular agent capabilities
Agent Orchestration	Multi-agent coordination
Tool Chaining	Sequential tool execution
Agentic RAG	AI-driven retrieval

Git Flow Diagrams

Diagram	PlantUML
Flow Comparison	Traditional vs Agentic
Flow Evolution	Three-tier progression
DORA Comparison	Before/After metrics
Paradigm Shifts	Processes, Tools, Teams

---

🛠️ Skills

Reusable agent skills for common tasks:

PlantUML Rendering

# Trigger: Push .puml files
# Action: Auto-render to PNG, commit back
# Location: .github/workflows/plantuml.yml

Agentic Code Review

# Trigger: PR opened
# Action: Analyze diff, post review, auto-merge if eligible
# Location: .github/workflows/agentic-review.yml

Self-Healing Deploy

# Trigger: Push to main
# Action: Deploy, auto-rollback on failure, create incident
# Location: .github/workflows/agentic-deploy.yml

---

🏗️ Setup

VS Code + PlantUML

1. Install VS Code
2. Install PlantUML extension
3. Install Graphviz (optional, for local rendering)

For AI Agents

See AGENTS.md for:

• How to add new patterns
• Commit conventions
• Auto-rendering workflow

---

📖 PlantUML Quick Start

@startuml
entity "Author" as author {
  +AuthorID: int
  FirstName: string
  LastName: string
}

entity "Book" as book {
  +BookID: int
  Title: string
  PublishedDate: date
}

author -- book : writes
@enduml

---

🔗 External Resources

• PlantUML Official
• PlantUML Online Server
• DORA Metrics
• GitHub Actions

---

📝 Contributing

1. Fork the repo
2. Create a feature branch
3. Add your pattern/diagram
4. Open a PR (AI will review!)

---

📄 License

MIT License - see LICENSE

---

📬 Contact

Open an issue for questions or feedback.