How nssachinnagpal/archify works
Archify is an agent-oriented tool for turning descriptions or repository evidence into interactive HTML diagrams. The principal workflow is to invoke the Archify CLI, author a diagram in a supported format, and explore or share the resulting artifact. The README highlights architecture, dataflow, lifecycle, sequence, and workflow diagrams, plus repository mapping and interactive tracing. The graph includes shared rendering and output-safety layers. Some renderer-to-entrypoint wiring is not shown in the excerpts, so those relationships are omitted rather than inferred.
Main entry points: archify.mjs Archify CLI · render-sequence.mjs Sequence renderer · output-path.mjs Output path safety · workflow-compiler.mjs Workflow compiler
Components 23
Diagram authoring
- Archify CLI
archify/bin/archify.mjs - Architecture renderer
archify/renderers/architecture/render-architecture.mjs - Dataflow renderer
archify/renderers/dataflow/render-dataflow.mjs - Lifecycle renderer
archify/renderers/lifecycle/render-lifecycle.mjs - Sequence renderer
archify/renderers/sequence/render-sequence.mjs - Workflow compiler
archify/renderers/workflow/workflow-compiler.mjs - Architecture delta
archify/delta/architecture-delta.mjs - Scenario recipes
archify/recipes/scenarios.mjs
Shared rendering
- Renderer CLI
archify/renderers/shared/cli.mjs - Validation
archify/renderers/shared/validator.mjs - Diagnostics
archify/renderers/shared/diagnostics.mjs - Geometry and layout
archify/renderers/shared/geometry.mjs - Localization
archify/renderers/shared/i18n.mjs - Brand marks
archify/renderers/shared/brand-marks.mjs
Artifact delivery
- Output path safety
archify/renderers/shared/output-path.mjs - Filesystem semantics
archify/renderers/shared/path-semantics.mjs - Atomic output
archify/renderers/shared/atomic-output.mjs - Finalize artifact
archify/bin/finalize.mjs - Live preview
archify/bin/preview.mjs
Interactive exploration
- Interactive HTML viewer
viewer - Focus and tracing
viewer/focus.js - Viewer export
viewer/export.js
Other components
- User or agent
Connections 28
- User or agent → Archify CLI: describes or invokes
README.md - Archify CLI → Architecture renderer: generates diagram
- Archify CLI → Dataflow renderer: generates diagram
- Archify CLI → Lifecycle renderer: generates diagram
- Archify CLI → Sequence renderer: generates diagram
- Archify CLI → Workflow compiler: generates diagram
- Archify CLI → Architecture delta: supports repository mapping
- Archify CLI → Output path safety: resolves output
archify/bin/archify.mjs - Archify CLI → Atomic output: writes safely
archify/bin/archify.mjs - Archify CLI → Finalize artifact: dispatches
archify/bin/archify.mjs - Archify CLI → Live preview: dispatches
archify/bin/archify.mjs - Renderer CLI → Workflow compiler: configures
archify/renderers/workflow/workflow-compiler.mjs - Workflow compiler → Validation: validates
archify/renderers/workflow/workflow-compiler.mjs - Workflow compiler → Geometry and layout: uses layout
archify/renderers/workflow/workflow-compiler.mjs - Sequence renderer → Renderer CLI: uses CLI helpers
archify/renderers/sequence/render-sequence.mjs - Sequence renderer → Diagnostics: reports issues
archify/renderers/sequence/render-sequence.mjs - Sequence renderer → Geometry and layout: uses layout
archify/renderers/sequence/render-sequence.mjs - Sequence renderer → Localization: localizes
archify/renderers/sequence/render-sequence.mjs - Sequence renderer → Brand marks: adds marks
archify/renderers/sequence/render-sequence.mjs - Output path safety → Filesystem semantics: checks locations
archify/renderers/shared/output-path.mjs - Atomic output → Output path safety: canonicalizes paths
archify/renderers/shared/atomic-output.mjs - Live preview → Output path safety: resolves output
archify/bin/preview.mjs - Live preview → Atomic output: commits artifact
archify/bin/preview.mjs - Finalize artifact → Output path safety: resolves output
archify/bin/finalize.mjs - Finalize artifact → Atomic output: publishes artifact
archify/bin/finalize.mjs - Archify CLI → Interactive HTML viewer: produces interactive HTML
README.md - Interactive HTML viewer → Focus and tracing: supports tracing
README.md - Interactive HTML viewer → Viewer export: exports artifact