10 Commits

Author SHA1 Message Date
06a11f4cfa docs: move design principles to a separate file for better organization 2026-04-19 17:16:26 -04:00
f596f41a01 docs(structure): split README into focused documentation files
- Extract troubleshooting guide to TROUBLESHOOTING.md
- Move usage examples to USAGE_EXAMPLES.md for better discoverability
- Add custom specialty creation guide to CONTRIBUTIONS.md
- Create semantic commit message generator prompt in prompts/
- Streamline README.md by removing 200+ lines of content now in dedicated files
- Improve documentation navigation with clearer separation of concerns
2026-04-19 16:50:58 -04:00
6c8955fe49 docs: add CONTRIBUTIONS.md and update README.md for clarity and guidance 2026-04-19 16:30:42 -04:00
50e7e1de6e Loaded v6 into .github to use in repo 2026-04-19 15:26:13 -04:00
4bbc54c636 docs(readme): update file count, line count, and version history accuracy
Corrections:
- File count: 22 → 23 files (actual count verified)
- Line count: ~6,200 → ~5,600 lines (verified with wc -l)
- Version history: Listed all 6 specialties explicitly (itil, devops, prompt-engineering, data-analysis, sccm, TEMPLATE)
- Added LEGACY.md to full documentation list

All metrics now reflect actual v6 system state.
2026-04-19 14:38:05 -04:00
1b87328166 docs(architecture): update ARCHITECTURE.md to reflect completed Phase 3 and Phase 5
Updated all Phase 3 and Phase 5 references to show completion:

Changes Made:
-  Removed '[Phase 3]' markers from all 5 specialties (now marked )
-  Changed 'Will add' to 'Provides' for specialty descriptions
-  Updated commands lists to reflect actual implementation
-  Updated roadmap: Phases 1-5 now marked complete
-  Updated usage patterns to show DevOps as available
-  Updated migration guide with actual specialty file names
-  Updated troubleshooting section to remove 'not yet implemented' notes
-  Updated Support section with links to README.md and LEGACY.md
-  Removed outdated Phase 3/Phase 5 TODO checklists

Reality Alignment:
- All 6 specialties complete (devops, prompt-engineering, data-analysis, sccm, itil, TEMPLATE)
- Phase 5 documentation complete (README.md, LEGACY.md)
- Custom specialty template available and documented
- Multi-specialty composition fully functional

Architecture now accurately reflects the completed v6 system.
2026-04-19 14:27:12 -04:00
f009b01af9 docs(v6): complete Phase 5 with README and legacy file documentation
Phase 5 Complete: Final Documentation and Legacy Mapping

Documentation Created:
- v6/README.md: Comprehensive 400+ line quick start guide
  * Quick start examples (4 loading options)
  * Architecture overview with 3-layer diagram
  * All 6 specialties documented with commands and use cases
  * VS Code integration methods (3 options)
  * Usage examples for common scenarios
  * Custom specialty creation guide
  * Migration guide from v4/v5
  * Troubleshooting section
  * Version history and roadmap

- LEGACY.md: Legacy file mapping and recommendations
  * Organized vs superseded vs deprecated files
  * v4/v5 to v6 migration matrix
  * Archive cleanup options (minimal, archive folder, aggressive)
  * Decision: Keep prompts/ at root (templates, not core)
  * Preservation rationale for each legacy artifact

Frank v6 Now Complete:
-  23 files in v6/ structure (1 core, 7 skills, 6 specialties, 6 knowledge, 3 docs)
-  ~6,800 lines of modular, portable content
-  Zero environment coupling
-  Multi-specialty composition support
-  Comprehensive documentation (README, ARCHITECTURE, copilot-instructions)
-  Custom specialty template for extensibility
-  All phases 1-5 complete

Design Achievements:
- Portability: Pick up v6/ folder and go - works anywhere
- Modularity: Load only what you need (core, skills, specialties)
- Composition: Combine multiple specialties seamlessly
- Documentation: 1000+ lines across README + ARCHITECTURE
- Extensibility: Template enables custom domain additions

Ref: Session plan completed in /memories/session/plan.md
2026-04-19 14:22:44 -04:00
fd5ec2923b feat(specialties): add Phase 3 specialty modules (devops, prompt-engineering, data-analysis, sccm, template)
Complete Frank v6 specialty system with 5 new domain-expert modules:

Specialty Modules Created:
- specialty.devops.instructions.md: Docker, Compose, Swarm, Traefik, Ansible, IaC automation
- specialty.prompt-engineering.instructions.md: LLM optimization, CRAFT integration, reasoning techniques
- specialty.data-analysis.instructions.md: SQL, Python/Pandas, visualization, SCoT methodology
- specialty.sccm.instructions.md: Modern endpoint management, Intune, Co-management strategies
- specialty.TEMPLATE.instructions.md: Pattern for creating custom specialties

Each Specialty Includes:
- Domain-specific personas and expertise
- Custom slash commands (e.g., /docker, /ansible, /craft, /analyze, /sccm)
- Step-by-step workflows with examples
- Integration with v6 skills (CoT, ToT, RAG, CRAFT)
- Error handling protocols
- References to knowledge base

Architecture:
- All specialties compatible with Frank.core v6+
- Load independently or in combination (multi-specialty composition)
- Zero environment coupling (portable across systems)
- Relative path references (../skills/, ../knowledge/)

Total v6 Structure:
- 1 core agent (Frank.core.agent.md)
- 7 skills (reasoning techniques)
- 6 specialties (5 domains + 1 template)
- 6 knowledge examples
- Full documentation (ARCHITECTURE.md, copilot-instructions.md)

Ref: Session plan Phase 3 in /memories/session/plan.md
Next: Phase 5 (README, legacy cleanup)
2026-04-19 14:17:56 -04:00
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
11a2f32e30 Added current working "FrankGPT" files 2026-04-12 18:54:58 -04:00