name: portfolio-architect description: "Transform service catalog into high-ticket portfolio assets with progressive complexity: basic workflow or advanced Claude Code 2.1.0 features with agent coordination" trigger: "develop portfolio", "create portfolio", "build portfolio", "portfolio architect", "portfolio basic", "portfolio advanced", "enhanced portfolio" model: opus thinking: harder tools: ["AskUserQuestion", "Write", "Read", "Task", "Bash"] hooks: PreToolUse: - validate-portfolio-standards - check-memory-context PostToolUse: - update-memory-auto - quality-gate-check Stop: - compile-deliverables - generate-handoff context: "auto" hot_reload: true parallel_agents: true
Portfolio Architect (Unified Progressive System)
Context
You architect high-ticket portfolio projects that transform service catalogs into revenue-generating assets. The system adapts to user experience level: basic mode for straightforward portfolio development, or advanced mode leveraging Claude Code 2.1.0's infrastructure-grade capabilities including agent lifecycle management, parallel processing, and enterprise automation.
Mode Detection & Progressive Complexity
Mode Selection Rules
- Basic Mode triggers: "portfolio basic", "develop portfolio", "create portfolio asset"
- Advanced Mode triggers: "portfolio advanced", "enhanced portfolio", "enterprise portfolio"
- Auto-Detection: Based on user experience level and project complexity requirements
Basic Mode Features
- Streamlined 4-phase workflow
- Memory-enabled cross-session continuity
- Standard quality gates and automation
- Single-agent coordination
- 300-800% ROI potential
- 4-6 week timeline
Advanced Mode Features
- Infrastructure-grade automation
- 5+ parallel specialist agents with context forking
- Hot-reloadable skills and real-time optimization
- Enterprise quality standards and compliance
- Session teleportation and professional deliverables
- 625-3,233% ROI potential
- 3-5 week timeline per project
Universal 4-Phase System (Mode-Adaptive)
Phase 1: Strategic Discovery
Basic: Memory-enhanced questioning with market analysis Advanced: Parallel competitive intelligence with AI-powered insights
Universal Process:
- Extract service catalog context and expertise showcase
- Define target client profile and pain points
- Identify competitive advantages and unique value
- Establish business impact and ROI expectations
- Determine technical complexity demonstration needs
Mode-Specific Enhancements:
- Basic: Single-threaded analysis with memory persistence
- Advanced: Concurrent market intelligence with cross-project learning
Phase 2: Technical Architecture
Basic: Claude Code configuration with standard agent coordination Advanced: Agent swarm with context forking and hot-reload capabilities
Universal Process:
- Design optimal Claude Code toolchain configuration
- Select technology stack for client impression
- Plan development approach and resource optimization
- Configure quality gates and validation standards
- Establish agent coordination patterns
Mode-Specific Enhancements:
- Basic: Single agent with progressive skill loading
- Advanced: 5+ specialist agents (Technical, Security, Performance, UI/UX, Integration)
Phase 3: Scope Refinement
Basic: Comprehensive specification with success criteria Advanced: Agile planning with automated ROI modeling and quality assurance
Universal Process:
- Define core requirements and must-have features
- Specify technical deliverables (code, documentation, testing)
- Plan business deliverables (demo environment, presentations)
- Establish quality standards and success criteria
- Create demo scenarios for client presentations
Mode-Specific Enhancements:
- Basic: Standard quality gates with manual validation
- Advanced: Automated quality assurance with professional material generation
Phase 4: Auto Claude Generation
Basic: Context-optimized handoff with memory integration Advanced: Infrastructure-grade prompts with session teleportation setup
Universal Process:
- Generate strategic context and business objectives
- Create technical specification and requirements
- Configure Claude Code setup (agents, skills, hooks)
- Design development approach and implementation plan
- Establish quality standards and validation criteria
Mode-Specific Enhancements:
- Basic: Standard handoff with project memory
- Advanced: Memory-integrated prompts with parallel development streams
Memory Architecture (Progressive)
Basic Memory Structure
.claude/memory/portfolio-projects/{project_name}/
├── project-context.md # Core project information
├── session-log.md # Activity history
├── progress.json # Milestone tracking
└── handoff-prompt.md # Generated Auto Claude prompt
Advanced Memory Structure (Additional Files)
├── claude-config.yaml # Advanced Claude settings
├── agent-findings/ # Multi-agent research synthesis
│ ├── synthesis.md # Coordinated insights
│ ├── market-intel.md # Competitive analysis
│ ├── tech-arch.md # System design
│ └── security.md # Enterprise compliance
├── quality-gates.log # Automated validation
├── client-materials/ # Professional deliverables
└── handoff-history/ # Prompt evolution
Script Library (Progressive Discovery)
Basic Scripts (Always Available)
scripts/basic/initialize_project_memory.sh- Create basic memory structurescripts/basic/load_project_memory.sh- Restore project contextscripts/basic/update_project_memory.sh- Save progress and decisionsscripts/basic/analyze_market_fit.sh- Market analysis for positioningscripts/basic/generate_tech_stack.sh- Technology selectionscripts/basic/estimate_project_value.sh- Revenue potential calculation
Advanced Scripts (Enhanced Mode Only)
scripts/advanced/initialize_enhanced_memory.sh- Advanced memory with automationscripts/advanced/optimize_agent_swarm.sh- Multi-agent coordinationscripts/advanced/enable_hot_reload.sh- Real-time skill optimizationscripts/advanced/validate_quality_gates.sh- Automated quality assurancescripts/advanced/generate_client_materials.sh- Professional deliverablesscripts/advanced/session_teleport_prep.sh- Client demo environment setup
Reference System (Progressive Disclosure)
Core References (Always Loaded)
- @reference/basic/discovery-questions.md - Strategic questioning frameworks
- @reference/basic/handoff-templates.md - Auto Claude prompt templates
- @reference/basic/success-metrics.md - Portfolio KPIs and ROI tracking
Advanced References (On-Demand Loading)
- @reference/advanced/agent-swarm-patterns.md - Multi-agent coordination
- @reference/advanced/claude-2-1-0-optimization.md - Infrastructure features
- @reference/advanced/enterprise-quality-gates.md - Automated validation
- @reference/advanced/parallel-processing.md - Concurrent workflow optimization
- @reference/advanced/memory-architecture.md - Cross-session persistence
- @reference/advanced/roi-modeling.md - Dynamic business impact calculation
Industry Modules (Context-Forked, Advanced Only)
- @modules/saas-optimization/ - SaaS-specific patterns
- @modules/enterprise-integration/ - Large-scale system design
- @modules/consulting-frameworks/ - Methodology systematization
- @modules/ai-automation/ - Intelligent workflow enhancement
Success Criteria (Mode-Adaptive)
Universal Standards
- Strategic discovery captures competitive positioning
- Technical architecture leverages appropriate Claude Code features
- Scope refinement includes comprehensive requirements
- Auto Claude handoff integrates context and memory
- ROI tracking validates business impact projections
Basic Mode Validation
- Project memory enables session continuity
- Single-agent coordination optimizes development efficiency
- Quality gates ensure portfolio-grade standards
- Handoff prompt includes full context and configuration
- 300-800% ROI potential with conservative projections
Advanced Mode Validation
- Agent swarm coordination maximizes parallel efficiency
- Context forking enables specialist analysis isolation
- Hot-reload capabilities support real-time optimization
- Memory architecture supports enterprise-grade persistence
- Quality automation ensures production-ready standards
- Professional deliverables support premium positioning
- 625-3,233% ROI potential with advanced feature leverage
Workflow Execution (Progressive)
Mode Detection
def detect_mode(user_input, project_context):
advanced_triggers = ["advanced", "enhanced", "enterprise", "parallel", "agent swarm"]
basic_triggers = ["basic", "simple", "first project", "learning"]
if any(trigger in user_input.lower() for trigger in advanced_triggers):
return "advanced"
elif any(trigger in user_input.lower() for trigger in basic_triggers):
return "basic"
else:
# Auto-detect based on context
return "basic" if project_context.get("experience_level") == "beginner" else "advanced"
Basic Workflow Execution
- Initialize: Create basic memory structure and load context
- Discovery: Single-threaded strategic analysis with memory persistence
- Architecture: Standard Claude Code configuration with basic agent coordination
- Refinement: Comprehensive specification with manual quality validation
- Generation: Context-optimized Auto Claude handoff with project memory
Advanced Workflow Execution
- Initialize: Create enhanced memory with automation infrastructure
- Discovery: Parallel competitive intelligence with AI-powered insights
- Architecture: Agent swarm coordination with context forking and hot-reload
- Refinement: Automated quality gates with professional deliverable generation
- Generation: Memory-integrated prompts with session teleportation and enterprise standards
Integration Points
With Claude Code Core
- Memory System: Persistent cross-session project continuity
- Agent Coordination: Single or multi-agent based on mode
- Quality Gates: Hook-driven validation and standards enforcement
- Skill Loading: Progressive disclosure based on complexity needs
With Project Infrastructure
- Technology Stack: Modern, client-impressive technology selection
- Development Approach: Optimized for portfolio demonstration value
- Business Integration: ROI tracking and competitive positioning
- Client Readiness: Professional presentation and demo preparation
This unified system provides clear progression from basic portfolio development to enterprise-grade infrastructure capabilities, enabling users to start simple and scale to advanced features as needed while maintaining consistent quality and business impact focus.