frankgpt/v6/copilot-instructions.md
nathan b5ea5b175c feat(architecture): introduce Frank v6 modular skills-centric system
Phase 1-4 Complete: Setup, Core Extraction, ITIL Specialty, Documentation

- Created v6/ folder with 3-layer architecture (core + skills + specialties)
- Extracted Frank.core.agent.md with universal personas and base commands
- Copied 7 skill modules (CRAFT, CoT, ToT, RAG, Markdown, Mermaid, Advanced Reasoning)
- Created specialty.itil.instructions.md for IT Service Management (ITIL v4)
- Added comprehensive ARCHITECTURE.md with usage patterns and migration guide
- Created v6/copilot-instructions.md for VS Code integration
- Organized legacy DOCX files into _Frank_/docx/ subdirectory
- Updated all cross-references to use v6 relative paths

Design Principles:
- Portability first: zero environment-specific paths
- Modular composition: load only what you need
- Multi-specialty support: combine domain experts
- Version compatibility: all files tagged v6.0

Ref: Session plan in /memories/session/plan.md
Next: Phase 3 (remaining specialties: devops, prompt-engineering, data-analysis, sccm)
2026-04-19 14:07:29 -04:00

6.6 KiB

Frank v6 - GitHub Copilot Instructions

Version: 6.0
Last Updated: April 19, 2026

Quick Start

Frank v6 is a modular AI assistant built on three layers:

  1. Frank.core - Your upbeat, friendly mentor (always loaded)
  2. Skills - Reasoning techniques (CoT, ToT, RAG, CRAFT, Markdown, Mermaid)
  3. Specialties - Domain expertise (load as needed)

Using Frank in VS Code

Core Only (General Assistant)

For general content creation, analysis, and mentoring:

Load: v6/Frank.core.agent.md

Frank will help with:

  • Content creation (prompts, documentation, guides)
  • Reviews and analysis
  • Business consulting
  • Strategic communications

For best results, include the skills Frank uses for reasoning:

Load: v6/Frank.core.agent.md
Include: v6/skills/style.craft.instructions.md
Include: v6/skills/style.advanced-reasoning.instructions.md
Include: v6/skills/style.markdown.instructions.md

This gives Frank access to:

  • C.R.A.F.T. framework for prompt engineering
  • Advanced reasoning techniques (CoT, ToT, RAG)
  • Markdown formatting standards

With Specialties (Domain Expert)

Add specialty modules for specific domains:

Frank for IT Operations:

Load: v6/Frank.core.agent.md
Include: v6/skills/style.craft.instructions.md
Include: v6/specialties/specialty.itil.instructions.md

Frank for DevOps:

Load: v6/Frank.core.agent.md
Include: v6/skills/style.craft.instructions.md
Include: v6/specialties/specialty.devops.instructions.md

Frank for Prompt Engineering:

Load: v6/Frank.core.agent.md
Include: v6/skills/style.craft.instructions.md
Include: v6/skills/style.cot.instructions.md
Include: v6/skills/style.tot.instructions.md
Include: v6/specialties/specialty.prompt-engineering.instructions.md

Frank for Data Analysis:

Load: v6/Frank.core.agent.md
Include: v6/skills/style.markdown.instructions.md
Include: v6/specialties/specialty.data-analysis.instructions.md

Multi-Specialty Composition

You can load multiple specialties simultaneously:

Load: v6/Frank.core.agent.md
Include: v6/skills/style.craft.instructions.md
Include: v6/specialties/specialty.devops.instructions.md
Include: v6/specialties/specialty.itil.instructions.md

This gives you a Frank with both DevOps AND IT service management expertise.

Available Specialties (v6)

Specialty File What You Get
IT Operations specialty.itil.instructions.md ITIL v4, incident/problem/knowledge management, /ticket, /rca, /sop commands
DevOps specialty.devops.instructions.md Docker, Compose, Ansible, IaC, /docker, /ansible commands (Phase 3)
Prompt Engineering specialty.prompt-engineering.instructions.md Advanced prompting, optimization, /optimize command (Phase 3)
Data Analysis specialty.data-analysis.instructions.md SQL, Python, statistical modeling, /analyze command (Phase 3)
SCCM/Intune specialty.sccm.instructions.md Endpoint management, co-management, modern management (Phase 3)

Note: Specialties marked (Phase 3) are planned but not yet created. Check v6/ARCHITECTURE.md for status.

Available Skills (v6)

Skill File Purpose
C.R.A.F.T. style.craft.instructions.md Structured prompt creation framework
Advanced Reasoning style.advanced-reasoning.instructions.md Overview of reasoning techniques
Chain-of-Thought style.cot.instructions.md Step-by-step reasoning prompting
Tree-of-Thought style.tot.instructions.md Multi-path reasoning with backtracking
RAG style.rag.instructions.md Retrieval-augmented generation
Markdown style.markdown.instructions.md Formatting and style standards
Mermaid style.mermaid.instructions.md Diagram creation in Markdown

Commands Reference

Core Commands (Always Available)

  • /quickstart - Rapid creation from one-sentence goal
  • /create - Guided documentation creation
  • /review - Evaluate prompts or documents
  • /refactor - Restructure and optimize content
  • /document - Generate comprehensive docs
  • /communicate [Audience] [Channel] [Subject] - Recast for audiences
  • /consult [Question] - Business strategy insights
  • /help - Learn about Frank's capabilities

Specialty Commands (When Loaded)

With specialty.itil:

  • /ticket - Incident management workflow
  • /rca - Root cause analysis
  • /sop - Create IT documentation
  • /itil - Explain ITIL v4 principles

With specialty.devops (Phase 3):

  • /docker - Docker/Compose troubleshooting
  • /ansible - Ansible/IaC assistance

With specialty.prompt-engineering (Phase 3):

  • /optimize - Advanced prompt optimization

With specialty.data-analysis (Phase 3):

  • /analyze - Data analysis workflow

Customization

Create Your Own Specialty

  1. Copy v6/specialties/specialty.TEMPLATE.instructions.md (Phase 3)
  2. Fill in your domain expertise
  3. Define personas, commands, and workflows
  4. Save as specialty.{yourDomain}.instructions.md
  5. Include in your Copilot configuration

See v6/ARCHITECTURE.md for detailed guidance.

Portability

Frank v6 is designed to be portable - just copy the v6/ folder:

your-project/
├── v6/               ← Copy this entire folder
│   ├── Frank.core.agent.md
│   ├── skills/
│   ├── specialties/
│   └── knowledge/
└── .github/
    └── copilot-instructions.md  ← Point to v6/

Troubleshooting

Frank doesn't have a specialty capability I expected:

  • Check which specialty files are included in your configuration
  • Verify the specialty file exists in v6/specialties/
  • Some specialties are still in development (check ARCHITECTURE.md)

Commands aren't working:

  • Ensure you've loaded the specialty that provides that command
  • Check command syntax (e.g., /communicate needs parameters)
  • Try /help to see what's currently available

Cross-references or links broken:

  • Ensure you've copied the complete v6/ folder structure
  • Check that relative paths point to correct locations
  • Skills and knowledge folders must exist at v6/skills/ and v6/knowledge/

More Information


Welcome to Frank v6! Ready to create, analyze, and collaborate! 🚀