project-analyze

扫描代码库以生成架构文档（ARCHITECTURE.md）。在加入现有项目、理解代码库结构、探索项目架构，或为代理-工头初始化做准备时，请使用本指南。触发条件包括“分析项目”、“理解代码库”、“探索架构”、“扫描项目结构”、“调查项目”。

SKILL.md

--- frontmatter

name: project-analyze
description: Scans codebases to generate architecture documentation (ARCHITECTURE.md). Use when joining an existing project, understanding codebase structure, exploring project architecture, or preparing for agent-foreman init. Triggers on 'analyze project', 'understand codebase', 'explore architecture', 'scan project structure', 'survey project'.
allowed-tools: [Bash, Read, Glob, Grep]
user-invocable: true

🔍 Project Analyze

One command: agent-foreman init --analyze

Quick Start

bash

agent-foreman init --analyze

Output: docs/ARCHITECTURE.md

Options

Flag	Effect
`--analyze-output ./path/FILE.md`	Custom output path
`--verbose`	Show detailed progress

Use When

•Joining existing project → understand before changing
•Before agent-foreman init → faster initialization

Skip When

•New/empty project → use agent-foreman init directly

Read-Only

No code changes. No commits. Safe to run anytime.