frankgpt/README.md

Frank Meadows v6 - Modular AI Assistant Framework

Version: 6.0
Architecture: Skills-Centric Modular System
Philosophy: Pick up and go - zero environment coupling, maximum portability

---

🚀 Quick Start

Option 1: Core Only (Universal Assistant)

Load just the core for a friendly, mentoring assistant with universal capabilities:

Load: v6/Frank.core.agent.md

You get:

• Upbeat, friendly, mentoring personality
• 7 universal personas (Project Manager, Information Architect, Technical Writer, QA Analyst, Editor, Communications Lead, Business Analyst)
• 8 base commands: /quickstart, /create, /review, /refactor, /document, /communicate, /consult, /help

Option 2: Core + Skills (With Reasoning Techniques)

Add advanced reasoning techniques for complex problem-solving:

Load: 
- v6/Frank.core.agent.md
- v6/skills/style.cot.instructions.md (Chain-of-Thought)
- v6/skills/style.tot.instructions.md (Tree-of-Thought)
- v6/skills/style.craft.instructions.md (C.R.A.F.T. framework)

You get: Core + step-by-step reasoning, multi-path exploration, structured prompt creation

Option 3: Core + Specialty (Domain Expert)

Load a specialty module for domain-specific expertise:

Frank for DevOps:

Load:
- v6/Frank.core.agent.md
- v6/specialties/specialty.devops.instructions.md
Commands: /docker, /ansible, /compose, /traefik

Frank for Data Analysis:

Load:
- v6/Frank.core.agent.md
- v6/specialties/specialty.data-analysis.instructions.md
Commands: /analyze, /query, /visualize, /model, /clean

Frank for IT Service Management:

Load:
- v6/Frank.core.agent.md
- v6/specialties/specialty.itil.instructions.md
Commands: /ticket, /rca, /sop, /itil

Option 4: Multi-Specialty Composition

Combine multiple specialties for cross-domain expertise:

Load:
- v6/Frank.core.agent.md
- v6/specialties/specialty.devops.instructions.md
- v6/specialties/specialty.data-analysis.instructions.md
- v6/skills/style.advanced-reasoning.instructions.md

You get: DevOps + Data Science hybrid with advanced reasoning

---

🎯 Available Specialties

DevOps & Site Reliability Engineering

File: specialty.devops.instructions.md
Commands: /docker, /ansible, /compose, /traefik
Expertise: Container orchestration, infrastructure automation, Traefik routing, safe deployment strategies
Use When: Troubleshooting Docker/Compose, writing Ansible playbooks, designing IaC solutions

Prompt Engineering & LLM Optimization

File: specialty.prompt-engineering.instructions.md
Commands: /optimize, /craft, /reason, /evaluate, /patterns
Expertise: LLM optimization, C.R.A.F.T. framework mastery, reasoning technique integration
Use When: Creating production prompts, optimizing existing prompts, integrating CoT/ToT/RAG

Data Analysis & Visualization

File: specialty.data-analysis.instructions.md
Commands: /analyze, /query, /visualize, /model, /clean
Expertise: SQL, Python (Pandas, Matplotlib, Seaborn), statistical modeling, SCoT methodology
Use When: Analyzing datasets, writing queries, creating visualizations, statistical analysis

Modern Endpoint Management

File: specialty.sccm.instructions.md
Commands: /sccm, /intune, /comanage, /package, /troubleshoot
Expertise: SCCM/Intune, Co-management, compliance policies, Win32 app packaging
Use When: Managing endpoints, deploying apps, configuring compliance, migrating to Intune

IT Service Management (ITIL v4)

File: specialty.itil.instructions.md
Commands: /ticket, /rca, /sop, /itil
Expertise: Incident Management, Problem Management, Knowledge Management, ITIL v4 framework
Use When: Resolving incidents, conducting RCAs, creating IT documentation, applying ITIL principles

---

🛠️ VS Code Integration

Method 1: Workspace Instructions (Recommended)

1. Open VS Code Settings (Ctrl+,)
2. Search for "GitHub Copilot Chat: Instructions File"
3. Set to: ${workspaceFolder}/v6/copilot-instructions.md
4. Reload VS Code

The copilot-instructions.md file pre-configures common loading patterns.

Method 2: Manual Loading

In any Copilot Chat, use #file to reference:

@workspace Load #file:v6/Frank.core.agent.md and #file:v6/specialties/specialty.devops.instructions.md

Now help me troubleshoot this Docker Compose issue...

Method 3: Direct File Reference

Copy the content you need directly into your LLM chat of choice.

See: copilot-instructions.md for pre-configured patterns

---

🏗️ Design Principles

1. Portability First

• Zero environment coupling: No hardcoded paths, no system-specific references
• Relative paths only: All cross-references use ../skills/, ../knowledge/ patterns
• "Pick up and go": Copy the v6/ folder to any system and it works

2. Modularity

• Core is self-sufficient: Works alone without dependencies
• Skills enhance: Add reasoning techniques as needed
• Specialties compose: Load multiple domains without conflicts
• Knowledge is reference: Shared examples available to all layers

3. Versioning

• All files tagged: version: 6.0 in frontmatter
• Compatibility tracked: compatibleWith: Frank.core v6+
• Forward compatible: v6+ notation allows future evolution

4. Multi-Specialty Support

• No command conflicts: Each specialty uses domain-specific commands
• Shared skills: Multiple specialties can reference same CoT/ToT/RAG modules
• Conflict resolution: When overlaps exist, documentation explains disambiguation

---

📜 Version History

v6.0 (April 2026)

Major refactor: Monolithic → Modular architecture

Changes:

• ✅ Created 3-layer system (Core → Skills → Specialties)
• ✅ Created 6 specialties (itil, devops, prompt-engineering, data-analysis, sccm, TEMPLATE)
• ✅ Zero environment coupling achieved
• ✅ Multi-specialty composition support
• ✅ Full documentation (ARCHITECTURE.md, README.md, LEGACY.md)

Migration: v4/v5 → v6 (see Migration section above)

v5.0 (2024-2025)

• Single consolidated file: FrankGPT.consolidated-instructions.md
• Monolithic approach with all capabilities included
• IT operations focus with ITIL integration

v4.0 (2023-2024)

• Multiple agent files in agents/ folder
• Separate: Data Analyst, SCCM Tutor, custom agents
• Core instructions in instructions/ folder

---

📄 License

This is a personal AI assistant framework. Use, modify, and extend as needed for your projects.