How 42pizzapirates/archify works
Archify turns an agent-authored, typed JSON diagram into a validated, self-contained interactive artifact. The main path runs from the authoring agent through the command-line loading and validation layer to a type-specific renderer; users then inspect, trace, guide, and export the result. Separate capabilities include architecture-delta comparison and preview/open workflows. The README documents product capabilities; the source index and excerpts support the implementation links shown. Viewer modules are grouped by capability because their wiring was not sampled.
Main entry points: cli.mjs Diagram CLI · geometry.mjs Shared geometry · archify.mjs Archify command · render-architecture.mjs Architecture renderer
Components 22
Authoring and runtime
- Diagram CLI
archify/renderers/shared/cli.mjs - Archify command
archify/bin/archify.mjs - Live preview
archify/bin/preview.mjs - Open artifact
archify/bin/open-artifact.mjs - Visual checks
archify/bin/visual-check.mjs - HTML artifact
archify/renderers/shared/cli.mjs
Diagram rendering
- Architecture renderer
archify/renderers/architecture/render-architecture.mjs - Workflow renderer
archify/renderers/workflow/workflow-compiler.mjs - Sequence renderer
archify/renderers/sequence/render-sequence.mjs - Dataflow renderer
archify/renderers/dataflow/render-dataflow.mjs - Lifecycle renderer
archify/renderers/lifecycle/render-lifecycle.mjs
Interactive review
- Node search
viewer/node-finder.js - Route and reach
viewer/route-probe.js - Role comparison
viewer/semantic-lens.js - Guided stories
viewer/guided-views.js - Artifact export
viewer/export.js
Evidence and comparison
- Schema validation
archify/renderers/shared/validator.mjs - Source evidence
archify/renderers/shared/repository-evidence.mjs - Brand marks
archify/renderers/shared/brand-marks.mjs - Shared geometry
archify/renderers/shared/geometry.mjs - Architecture delta
archify/delta/architecture-delta.mjs
Other components
- Agent author
Connections 24
- Agent author → Diagram CLI: provides typed JSON
README.md - Diagram CLI → Schema validation: validates schema
archify/renderers/shared/cli.mjs - Diagram CLI → Source evidence: verifies sources
archify/renderers/shared/cli.mjs - Diagram CLI → Brand marks: prepares marks
archify/renderers/shared/cli.mjs - Diagram CLI → Architecture renderer: renders architecture
README.md - Diagram CLI → Workflow renderer: renders workflow
README.md - Diagram CLI → Sequence renderer: renders sequence
README.md - Diagram CLI → Dataflow renderer: renders dataflow
README.md - Diagram CLI → Lifecycle renderer: renders lifecycle
README.md - Diagram CLI → HTML artifact: writes HTML
archify/renderers/shared/cli.mjs - Architecture renderer → Shared geometry: uses geometry
archify/renderers/architecture/render-architecture.mjs - Workflow renderer → Shared geometry: uses geometry
archify/renderers/workflow/workflow-compiler.mjs - Sequence renderer → Shared geometry: uses geometry
archify/renderers/sequence/render-sequence.mjs - Dataflow renderer → Shared geometry: uses geometry
archify/renderers/dataflow/render-dataflow.mjs - Lifecycle renderer → Shared geometry: uses geometry
archify/renderers/lifecycle/render-lifecycle.mjs - Archify command → Open artifact: offers opening
archify/bin/archify.mjs - Archify command → Live preview: offers preview
archify/bin/archify.mjs - Archify command → Visual checks: offers checks
archify/bin/archify.mjs - HTML artifact → Node search: supports search
README.md - HTML artifact → Route and reach: supports route tracing
README.md - HTML artifact → Role comparison: supports role comparison
README.md - HTML artifact → Guided stories: supports guided stories
README.md - HTML artifact → Artifact export: supports export
README.md - Agent author → Architecture delta: compares snapshots
README.md