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
- Parse target path from arguments
- Analyze pipeline structure with Sequential Thinking
- Extract components, stages, and dependencies
- Update YAML log with decomposition results
- Present results to user
Phase 2: Iterative Component Analysis
For each component:
- Deep analysis of component structure
- Record analysis in YAML log (before)
- Generate feedback (findings, recommendations, issues)
- Present options to user with AskUserQuestion
- Update YAML log with user selection (after)
- Save component feedback
Phase 3: Handoff Preparation
- Synthesize all feedback
- Generate handoff context for /research
- Update YAML log with handoff info
- 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?