merging stuff from my joplin notes

ReleasedPrompts/LLM Scaffolding/COO Work/Doc prompt eng/Complete Workflow.md

@@ -0,0 +1,183 @@
+# Complete Workflow
+Version: 1.0 (2025-03-25)
+
+## PURPOSE
+This workflow provides a comprehensive overview of the two-step document prompt engineering process, from initial requirement gathering through implementation and maintenance.
+
+## TWO-STEP PROCESS OVERVIEW
+
+The document prompt engineering process consists of two primary phases:
+
+1. **Initial Prompt Engineering**: Focused on requirements gathering, analysis, and initial prompt creation
+2. **Prompt Review**: Focused on evaluation, refinement, and optimization
+
+This separation ensures thorough exploration followed by targeted improvement.
+
+## DETAILED WORKFLOW
+
+### PHASE 1: PREPARATION
+
+#### 1.1 Project Initialization
+- Define document type and purpose
+- Gather sample documents
+- Identify stakeholders and subject matter experts
+- Establish success criteria
+- Create project continuity document
+
+#### 1.2 Requirements Analysis
+- Analyze document structure and components
+- Identify regulatory or compliance requirements
+- Document user needs and pain points
+- Map content relationships and dependencies
+- Define terminology standards
+
+#### 1.3 Environment Setup
+- Create project folder structure
+- Initialize artifact templates
+- Establish version control approach
+- Set up testing methodology
+- Prepare continuity management system
+
+### PHASE 2: INITIAL PROMPT ENGINEERING
+
+#### 2.1 Exploratory Interview
+- Conduct structured interview with Claude
+- Focus on one question at a time
+- Document all insights and recommendations
+- Utilize extended thinking mode for complex topics
+- Update continuity document with progress
+
+#### 2.2 Document Analysis
+- Analyze structural patterns
+- Identify critical components
+- Document domain-specific terminology
+- Map content relationships
+- Define document lifecycle
+
+#### 2.3 Prompt Architecture Development
+- Design context provision strategy
+- Develop instruction components
+- Create format specification
+- Draft example blocks
+- Establish guardrails and constraints
+
+#### 2.4 Initial Prompt Creation
+- Draft complete prompt using structured template
+- Incorporate all key elements identified
+- Ensure proper formatting and organization
+- Document assumptions and design decisions
+- Create Claude-optimized version if needed
+
+#### 2.5 Preliminary Testing
+- Test with sample scenarios
+- Document initial performance
+- Identify obvious improvement areas
+- Prepare for review session
+- Update continuity document
+
+### PHASE 3: PROMPT REVIEW
+
+#### 3.1 Performance Assessment
+- Evaluate against success criteria
+- Analyze output quality and consistency
+- Identify strengths and weaknesses
+- Document performance metrics
+- Prioritize improvement areas
+
+#### 3.2 Structural Analysis
+- Evaluate context effectiveness
+- Assess instruction clarity
+- Review format adherence
+- Analyze example utility
+- Document structural insights
+
+#### 3.3 Content Quality Evaluation
+- Assess factual accuracy
+- Evaluate completeness
+- Review logical flow
+- Check tone appropriateness
+- Verify terminology consistency
+
+#### 3.4 Optimization Strategy
+- Develop targeted improvements
+- Create experimental variations
+- Design comparison methodology
+- Define success indicators
+- Document optimization approach
+
+#### 3.5 Prompt Revision
+- Implement prioritized improvements
+- Create revised prompt draft
+- Document changes and rationale
+- Update related artifacts
+- Prepare for validation testing
+
+#### 3.6 Validation Testing
+- Test with predefined scenarios
+- Compare to original performance
+- Document improvements
+- Identify any new issues
+- Make final adjustments
+
+### PHASE 4: IMPLEMENTATION
+
+#### 4.1 Finalization
+- Make go/no-go decision
+- Finalize prompt documentation
+- Create implementation guide
+- Establish monitoring plan
+- Update all project artifacts
+
+#### 4.2 Deployment
+- Implement in target environment
+- Provide user training if needed
+- Monitor initial performance
+- Gather feedback
+- Document deployment process
+
+#### 4.3 Performance Monitoring
+- Track key performance indicators
+- Collect user feedback
+- Document edge cases
+- Identify optimization opportunities
+- Schedule periodic reviews
+
+### PHASE 5: MAINTENANCE
+
+#### 5.1 Periodic Review
+- Evaluate ongoing performance
+- Identify changing requirements
+- Update prompt as needed
+- Document review findings
+- Schedule next review
+
+#### 5.2 Continuous Improvement
+- Implement minor optimizations
+- Test variations
+- Document performance changes
+- Update related artifacts
+- Maintain version history
+
+## ROLE-SPECIFIC WORKFLOWS
+
+### FOR PROMPT ENGINEERS
+
+1. Lead initial requirements gathering
+2. Conduct exploratory interviews with Claude
+3. Draft initial prompt architecture
+4. Create example blocks
+5. Document design decisions
+6. Participate in review sessions
+7. Implement technical optimizations
+8. Update technical documentation
+
+### FOR SUBJECT MATTER EXPERTS
+
+1. Provide domain knowledge
+2. Review document components for accuracy
+3. Validate terminology usage
+4. Assess output quality
+5. Identify domain-specific edge cases
+6. Help prioritize improvements
+7. Review final documentation
+8. Support