Name: are-generate
Rating: 76
Author: GeoloeG-IsT

Generate comprehensive documentation for this codebase using agents-reverse-engineer.

<execution> Run the generate command in the background and monitor progress in real time.

Steps

•
Display version: Read .claude/ARE-VERSION and show the user: agents-reverse-engineer vX.Y.Z
•
Run the generate command in the background using run_in_background: true:
bash
```
npx agents-reverse-engineer@latest generate $ARGUMENTS
```
•
Monitor progress by polling .agents-reverse-engineer/progress.log:
- •Wait ~15 seconds (use sleep 15 in Bash), then use the Read tool to read .agents-reverse-engineer/progress.log (use the offset parameter to read only the last ~20 lines for long files)
- •Show the user a brief progress update (e.g. "32/96 files analyzed, ~12m remaining")
- •Check whether the background task has completed using TaskOutput with block: false
- •Repeat until the background task finishes
- •Important: Keep polling even if progress.log doesn't exist yet (the command takes a few seconds to start writing)
•
On completion, read the full background task output and summarize:
- •Number of files analyzed and any failures
- •Number of directories documented
- •Root and per-package documents generated
- •Any inconsistency warnings from the quality report

This executes a three-phase pipeline:

•
Discovery & Planning: Walks the directory tree, applies filters (gitignore, vendor, binary, custom), detects file types, and creates a generation plan.
•
File Analysis (concurrent): Analyzes each source file via AI and writes .sum summary files with YAML frontmatter (content_hash, file_type, purpose, public_interface, dependencies, patterns).
•
Directory & Root Documents (sequential):
- •Generates AGENTS.md per directory in post-order traversal (deepest first, so child summaries feed into parents)
- •Creates root document: CLAUDE.md

Options:

</execution>