are-specify

Generate a project specification from existing AGENTS.md documentation.

Steps

1. Read version: Read .claude/ARE-VERSION → store as $VERSION. Show the user: agents-reverse-engineer v$VERSION

2. Run the specify command in the background using run_in_background: true:

   npx agents-reverse-engineer@$VERSION specify --backend claude $ARGUMENTS
   

3. 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)

4. 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/