# Project Analyze

> Project Analyze is an Agent Skill for documents published in the mylukin/agent-foreman repository on GitHub: a SKILL.md instruction file an AI agent can load to do this task.

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'.

- Skill name: `project-analyze`
- Category: [Documents](https://www.openparable.com/skill/documents/1)
- Source: https://github.com/mylukin/agent-foreman/blob/HEAD/plugins/agent-foreman/skills/project-analyze/SKILL.md
- Repository: mylukin/agent-foreman (248 GitHub stars when collected)

## SKILL.md

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

---

Source: https://www.openparable.com/skill/documents/project-analyze (OpenParable). Cite the canonical URL above.