Agent skill

re-architecture

Pipeline Component Analysis & Feedback Tool. Decomposes pipelines into components with traceability feedback. Records all interactions in Machine-Readable YAML format. Integrates with /research skill for skill-driven pipeline support.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/data/re-architecture

SKILL.md

/re-architecture - Pipeline Component Analysis & Feedback

Version: 1.0.0 | Model: opus


Overview

Aspect Description
Purpose Decompose pipelines into components with traceability feedback
Output L1: Summary / L2: Per-component analysis / L3: YAML log with full traceability
Language All output in Korean

Cross-Skill Integration

Skill Relationship
/research Handoff for deep research after analysis
/planning Implementation planning after research

Commands

Command Description
<target-path> Analyze pipeline at specified path
--resume <slug> Resume previous analysis session

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

yaml
# .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

markdown
## 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

yaml
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

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

Handoff Options

python
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

Error Detection Recovery
Target path not found File/dir not exists Prompt for correct path
YAML write failure I/O error Memory fallback + warning
Component analysis timeout >5min Save partial, allow resume
User session timeout No response Auto-save, resume later

Version History

Version Change
1.0.0 Initial implementation with YAML traceability logging

End of Skill Definition

Didn't find tool you were looking for?

Be as detailed as possible for better results