| name | are-specify |
| description | Generate project specification from AGENTS.md docs (experimental) |
| disable-model-invocation | true |
Generate a project specification from existing AGENTS.md documentation.
Run the specify command in the background and monitor progress in real time.
Steps
-
Read version: Read .claude/ARE-VERSION → store as $VERSION. Show the user: agents-reverse-engineer v$VERSION
-
Run the specify command in the background using run_in_background: true:
npx agents-reverse-engineer@$VERSION specify --backend claude $ARGUMENTS
-
Monitor progress by polling the latest progress log:
- Wait ~15 seconds (use
sleep 15 in Bash), then use Glob to find the latest .agents-reverse-engineer/progress-*.log file, and Read it (use the offset parameter to read only the last ~20 lines for long files)
- Show the user a brief progress update
- Check whether the background task has completed using
TaskOutput with block: false
- Repeat until the background task finishes
- Important: Keep polling even if no progress log exists yet (the command takes a few seconds to start writing)
-
On completion, read the full background task output and summarize:
- Number of AGENTS.md files collected
- Output file(s) written
This collects all AGENTS.md files, synthesizes them via AI, and writes a comprehensive project specification.
If no AGENTS.md files exist, it will auto-run generate first.
Options:
--dry-run: Show input statistics without making AI calls--output <path>: Custom output path (default: specs/SPEC.md)--multi-file: Split specification into multiple files--force: Overwrite existing specification--debug: Show AI prompts and backend details--trace: Enable concurrency tracing to .agents-reverse-engineer/traces/
