# Oracle Solution Design

> Oracle Solution Design Orchestrator

- Skill: `oci-ai-architects/oracle-solution-design` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add oci-ai-architects/oracle-solution-design`
- Raw SKILL.md: https://api.skillmd.com/api/skills/oci-ai-architects/oracle-solution-design/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: oci-ai-architects (https://skillmd.com/u/oci-ai-architects)
- Updated: 2026-09-22
- Page: https://skillmd.com/skills/oci-ai-architects/oracle-solution-design

---

# Oracle Solution Design Orchestrator

> **Replaces:** claude-flow swarm orchestration for solution design workflows
> **Method:** Native Claude Code Task agents with parallel dispatch + quality gates
> **Confidentiality:** Conversation-only context model. Zero persistent state.

## When to Use This Skill

Invoke when the user needs:
- A complete solution design for a customer engagement
- A Solution Design Document (SDD) for an OCI-based solution
- An architecture recommendation with BOM and visuals
- A prototype or interactive demo for a customer presentation

**Trigger:** `/oracle-solution-design` or when user says "solution design", "SDD", "architecture for [client]"

---

## The 5-Phase Workflow

```
  DISCOVER --> ARCHITECT --> VISUALIZE --> PROTOTYPE --> DELIVER
     |             |             |              |            |
  [Gate 1]     [Gate 2]     [Gate 3]       [Gate 4]    [Gate 5]
     |             |             |              |            |
  Parallel     system-       nano-banana    coder         Package
  research     architect     + infogenius   agent         + audit
  agents       agent
```

### Phase Execution Model

Each phase uses native Claude Code capabilities. No daemon, no vector DB, no external processes.

| Phase | Agent Strategy | Tools Used |
|-------|---------------|------------|
| DISCOVER | Parallel Task(researcher) x2-3 | WebSearch, WebFetch, Grep, Read |
| ARCHITECT | Task(system-architect) + Task(researcher) | Read, WebFetch, Write |
| VISUALIZE | Direct (main context) | Nano Banana MCP, Read |
| PROTOTYPE | Task(coder) or direct | Write, Edit, Bash |
| DELIVER | Direct (main context) | Write, Read, Bash |

---

## Phase 1: DISCOVER

### Objective
Gather all information needed to design the solution. Run research in parallel.

### Parallel Agent Dispatch Pattern

Launch 2-3 Task agents simultaneously:

**Agent 1 -- OCI Capabilities Research:**
```
Task(subagent_type="researcher")
"Research OCI services for [use case]. Check:
 1. OCI GenAI models available (docs.oracle.com/iaas/Content/generative-ai/)
 2. Relevant oracle-quickstart repos (github.com/oracle-quickstart)
 3. OCI AI Blueprints if GenAI workload
 Return: service list with capabilities and limitations."
```

**Agent 2 -- Industry/Domain Research:**
```
Task(subagent_type="researcher")
"Research [industry/domain] AI patterns:
 1. Common architecture patterns for [use case]
 2. Compliance/regulatory requirements
 3. Industry benchmarks and KPIs
 Return: requirements matrix and constraints."
```

**Agent 3 -- Pricing and Competitor Landscape (if needed):**
```
Task(subagent_type="researcher")
"Research current pricing for [specific OCI services]:
 1. Verify at oracle.com/cloud/price-list/
 2. Check OCI Cost Estimator for complex scenarios
 3. Note any commitment discounts or free tiers
 Return: verified pricing with sources and dates."
```

### Confidentiality Gate
Before proceeding, verify:
- No real customer names in any output
- All context uses codename only
- Research results are generic (industry patterns, not client-specific)

### Output
Mental model of the solution. No document yet. Just validated understanding.

### Quality Gate 1: Discovery Complete
- Core use cases identified (top 3)
- OCI services mapped to requirements
- Constraints documented (compliance, timeline, budget)
- Existing OCI patterns checked (oracle-quickstart, AI Blueprints)

---

## Phase 2: ARCHITECT

### Objective
Design the technical architecture with OCI service selection and cost estimation.

### Agent Strategy

**Primary: System Architect Agent**
```
Task(subagent_type="system-architect")
"Design an OCI architecture for [use case] with these requirements:
 [paste discovery results]

 Deliver:
 1. OCI service selection with rationale for each choice
 2. Architecture tiers (Basic / Advanced / Premium)
 3. Data flow: ingestion > processing > storage > retrieval > presentation
 4. Security architecture: IAM, encryption, network isolation
 5. Integration points and APIs"
```

**Support: Pricing Verification**
```
Task(subagent_type="researcher")
"Verify pricing for these OCI services: [list from architect]
 Source: oracle.com/cloud/price-list/
 Return: Monthly cost estimate by tier with line items."
```

### MANDATORY Checks Before Finalizing Architecture
1. AI Blueprints decision tree -- Does an existing blueprint cover this? (See CLAUDE.md)
2. Model selection -- Use the OCI GenAI Model Selection Matrix (See CLAUDE.md)
3. Pricing claims -- NEVER say "X times cheaper" without specific model comparison
4. Service availability -- Confirm services exist in target OCI region

### Document Generation

Generate the SDD in clients/[CODE]/ using /oracle-sdd-generator skill.

### Quality Gate 2: Architecture Validated
- Every OCI service verified against official docs
- Pricing confirmed via oracle.com/cloud/price-list/ (not from memory)
- No blanket cost comparison claims
- Existing patterns checked (oracle-quickstart, technology-engineering)
- Architecture follows OCI Well-Architected Framework principles
- Confidentiality audit passed (no client names, codename only)

---

## Phase 3: VISUALIZE

### Objective
Create architecture diagrams that are logo-free and technically accurate.

### Direct Execution (Main Context)
Visual generation stays in the main context for interactive refinement:

1. Invoke /oracle-infogenius or Nano Banana directly
2. Mandatory prompt elements:
   - "NO Oracle logos -- text labels only"
   - Oracle Red (#C74634) for accents
   - Dark background for professionalism
   - All service names must match official branding
3. Draft then Refine pattern:
   - Flash ($0.039) for initial draft
   - Review and adjust prompt
   - Pro ($0.134) for final version only after draft approved

### Recommended Visual Set

| Image | Audience | Focus |
|-------|----------|-------|
| Master Architecture | Technical + Executive | Full OCI stack, all tiers |
| User Journey | Executive | 4-5 step flow, business outcomes |
| Data Flow | Technical | Ingestion to Processing to Storage to Retrieval |
| Tier Comparison | Commercial | Side-by-side Basic/Advanced/Premium |

### Quality Gate 3: Visuals Compliant
- ZERO Oracle logos in any image
- Service names match official branding (26ai not 23ai)
- No spelling errors in diagrams
- Readable at presentation size (1920x1080 minimum)
- Architecture matches the SOLUTION-DESIGN.md

---

## Phase 4: PROTOTYPE

### Objective
Create an interactive HTML prototype the customer can experience.

### Agent Strategy

For complex prototypes:
```
Task(subagent_type="coder")
"Build an interactive HTML prototype for [solution name]:
 Requirements:
 - Single index.html with embedded CSS/JS (no build tools)
 - Simulated [core workflow] with mock data
 - Processing states (loading animations, progress bars)
 - AI insights panel with simulated responses
 - Mobile responsive
 - PROTOTYPE banner clearly visible
 - Oracle Red (#C74634) accents, dark theme
 - NO real customer data -- all mock/synthetic"
```

For simple prototypes: Build directly in main context.

### Prototype Quality Standards
- One core workflow, executed perfectly
- Every element has obvious purpose
- No placeholder content, no broken buttons
- Demo/prototype clearly labeled
- Mock data is realistic but obviously synthetic

### Quality Gate 4: Prototype Functional
- Core interaction works end-to-end
- Processing states visible (loading, progress)
- No broken buttons or dead links
- PROTOTYPE/DEMO banner displayed
- No real customer data anywhere
- Mobile responsive (at minimum, not broken on mobile)

---

## Phase 5: DELIVER

### Objective
Package everything for customer presentation.

### Output Structure
```
clients/[CODE]/
  SOLUTION-DESIGN.md           # Full SDD
  deliverables/
    images/
      architecture.png         # Master architecture (logo-free)
      user-journey.png         # Executive flow
      data-flow.png            # Technical detail
      tier-comparison.png      # Commercial comparison
    prototype/
      index.html               # Interactive demo
    docs/
      DISCOVERY.md             # Requirements captured
      BOM.md                   # Bill of Materials
  README.md                    # Project overview (codename only)
```

### Final Confidentiality Audit
Before any delivery:
- grep for real customer names in all output files -- MUST return zero
- Solution name is generic or codename-based
- No internal Oracle pricing beyond published list prices
- No competitor attacks -- only OCI capability focus
- README.md contains ONLY: status, role, codename -- no industry/scope

### Quality Gate 5: Delivery Ready
- All files in correct structure
- README complete with codename only
- Images are logo-free (visual inspection)
- Prototype loads and works standalone
- BOM pricing verified against official sources
- Would McKinsey present this to a Fortune 500 CEO? Yes/No

---

## Quick Reference: Agent Routing Matrix

| Need | Agent | Why Not Other? |
|------|-------|----------------|
| OCI service research | Task(researcher) | Web search + fetch access |
| Competitor/market research | Task(researcher) | Web search access |
| Architecture design | Task(system-architect) | Architecture patterns expertise |
| Code review of prototype | Task(reviewer) | Code quality focus |
| Build prototype | Task(coder) | Implementation focus |
| Deep codebase exploration | Task(Explore) | Fast file search |
| Multi-step planning | Task(Plan) | Architecture planning |
| Pricing verification | Task(researcher) | Needs web access |

## Anti-Patterns

| Do Not Do This | Do This Instead |
|---------------|----------------|
| Run all phases sequentially with no parallelism | Parallel research agents in Phase 1 |
| Skip pricing verification | ALWAYS verify at oracle.com/cloud/price-list/ |
| Include Oracle logos in visuals | Text labels only, Oracle Red accents |
| Persist client context to files | Conversation-only context, codename in files |
| Use claude-flow daemon for orchestration | Native Task agents -- zero infrastructure |
| Generate final visuals on first attempt | Flash draft first, Pro only after approval |
| Build complex prototype without coder agent | Delegate to Task(coder) for complex HTML/JS |
| Deliver without confidentiality audit | Always grep for real names before delivery |

---

## Integration with Other Skills

| Phase | Complementary Skill | When to Invoke |
|-------|---------------------|---------------|
| DISCOVER | /oracle-research | Deep OCI service investigation |
| ARCHITECT | /oci-services-expert | Service selection + pricing |
| ARCHITECT | /oracle-sdd-generator | Full SDD document generation |
| VISUALIZE | /oracle-infogenius | Tiered image generation |
| VISUALIZE | /oracle-ai-architect-infogenius | Full validation pipeline |
| PROTOTYPE | /oracle-adk | If agent-based prototype needed |
| DELIVER | /oracle-confidentiality | Final audit before handoff |

---

*Version: 1.0 | Created: 2026-02-09 | Replaces: claude-flow swarm orchestration*