How git-neelesh/archify works
Archify turns an idea, plan, or repository into an interactive HTML diagram that users can explore and share. Its documented workflow begins with a user asking an AI agent to use Archify; the CLI produces the artifact, which the viewer supports with focused views and route tracing. The repository also includes distinct architecture, workflow, sequence, dataflow, and lifecycle renderers, plus repository-delta and artifact-preview/verification capabilities. Some renderer dispatch and viewer wiring are unsampled, so those links are marked unverified rather than inferred as direct calls.
Main entry points: archify.mjs Archify CLI · finalize.mjs Artifact finalization · export.js Interactive HTML viewer · preview.mjs Live preview
Components 21
Diagram authoring
- Archify CLI
archify/bin/archify.mjs - Scenario recipes
archify/recipes/scenarios.mjs
Rendering and shared services
- Architecture diagrams
archify/renderers/architecture/render-architecture.mjs - Workflow diagrams
archify/renderers/workflow/workflow-compiler.mjs - Sequence diagrams
archify/renderers/sequence/render-sequence.mjs - Dataflow diagrams
archify/renderers/dataflow/render-dataflow.mjs - Lifecycle diagrams
archify/renderers/lifecycle/render-lifecycle.mjs - Render helpers
archify/renderers/shared/utils.mjs - Input validation
archify/renderers/shared/validator.mjs
Interactive exploration
- Interactive HTML viewer
viewer/export.js - Focus and guided views
viewer/focus.js - Route tracing
viewer/route-probe.js - Semantic lens
viewer/semantic-lens.js
Artifact delivery
- Live preview
archify/bin/preview.mjs - Artifact finalization
archify/bin/finalize.mjs - Visual verification
archify/bin/visual-check.mjs - Output path safety
archify/renderers/shared/output-path.mjs - Atomic output
archify/renderers/shared/atomic-output.mjs
Repository evidence
- Architecture delta
archify/delta/architecture-delta.mjs - Repository evidence
archify/renderers/shared/repository-evidence.mjs
Other components
- User / AI agent
Connections 23
- User / AI agent → Archify CLI: requests diagram
README.md - Archify CLI → Scenario recipes: uses recipes
- Archify CLI → Architecture diagrams: renders diagrams
- Archify CLI → Workflow diagrams: renders diagrams
- Archify CLI → Sequence diagrams: renders diagrams
- Archify CLI → Dataflow diagrams: renders diagrams
- Archify CLI → Lifecycle diagrams: renders diagrams
- Archify CLI → Input validation: validates input
archify/bin/archify.mjs - Workflow diagrams → Render helpers: uses helpers
archify/renderers/workflow/workflow-compiler.mjs - Sequence diagrams → Render helpers: uses helpers
archify/renderers/sequence/render-sequence.mjs - Interactive HTML viewer → Focus and guided views: supports focus
- Interactive HTML viewer → Route tracing: supports tracing
- Interactive HTML viewer → Semantic lens: supports lens
- Archify CLI → Repository evidence: checks evidence
- Archify CLI → Architecture delta: computes changes
- Archify CLI → Live preview: starts preview
archify/bin/archify.mjs - Live preview → Output path safety: resolves output
archify/bin/preview.mjs - Live preview → Atomic output: commits artifact
archify/bin/preview.mjs - Archify CLI → Artifact finalization: finalizes artifact
archify/bin/archify.mjs - Artifact finalization → Visual verification: checks artifact
archify/bin/finalize.mjs - Artifact finalization → Atomic output: writes safely
archify/bin/finalize.mjs - Artifact finalization → Output path safety: resolves paths
archify/bin/finalize.mjs - Visual verification → Atomic output: publishes evidence
archify/bin/visual-check.mjs