Re Architecture

/re-architecture - Pipeline Component Analysis & Feedback

Version: 1.0.0 | Model: opus

Overview

Cross-Skill Integration

Commands

Execution Flow

Phase 1: Decomposition

1. Parse target path from arguments
2. Analyze pipeline structure with Sequential Thinking
3. Extract components, stages, and dependencies
4. Update YAML log with decomposition results
5. Present results to user

Phase 2: Iterative Component Analysis

For each component:

1. Deep analysis of component structure
2. Record analysis in YAML log (before)
3. Generate feedback (findings, recommendations, issues)
4. Present options to user with AskUserQuestion
5. Update YAML log with user selection (after)
6. Save component feedback

Phase 3: Handoff Preparation

1. Synthesize all feedback
2. Generate handoff context for /research
3. Update YAML log with handoff info
4. Present handoff options to user

YAML Log Schema

# .agent/prompts/{slug}/re-architecture-log.yaml

metadata:
  id: "{slug}"
  version: "1.0.0"
  created_at: "2026-01-26T21:10:00Z"
  status: "in_progress"  # in_progress | completed | paused
  target_path: "{path}"

state:
  current_phase: "decomposition"  # decomposition | analysis | feedback | handoff
  current_component: null
  round: 1
  total_components: 0
  analyzed_components: 0

user_intent:
  original_request: "{user request}"
  clarified_goals: []
  constraints: []
  priorities: []

decomposition:
  pipeline_structure: "{diagram}"
  components:
    - id: "comp-001"
      name: "{name}"
      path: "{path}"
      type: "stage|module|service|utility"
      dependencies:
        upstream: []
        downstream: []
      status: "pending"  # pending | analyzing | completed

rounds:
  - round: 1
    timestamp: "2026-01-26T21:11:00Z"
    phase: "decomposition"
    component_id: null
    input:
      prompt: "{input}"
      context: "{context}"
    analysis:
      findings: []
      recommendations: []
      issues: []
      code_evidence: []
    output:
      feedback: "{feedback}"
      options_presented: []
      user_selection: null
    traceability:
      design_intent: "{intent}"
      decision_rationale: "{rationale}"
      related_components: []
      parent_round: null
      issue_refs: []

component_feedback:
  "comp-001":
    analyzed_at: "2026-01-26T21:12:00Z"
    summary: "{summary}"
    findings:
      - id: "find-001"
        type: "pattern|issue|opportunity"
        severity: "info|warning|critical"
        description: "{description}"
        evidence:
          file: "{path}"
          line: "{line}"
          snippet: "{code}"
    recommendations:
      - id: "rec-001"
        priority: "high|medium|low"
        description: "{description}"
        rationale: "{rationale}"
        effort_estimate: "small|medium|large"
    issues:
      - id: "issue-001"
        type: "bug|debt|risk|improvement"
        severity: "critical|high|medium|low"
        description: "{description}"
        suggested_action: "{action}"
        blocking: false

handoff:
  ready_for_research: false
  research_context:
    summary: "{summary}"
    key_findings: []
    priority_components: []
    recommended_focus: []
  next_action_hint: "/research --clarify-slug {slug}"

Output Format

Round Presentation

## Round {n}: {component_name} Analysis

### Component Info
- **Path:** {path}
- **Type:** {type}
- **Dependencies:** {dependencies}

### Findings
| ID | Type | Severity | Description |
|----|------|----------|-------------|
| find-001 | pattern | info | {description} |

### Recommendations
| ID | Priority | Description | Rationale |
|----|----------|-------------|-----------|
| rec-001 | high | {description} | {rationale} |

### Issues
| ID | Type | Severity | Description | Action |
|----|------|----------|-------------|--------|
| issue-001 | debt | medium | {description} | {action} |

### Design Intent
{design_intent_explanation}

L1 Return Summary

taskId: re-arch-{slug}
status: success
summary: "{n}개 컴포넌트 분석 완료, {findings}개 발견사항, {issues}개 이슈"
logPath: .agent/prompts/{slug}/re-architecture-log.yaml
handoffReady: true
nextActionHint: "/research --clarify-slug {slug}"

User Interaction Options

Component Analysis Options

options = [
    {"label": "피드백 승인", "description": "이 컴포넌트 분석을 승인하고 다음으로 진행"},
    {"label": "추가 분석 요청", "description": "특정 영역에 대해 더 깊은 분석 진행"},
    {"label": "이슈 등록", "description": "발견된 문제를 이슈로 등록"},
    {"label": "건너뛰기", "description": "이 컴포넌트를 건너뛰고 다음으로"}
]

Handoff Options

options = [
    {"label": "/research로 진행 (권장)", "description": "분석 결과를 바탕으로 심층 연구 시작"},
    {"label": "분석 결과만 저장", "description": "나중에 수동으로 /research 호출"},
    {"label": "추가 분석 진행", "description": "놓친 컴포넌트 추가 분석"}
]

Pipeline Position

/re-architecture  <-- THIS SKILL (Entry Point)
    │
    │ re-architecture-log.yaml
    ▼
/research         Deep research (optional)
    │
    ▼
/planning         Implementation planning

Error Handling

Version History

End of Skill Definition