Deeply research all systems and create or update blueprints/ documentation for the entire codebase
Deeply researches your entire codebase to generate comprehensive technical blueprints in the repository root. Use this when you need to create or update system-wide documentation that maps all major systems, their architecture, APIs, and relationships.
/plugin marketplace add TheBushidoCollective/han/plugin install hashi-blueprints@hanhashi-blueprints:blueprints - Generate comprehensive blueprint documentation for the entire codebase
/blueprints
Comprehensively document all systems in the codebase by creating or updating the blueprints/ directory at the repository root with technical documentation for each major system.
CRITICAL: Blueprints MUST be created at the repository root, never in subdirectories or packages.
{repo-root}/blueprints/{repo-root}/packages/foo/blueprints/{repo-root}/src/blueprints/Blueprints are repository-wide system design documents. Systems may span multiple packages or directories, but all blueprints belong in a single blueprints/ directory at the repo root.
You are tasked with comprehensively documenting all systems in this codebase.
Analyze project structure to identify all major systems:
Read existing documentation:
Create a system inventory:
If blueprints/ exists:
Order systems by importance:
For each system, create or update {repo-root}/blueprints/{system-name}.md:
# {System Name}
{Brief description}
## Overview
{Purpose and role in the larger system}
## Architecture
{Structure, components, data flow}
## API / Interface
{Public methods, commands, configuration}
## Behavior
{Normal operation, error handling, edge cases}
## Files
{Key implementation files with descriptions}
## Related Systems
{Links to related blueprints}
Update {repo-root}/blueprints/README.md:
# Technical Blueprints
This directory contains implementation documentation for {project name}.
## Systems
### Core
- [{System A}](./system-a.md) - {description}
- [{System B}](./system-b.md) - {description}
### Features
- [{Feature X}](./feature-x.md) - {description}
### Integrations
- [{Integration Y}](./integration-y.md) - {description}
## Documentation Standards
See [hashi-blueprints](https://github.com/thebushidocollective/han) for documentation guidelines.
When documenting, actively prevent duplicates:
After completing: