refactor: move pipeline agents into skills/understand/ as prompt templates

Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-06-22 10:58:03 +08:00 · 2026-03-19 10:31:22 +08:00
parent 4ff36e3dae
commit 5e85a23aa2
5 changed files with 15 additions and 30 deletions
@@ -1,9 +1,6 @@
---
-name: architecture-analyzer
-description: Analyzes codebase structure to identify architectural layers (API, Service, Data, UI, etc.) and assign files to logical groupings. Use after file analysis is complete.
-tools: Bash, Read, Grep, Glob, Write
-model: opus
---
+# Architecture Analyzer — Prompt Template
+
+> Used by `/understand` Phase 4. Dispatch as a subagent with this full content as the prompt.

 You are an expert software architect. Your job is to analyze a codebase's file structure, summaries, and import relationships to identify logical architectural layers and assign every file to exactly one layer. Your layer assignments must be well-reasoned and reflect the actual organization of the code.

@@ -1,9 +1,6 @@
---
-name: file-analyzer
-description: Analyzes source code files to extract structure (functions, classes, imports), generate summaries, assign complexity ratings, and identify relationships. Use when building or updating a knowledge graph.
-tools: Bash, Read, Glob, Grep, Write
-model: opus
---
+# File Analyzer — Prompt Template
+
+> Used by `/understand` Phase 2. Dispatch as a subagent with this full content as the prompt.

 You are an expert code analyst. Your job is to read source files and produce precise, structured knowledge graph data (nodes and edges) that accurately represents the code's structure, purpose, and relationships. You must be thorough yet concise, and every piece of data you produce must be grounded in the actual source code.

@@ -1,9 +1,6 @@
---
-name: graph-reviewer
-description: Validates knowledge graph completeness, referential integrity, and quality. Use as a final quality check after graph assembly.
-tools: Bash, Read, Write, Glob, Grep
-model: sonnet
---
+# Graph Reviewer — Prompt Template
+
+> Used by `/understand` Phase 6. Dispatch as a subagent with this full content as the prompt.

 You are a rigorous QA validator for knowledge graphs produced by the Understand Anything analysis pipeline. Your job is to systematically check the assembled graph for correctness, completeness, and quality, then render an approval or rejection decision with clear justification.

@@ -1,9 +1,6 @@
---
-name: project-scanner
-description: Scans a project directory to discover source files, detect programming languages and frameworks, and estimate analysis scope. Use when starting codebase analysis.
-tools: Bash, Glob, Grep, Read, Write
-model: sonnet
---
+# Project Scanner — Prompt Template
+
+> Used by `/understand` Phase 1. Dispatch as a subagent with this full content as the prompt.

 You are a meticulous project inventory specialist. Your job is to scan a codebase directory and produce a precise, structured inventory of all source files, detected languages, frameworks, and estimated complexity. Accuracy is paramount -- every file path you report must actually exist on disk.

@@ -1,9 +1,6 @@
---
-name: tour-builder
-description: Creates guided learning tours for codebases, designing step-by-step walkthroughs that teach project architecture and key concepts. Use after architecture analysis is complete.
-tools: Bash, Read, Grep, Glob, Write
-model: opus
---
+# Tour Builder — Prompt Template
+
+> Used by `/understand` Phase 5. Dispatch as a subagent with this full content as the prompt.

 You are an expert technical educator who designs learning paths through codebases. Your job is to create a guided tour of 5-15 steps that teaches someone the project's architecture and key concepts in a logical, pedagogical order. Each step should build on previous ones, creating a coherent narrative that takes a newcomer from "What is this project?" to "I understand how it works."