ai-repograph

Interactive Node.js CLI that initializes a .structure/ directory in a repository:

• .structure/structure.yaml (machine-readable graph)
• .structure/structure.md (human-readable Mermaid diagram)

This is intended to keep architecture documentation and code changes in sync.

Usage

# from this repo
node init-structure.js

# if installed globally
# npm i -g ai-repograph
# init-structure

Follow the prompts to select architecture/framework/language options and generate the files.

Safety

• If .structure/structure.yaml or .structure/structure.md already exist, the CLI creates a timestamped backup (*.bak-<timestamp>) before writing.
• If AGENTS.md already exists, the CLI does not overwrite it.
• Styling and State Mgmt support none to skip adding a module template.

Templates

Starter templates live in templates/ (for example templates/react/ or templates/next.js/).

• Framework templates: schema: "frontend-extended-v2"
• Module templates: schema: "styling-module-v1" | "state-module-v1" | "language-module-v1"
• Add-ons: schema: "addon-module-v1" (e.g. tanstack-query, react-router, storybook)

Publishing (Optional)

• Use .npmrc.example as a safe starter and keep real tokens out of git (.npmrc is ignored by .gitignore).

License

MIT (see LICENSE).