Research & Opportunity Investigation Workflow:

□ Phase 1: RESEARCH SCOPING
  ├─ Define research target and objectives
  ├─ Establish success criteria
  └─ GATE: User confirms research scope

□ Phase 2: DISCOVERY & COLLECTION
  ├─ Web search for documentation, repos, announcements
  ├─ Source registration and cataloging
  └─ GATE: User confirms source coverage

□ Phase 3: DEEP ANALYSIS
  ├─ Technical architecture analysis
  ├─ Feature mapping and comparison
  ├─ Gap identification
  └─ GATE: User confirms analysis accuracy

□ Phase 4: ACP CONTEXT SUMMARY
  ├─ Generate comprehensive ACP summary
  ├─ Map existing RFCs, schemas, spec chapters
  ├─ Identify integration points
  └─ GATE: User approves ACP summary document

□ Phase 5: OPPORTUNITY ASSESSMENT
  ├─ Gap analysis (what target lacks that ACP provides)
  ├─ Collaboration opportunities
  ├─ Implementation feasibility
  └─ GATE: User confirms opportunity assessment

□ Phase 6: RFC GENERATION
  ├─ Draft RFC for identified opportunities
  ├─ Validate against ACP summary
  ├─ Cross-reference existing specs
  └─ GATE: User approves RFC content

□ Phase 7: DELIVERABLES PACKAGING
  ├─ Final summary document
  ├─ Gap analysis report
  ├─ RFC proposal(s)
  └─ GATE: User confirms all deliverables

═══════════════════════════════════════════════════════════════════════════════
🔍 RESEARCH SCOPE DEFINITION
═══════════════════════════════════════════════════════════════════════════════

RESEARCH TARGET:
  Name: [Project/Protocol/Tool name]
  Type: [IDE/Protocol/Framework/Tool]
  Primary URL: [Main website/repository]

RESEARCH OBJECTIVES:
  Primary Goal: [What are we trying to learn/achieve?]
  
  Specific Questions:
    1. [Question 1]
    2. [Question 2]
    3. [Question 3]

SUCCESS CRITERIA:
  □ [Criterion 1 - measurable outcome]
  □ [Criterion 2 - measurable outcome]
  □ [Criterion 3 - measurable outcome]

ACP INTEGRATION FOCUS:
  □ Gap-filling opportunity (target lacks capability ACP provides)
  □ Protocol integration (technical compatibility)
  □ Collaboration opportunity (partnership/adoption)
  □ Competitive analysis (understanding landscape)
  □ Other: _______________

───────────────────────────────────────────────────────────────────────────────
⚠️  Please confirm this scope before proceeding with discovery.
═══════════════════════════════════════════════════════════════════════════════

═══════════════════════════════════════════════════════════════════════════════
📚 SOURCE REGISTRATION
═══════════════════════════════════════════════════════════════════════════════

REGISTERED SOURCES:

  [SRC-001] Official Documentation
    └─ URL: [url]
    └─ Type: documentation
    └─ Accessed: [date]
    └─ Relevance: [high/medium/low]
    └─ Key Sections: [list relevant sections]

  [SRC-002] GitHub Repository
    └─ URL: [url]
    └─ Type: source_code
    └─ Accessed: [date]
    └─ Relevance: [high/medium/low]
    └─ Key Files: [list relevant files]

  [SRC-003] ...

───────────────────────────────────────────────────────────────────────────────
SOURCE GAPS (information needed but not found):

  □ [Gap 1] - Required for: [analysis area]
  □ [Gap 2] - Required for: [analysis area]

───────────────────────────────────────────────────────────────────────────────
⚠️  Please confirm these sources are sufficient or identify additional sources.
═══════════════════════════════════════════════════════════════════════════════

□ Official documentation site
□ GitHub/GitLab repository
□ Official announcements/blog posts
□ API/Protocol specifications

□ Technical blog posts from team members
□ Conference talks/presentations
□ Community discussions (Discord, Slack, Forums)
□ Integration guides from partners

□ Third-party reviews and analyses
□ Comparison articles
□ Issue tracker discussions
□ Social media announcements

[Finding Statement]
  └─ Source: [SRC-XXX], [specific section/line/page]
  └─ Evidence Type: [VERIFIED|INFERRED|ASSUMED]
  └─ Confidence: [HIGH|MEDIUM|LOW]
  └─ Quote/Reference: "[relevant excerpt]"

═══════════════════════════════════════════════════════════════════════════════
🏗️ TECHNICAL ARCHITECTURE ANALYSIS
═══════════════════════════════════════════════════════════════════════════════

CORE ARCHITECTURE:
  
  Components:
    □ [Component 1]: [Description] (Source: [SRC-XXX])
    □ [Component 2]: [Description] (Source: [SRC-XXX])
  
  Data Flow:
    [Component A] → [Component B] → [Component C]
  
  Key Abstractions:
    □ [Abstraction 1]: [Purpose]
    □ [Abstraction 2]: [Purpose]

PROTOCOL/API DESIGN:
  
  Communication Pattern: [request-response/streaming/event-driven]
  Data Format: [JSON/Protocol Buffers/Other]
  Transport: [HTTP/WebSocket/IPC/Other]
  
  Key Endpoints/Methods:
    □ [Endpoint 1]: [Purpose] (Source: [SRC-XXX])
    □ [Endpoint 2]: [Purpose] (Source: [SRC-XXX])

EXTENSION POINTS:
  
  □ [Extension Point 1]: [How external tools integrate]
  □ [Extension Point 2]: [How external tools integrate]

───────────────────────────────────────────────────────────────────────────────

## Feature Comparison Matrix

| Feature Area | Target Has | ACP Provides | Gap/Overlap |
|--------------|------------|--------------|-------------|
| [Feature 1] | [Yes/No/Partial] | [Yes/No/Partial] | [Gap/Overlap/None] |
| [Feature 2] | [Yes/No/Partial] | [Yes/No/Partial] | [Gap/Overlap/None] |

### Gap Details

#### Gap G-001: [Gap Name]
- **Target Status**: [What target lacks]
- **ACP Capability**: [What ACP provides]
- **Integration Potential**: [HIGH/MEDIUM/LOW]
- **Evidence**: (Source: [SRC-XXX])

#### Gap G-002: ...

═══════════════════════════════════════════════════════════════════════════════
📋 ACP PROTOCOL SUMMARY DOCUMENT
═══════════════════════════════════════════════════════════════════════════════

Generated: [timestamp]
Purpose: Reference document for RFC validation and integration planning

───────────────────────────────────────────────────────────────────────────────
SECTION 1: SPECIFICATION OVERVIEW
───────────────────────────────────────────────────────────────────────────────

Current ACP Version: [version]
Spec Location: acp-protocol/acp-spec/spec/

Key Chapters:
  □ 01-introduction.md: [Summary of goals and non-goals]
  □ 03-cache-format.md: [Summary of cache structure]
  □ 04-config-format.md: [Summary of configuration options]
  □ 05-annotations.md: [Summary of annotation syntax]
  □ 06-constraints.md: [Summary of constraint system]
  □ [Additional relevant chapters...]

───────────────────────────────────────────────────────────────────────────────
SECTION 2: EXISTING RFCs
───────────────────────────────────────────────────────────────────────────────

RFC-001: Self-Documenting Annotations
  Status: [status]
  Summary: [brief summary]
  Key Changes: [what it introduced]
  Relevance to Research: [how it relates to current investigation]

RFC-002: Documentation References
  Status: [status]
  Summary: [brief summary]
  Key Changes: [what it introduced]
  Relevance to Research: [how it relates]

RFC-003: Annotation Provenance
  Status: [status]
  Summary: [brief summary]
  Key Changes: [what it introduced]
  Relevance to Research: [how it relates]

[Continue for all RFCs...]

───────────────────────────────────────────────────────────────────────────────
SECTION 3: SCHEMA INVENTORY
───────────────────────────────────────────────────────────────────────────────

Location: acp-protocol/acp-spec/schemas/

Schemas:
  □ cache.schema.json: [purpose, key fields]
  □ config.schema.json: [purpose, key fields]
  □ vars.schema.json: [purpose, key fields]
  □ sync.schema.json: [purpose, key fields]
  [Continue for all schemas...]

───────────────────────────────────────────────────────────────────────────────
SECTION 4: INTEGRATION POINTS
───────────────────────────────────────────────────────────────────────────────

Existing Integration Mechanisms:
  □ MCP Integration (acp-mcp): [current capabilities]
  □ CLI Interface (acp-cli): [current capabilities]
  □ LSP Planning (acp-lsp): [planned capabilities]

Extension Points for External Protocols:
  □ [Extension point 1]: [how external tools would integrate]
  □ [Extension point 2]: [how external tools would integrate]

───────────────────────────────────────────────────────────────────────────────
SECTION 5: DESIGN PRINCIPLES
───────────────────────────────────────────────────────────────────────────────

Core Principles (from spec):
  □ Self-documenting annotations
  □ Token efficiency
  □ Deterministic constraints
  □ Language-agnostic syntax
  □ Progressive disclosure

Compatibility Requirements:
  □ Backward compatibility policy
  □ Versioning approach
  □ RFC process requirements

═══════════════════════════════════════════════════════════════════════════════
⚠️  User MUST approve this summary before RFC generation proceeds.
═══════════════════════════════════════════════════════════════════════════════

□ All existing RFCs catalogued with summaries
□ All relevant spec chapters summarized
□ All schemas inventoried with key fields
□ Integration points identified
□ Design principles extracted
□ User has reviewed and approved summary

═══════════════════════════════════════════════════════════════════════════════
🎯 OPPORTUNITY ASSESSMENT
═══════════════════════════════════════════════════════════════════════════════

GAP ANALYSIS:

  What [TARGET] Lacks That ACP Provides:
  
    GAP-001: [Gap Name]
      └─ Target Status: [Current capability or lack]
      └─ ACP Capability: [What ACP offers]
      └─ Strategic Value: [HIGH/MEDIUM/LOW]
      └─ Implementation Effort: [HIGH/MEDIUM/LOW]
      └─ Evidence: (Source: [SRC-XXX])
    
    GAP-002: ...

COLLABORATION OPPORTUNITIES:

  OPP-001: [Opportunity Name]
    └─ Description: [What could be achieved]
    └─ Mutual Benefit: [How both parties benefit]
    └─ Required Changes:
        - ACP: [What ACP would need to change/add]
        - Target: [What target would need to change/add]
    └─ Feasibility: [HIGH/MEDIUM/LOW]
    └─ Evidence: (Source: [SRC-XXX])

  OPP-002: ...

RISK ASSESSMENT:

  RISK-001: [Risk Name]
    └─ Description: [What could go wrong]
    └─ Likelihood: [HIGH/MEDIUM/LOW]
    └─ Impact: [HIGH/MEDIUM/LOW]
    └─ Mitigation: [How to address]

───────────────────────────────────────────────────────────────────────────────
RECOMMENDATION:

  □ Proceed with RFC development for: [specific opportunities]
  □ Defer: [what to defer and why]
  □ Decline: [what to decline and why]

───────────────────────────────────────────────────────────────────────────────
⚠️  Please confirm this assessment before RFC generation.
═══════════════════════════════════════════════════════════════════════════════

RFC VALIDATION CHECKLIST:

Structure:
  □ All required sections present
  □ RFC number follows convention
  □ Status correctly set to Draft

Content:
  □ Summary is concise (2-3 sentences)
  □ Motivation clearly explains problem
  □ Research basis documented with sources
  □ Gap analysis included with IDs

Specification:
  □ All affected components identified
  □ Changes reference existing spec sections
  □ Proposed changes are specific and implementable
  □ Examples provided where helpful

Compatibility:
  □ Breaking changes identified (or stated as none)
  □ Migration path provided if needed
  □ Deprecation schedule if applicable

Validation:
  □ Cross-referenced against ACP Summary document
  □ No conflicts with existing RFCs
  □ Consistent with ACP design principles
  □ User has reviewed and approved

═══════════════════════════════════════════════════════════════════════════════
📦 DELIVERABLES PACKAGE
═══════════════════════════════════════════════════════════════════════════════

RESEARCH DELIVERABLES:

  □ research-summary-[target]-[date].md
    └─ Complete research findings
    └─ All sources catalogued
    └─ Technical analysis complete
    
  □ gap-analysis-[target]-[date].md
    └─ All gaps identified with IDs
    └─ Opportunity assessment
    └─ Recommendations

ACP CONTEXT DELIVERABLES:

  □ acp-summary-[date].md
    └─ Current RFCs summarized
    └─ Schemas inventoried
    └─ Spec chapters mapped
    └─ Integration points identified

RFC DELIVERABLES:

  □ RFC-XXXX-[title].md
    └─ Complete RFC proposal
    └─ Validated against ACP summary
    └─ All sections complete

───────────────────────────────────────────────────────────────────────────────
QUALITY VERIFICATION:

  □ All sources cited with [SRC-XXX] format
  □ No ungrounded claims remain
  □ All assumptions marked as [ASSUMED]
  □ User approved each phase gate
  □ RFC traces to existing specification

───────────────────────────────────────────────────────────────────────────────
⚠️  Please confirm all deliverables are complete and accurate.
═══════════════════════════════════════════════════════════════════════════════