docs

You can generate hierarchical architectural documentation by running parallel agents across multiple project directories to automatically create DEVGUIDE.md files. This approach automates the doc writing process while ensuring structural consistency throughout the codebase.

A DEVGUIDE.md file is a hierarchical architectural document outlining the structure of project directories. You need it when managing multi-directory codebases to reduce manual writing and ensure consistent architectural documentation across the project.

To update existing architectural docs, the process detects and respects existing files and structure, modifying the DEVGUIDE.md content rather than recreating it. It can optionally write to DEVGUIDE_2.md to preserve the original file.

Yes, you can customize generated documentation by adding project rules in the .claude/rules directory. The generation process detects these rules and uses them to tailor the content of the DEVGUIDE.md files.

Parallel agent documentation generation is designed specifically for multi-directory codebases, launching background agents to process directories concurrently. This architecture supports creating new guides or updating existing ones at scale.

A limitation is that generating DEVGUIDE files with parallel agents relies on the structure of existing directories and the presence of .claude/rules for configuration. It does not invent architecture but documents the current codebase state using background agents.