@pennyfarthing/core 9.2.0 → 9.3.0

package/pennyfarthing-dist/workflows/research/steps-technical/step-04-architectural-patterns.md

@@ -1,228 +0,0 @@
-# Technical Research Step 4: Architectural Patterns
-
-<purpose>
-Conduct architectural patterns analysis identifying system architecture patterns and trade-offs, design principles and best practices, scalability and performance patterns, integration and communication patterns, security architecture patterns, and data and deployment architecture using verified web search data.
-</purpose>
-
-<instructions>
-1. Execute web searches for system architecture patterns, design principles, scalability patterns, and security architecture
-2. Analyze and aggregate architectural findings
-3. Generate architectural patterns analysis content with seven subsections (System Architecture Patterns, Design Principles, Scalability Patterns, Integration Patterns, Security Architecture, Data Architecture, Deployment Architecture)
-4. Include source citations for all architectural data
-5. Write content immediately to document
-6. Present [C] continue option after content generation
-7. Update frontmatter stepsCompleted to [1, 2, 3, 4] before loading next step
-</instructions>
-
-<output>
-Architectural patterns analysis sections containing:
-- System architecture patterns with source citations
-- Design principles and best practices with source citations
-- Scalability and performance patterns with source citations
-- Integration and communication patterns with source citations
-- Security architecture patterns with source citations
-- Data architecture patterns with source citations
-- Deployment and operations architecture with source citations
-- All content appended to research document
-</output>
-
-## MANDATORY EXECUTION RULES (READ FIRST):
-
-- 🛑 NEVER generate content without web search verification
-
-- 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
-- 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
-- ✅ Search the web to verify and supplement your knowledge with current facts
-- 📋 YOU ARE A SYSTEMS ARCHITECT, not content generator
-- 💬 FOCUS on architectural patterns and design decisions
-- 🔍 WEB SEARCH REQUIRED - verify current facts against live sources
-- 📝 WRITE CONTENT IMMEDIATELY TO DOCUMENT
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
-
-## EXECUTION PROTOCOLS:
-
-- 🎯 Show web search analysis before presenting findings
-- ⚠️ Present [C] continue option after architectural patterns content generation
-- 📝 WRITE ARCHITECTURAL PATTERNS ANALYSIS TO DOCUMENT IMMEDIATELY
-- 💾 ONLY proceed when user chooses C (Continue)
-- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4]` before loading next step
-- 🚫 FORBIDDEN to load next step until C is selected
-
-## CONTEXT BOUNDARIES:
-
-- Current document and frontmatter from previous steps are available
-- **Research topic = "{{research_topic}}"** - established from initial discussion
-- **Research goals = "{{research_goals}}"** - established from initial discussion
-- Focus on architectural patterns and design decisions
-- Web search capabilities with source verification are enabled
-
-## YOUR TASK:
-
-Conduct comprehensive architectural patterns analysis with emphasis on design decisions and implementation approaches for {{research_topic}}.
-
-## ARCHITECTURAL PATTERNS SEQUENCE:
-
-### 1. Begin Architectural Patterns Analysis
-
-Start with architectural research approach:
-"Now I'll focus on **architectural patterns and design decisions** for effective architecture approaches for [technology/domain].
-
-**Architectural Patterns Focus:**
-
-- System architecture patterns and their trade-offs
-- Design principles and best practices
-- Scalability and maintainability considerations
-- Integration and communication patterns
-- Security and performance architectural considerations
-
-**Let me search for current architectural patterns and approaches.**"
-
-### 2. Web Search for System Architecture Patterns
-
-Search for current architecture patterns:
-Search the web: "system architecture patterns best practices"
-
-**Architecture focus:**
-
-- Microservices, monolithic, and serverless patterns
-- Event-driven and reactive architectures
-- Domain-driven design patterns
-- Cloud-native and edge architecture patterns
-
-### 3. Web Search for Design Principles
-
-Search for current design principles:
-Search the web: "software design principles patterns"
-
-**Design focus:**
-
-- SOLID principles and their application
-- Clean architecture and hexagonal architecture
-- API design and GraphQL vs REST patterns
-- Database design and data architecture patterns
-
-### 4. Web Search for Scalability Patterns
-
-Search for current scalability approaches:
-Search the web: "scalability architecture patterns"
-
-**Scalability focus:**
-
-- Horizontal vs vertical scaling patterns
-- Load balancing and caching strategies
-- Distributed systems and consensus patterns
-- Performance optimization techniques
-
-### 5. Generate Architectural Patterns Content
-
-Prepare architectural analysis with web search citations:
-
-#### Content Structure:
-
-When saving to document, append these Level 2 and Level 3 sections:
-
-```markdown
-## Architectural Patterns and Design
-
-### System Architecture Patterns
-
-[System architecture patterns analysis with source citations]
-_Source: [URL]_
-
-### Design Principles and Best Practices
-
-[Design principles analysis with source citations]
-_Source: [URL]_
-
-### Scalability and Performance Patterns
-
-[Scalability patterns analysis with source citations]
-_Source: [URL]_
-
-### Integration and Communication Patterns
-
-[Integration patterns analysis with source citations]
-_Source: [URL]_
-
-### Security Architecture Patterns
-
-[Security patterns analysis with source citations]
-_Source: [URL]_
-
-### Data Architecture Patterns
-
-[Data architecture analysis with source citations]
-_Source: [URL]_
-
-### Deployment and Operations Architecture
-
-[Deployment architecture analysis with source citations]
-_Source: [URL]_
-```
-
-### 6. Present Analysis and Continue Option
-
-Show the generated architectural patterns and present continue option:
-"I've completed the **architectural patterns analysis** for effective architecture approaches.
-
-**Key Architectural Findings:**
-
-- System architecture patterns and trade-offs clearly mapped
-- Design principles and best practices thoroughly documented
-- Scalability and performance patterns identified
-- Integration and communication patterns analyzed
-- Security and data architecture considerations captured
-
-**Ready to proceed to implementation research?**
-[C] Continue - Save this to the document and move to implementation research
-
-### 7. Handle Continue Selection
-
-#### If 'C' (Continue):
-
-- Append the final content to the research document
-- Update frontmatter: `stepsCompleted: [1, 2, 3]`
-- Load: `./step-05-implementation-research.md`
-
-## APPEND TO DOCUMENT:
-
-When user selects 'C', append the content directly to the research document using the structure from step 5.
-
-## SUCCESS METRICS:
-
-✅ System architecture patterns identified with current citations
-✅ Design principles clearly documented and analyzed
-✅ Scalability and performance patterns thoroughly mapped
-✅ Integration and communication patterns captured
-✅ Security and data architecture considerations analyzed
-✅ [C] continue option presented and handled correctly
-✅ Content properly appended to document when C selected
-✅ Proper routing to implementation research step
-
-## FAILURE MODES:
-
-❌ Relying solely on training data without web verification for current facts
-
-❌ Missing critical system architecture patterns
-❌ Not analyzing design trade-offs and considerations
-❌ Incomplete scalability or performance patterns analysis
-❌ Not presenting [C] continue option after content generation
-❌ Appending content without user selecting 'C'
-
-❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
-❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
-❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
-
-## ARCHITECTURAL RESEARCH PROTOCOLS:
-
-- Search for architecture documentation and pattern catalogs
-- Use architectural conference proceedings and case studies
-- Research successful system architectures and their evolution
-- Note architectural decision records (ADRs) and rationales
-- Research architecture assessment and evaluation frameworks
-
-## NEXT STEP:
-
-After user selects 'C' and content is saved to document, load `./step-05-implementation-research.md` to focus on implementation approaches and technology adoption.
-
-Remember: Always emphasize current architectural data and rigorous source verification!

package/pennyfarthing-dist/workflows/research/steps-technical/step-05-implementation-research.md

@@ -1,267 +0,0 @@
-# Technical Research Step 5: Implementation Research
-
-<purpose>
-Conduct comprehensive implementation research identifying technology adoption strategies, development workflows and tooling, testing and quality assurance practices, deployment and operations practices, team organization and skills, cost optimization, and risk assessment using verified web search data.
-</purpose>
-
-<instructions>
-1. Execute web searches for technology adoption strategies, development workflows, testing practices, and operational excellence
-2. Analyze and aggregate implementation findings
-3. Generate implementation research analysis content with seven subsections (Technology Adoption, Development Workflows, Testing and QA, Deployment Practices, Team Organization, Cost Optimization, Risk Assessment)
-4. Add Technical Research Recommendations section with three subsections (Implementation Roadmap, Technology Stack Recommendations, Success Metrics)
-5. Include source citations for all implementation data
-6. Write content immediately to document
-7. Present [C] complete option after content generation (final step for technical workflow)
-8. Update frontmatter stepsCompleted to [1, 2, 3, 4, 5] before completing workflow
-</instructions>
-
-<output>
-Implementation research analysis sections containing:
-- Technology adoption strategies with source citations
-- Development workflows and tooling with source citations
-- Testing and quality assurance practices with source citations
-- Deployment and operations practices with source citations
-- Team organization and skill requirements with source citations
-- Cost optimization and resource management with source citations
-- Risk assessment and mitigation with source citations
-- Technical research recommendations for implementation roadmap, technology stack, and success metrics
-- All content appended to research document
-</output>
-
-## MANDATORY EXECUTION RULES (READ FIRST):
-
-- 🛑 NEVER generate content without web search verification
-
-- 📖 CRITICAL: ALWAYS read the complete step file before taking any action - partial understanding leads to incomplete decisions
-- 🔄 CRITICAL: When loading next step with 'C', ensure the entire file is read and understood before proceeding
-- ✅ Search the web to verify and supplement your knowledge with current facts
-- 📋 YOU ARE AN IMPLEMENTATION ENGINEER, not content generator
-- 💬 FOCUS on implementation approaches and technology adoption
-- 🔍 WEB SEARCH REQUIRED - verify current facts against live sources
-- ✅ YOU MUST ALWAYS SPEAK OUTPUT In your Agent communication style with the config `{communication_language}`
-
-## EXECUTION PROTOCOLS:
-
-- 🎯 Show web search analysis before presenting findings
-- ⚠️ Present [C] complete option after implementation research content generation
-- 💾 ONLY save when user chooses C (Complete)
-- 📖 Update frontmatter `stepsCompleted: [1, 2, 3, 4]` before completing workflow
-- 🚫 FORBIDDEN to complete workflow until C is selected
-
-## CONTEXT BOUNDARIES:
-
-- Current document and frontmatter from previous steps are available
-- Focus on implementation approaches and technology adoption strategies
-- Web search capabilities with source verification are enabled
-- This is the final step in the technical research workflow
-
-## YOUR TASK:
-
-Conduct comprehensive implementation research with emphasis on practical implementation approaches and technology adoption.
-
-## IMPLEMENTATION RESEARCH SEQUENCE:
-
-### 1. Begin Implementation Research
-
-Start with implementation research approach:
-"Now I'll complete our technical research with **implementation approaches and technology adoption** analysis.
-
-**Implementation Research Focus:**
-
-- Technology adoption strategies and migration patterns
-- Development workflows and tooling ecosystems
-- Testing, deployment, and operational practices
-- Team organization and skill requirements
-- Cost optimization and resource management
-
-**Let me search for current implementation and adoption strategies.**"
-
-### 2. Web Search for Technology Adoption
-
-Search for current adoption strategies:
-Search the web: "technology adoption strategies migration"
-
-**Adoption focus:**
-
-- Technology migration patterns and approaches
-- Gradual adoption vs big bang strategies
-- Legacy system modernization approaches
-- Vendor evaluation and selection criteria
-
-### 3. Web Search for Development Workflows
-
-Search for current development practices:
-Search the web: "software development workflows tooling"
-
-**Workflow focus:**
-
-- CI/CD pipelines and automation tools
-- Code quality and review processes
-- Testing strategies and frameworks
-- Collaboration and communication tools
-
-### 4. Web Search for Operational Excellence
-
-Search for current operational practices:
-Search the web: "DevOps operations best practices"
-
-**Operations focus:**
-
-- Monitoring and observability practices
-- Incident response and disaster recovery
-- Infrastructure as code and automation
-- Security operations and compliance automation
-
-### 5. Generate Implementation Research Content
-
-Prepare implementation analysis with web search citations:
-
-#### Content Structure:
-
-When saving to document, append these Level 2 and Level 3 sections:
-
-```markdown
-## Implementation Approaches and Technology Adoption
-
-### Technology Adoption Strategies
-
-[Technology adoption analysis with source citations]
-_Source: [URL]_
-
-### Development Workflows and Tooling
-
-[Development workflows analysis with source citations]
-_Source: [URL]_
-
-### Testing and Quality Assurance
-
-[Testing approaches analysis with source citations]
-_Source: [URL]_
-
-### Deployment and Operations Practices
-
-[Deployment practices analysis with source citations]
-_Source: [URL]_
-
-### Team Organization and Skills
-
-[Team organization analysis with source citations]
-_Source: [URL]_
-
-### Cost Optimization and Resource Management
-
-[Cost optimization analysis with source citations]
-_Source: [URL]_
-
-### Risk Assessment and Mitigation
-
-[Risk mitigation analysis with source citations]
-_Source: [URL]_
-
-## Technical Research Recommendations
-
-### Implementation Roadmap
-
-[Implementation roadmap recommendations]
-
-### Technology Stack Recommendations
-
-[Technology stack suggestions]
-
-### Skill Development Requirements
-
-[Skill development recommendations]
-
-### Success Metrics and KPIs
-
-[Success measurement framework]
-```
-
-### 6. Present Analysis and Complete Option
-
-Show the generated implementation research and present complete option:
-"I've completed the **implementation research and technology adoption** analysis, finalizing our comprehensive technical research.
-
-**Implementation Highlights:**
-
-- Technology adoption strategies and migration patterns documented
-- Development workflows and tooling ecosystems analyzed
-- Testing, deployment, and operational practices mapped
-- Team organization and skill requirements identified
-- Cost optimization and resource management strategies provided
-
-**This completes our technical research covering:**
-
-- Technical overview and landscape analysis
-- Architectural patterns and design decisions
-- Implementation approaches and technology adoption
-- Practical recommendations and implementation roadmap
-
-**Ready to complete the technical research report?**
-[C] Complete Research - Save final document and conclude
-
-### 7. Handle Complete Selection
-
-#### If 'C' (Complete Research):
-
-- Append the final content to the research document
-- Update frontmatter: `stepsCompleted: [1, 2, 3, 4]`
-- Complete the technical research workflow
-
-## APPEND TO DOCUMENT:
-
-When user selects 'C', append the content directly to the research document using the structure from step 5.
-
-## SUCCESS METRICS:
-
-✅ Technology adoption strategies identified with current citations
-✅ Development workflows and tooling thoroughly analyzed
-✅ Testing and deployment practices clearly documented
-✅ Team organization and skill requirements mapped
-✅ Cost optimization and risk mitigation strategies provided
-✅ [C] complete option presented and handled correctly
-✅ Content properly appended to document when C selected
-✅ Technical research workflow completed successfully
-
-## FAILURE MODES:
-
-❌ Relying solely on training data without web verification for current facts
-
-❌ Missing critical technology adoption strategies
-❌ Not providing practical implementation guidance
-❌ Incomplete development workflows or operational practices analysis
-❌ Not presenting completion option for research workflow
-❌ Appending content without user selecting 'C'
-
-❌ **CRITICAL**: Reading only partial step file - leads to incomplete understanding and poor decisions
-❌ **CRITICAL**: Proceeding with 'C' without fully reading and understanding the next step file
-❌ **CRITICAL**: Making decisions without complete understanding of step requirements and protocols
-
-## IMPLEMENTATION RESEARCH PROTOCOLS:
-
-- Search for implementation case studies and success stories
-- Research technology migration patterns and lessons learned
-- Identify common implementation challenges and solutions
-- Research development tooling ecosystem evaluations
-- Analyze operational excellence frameworks and maturity models
-
-## TECHNICAL RESEARCH WORKFLOW COMPLETION:
-
-When 'C' is selected:
-
-- All technical research steps completed
-- Comprehensive technical research document generated
-- All sections appended with source citations
-- Technical research workflow status updated
-- Final implementation recommendations provided to user
-
-## NEXT STEPS:
-
-Technical research workflow complete. User may:
-
-- Use technical research to inform architecture decisions
-- Conduct additional research on specific technologies
-- Combine technical research with other research types for comprehensive insights
-- Move forward with implementation based on technical insights
-
-Congratulations on completing comprehensive technical research! 🎉