How vgakilan/archweave works
Requirement to Diagram turns a requirement document into an evidence-backed model, selects focused diagram views, and produces Mermaid, SVG, and a written review package. The main path is document parsing → Codex extraction and planning → model validation → package generation and rendering. The repository also supports a Codex skill workflow and standalone parsing or rendering commands. Relationships are based on the README and shown source excerpts; the skill’s internal behavior and unsampled modules are not inferred.
Main entry points: workflow.py Workflow orchestrator · codex_runner.py Codex runner · review_package.py Package generator · run_pipeline.py Pipeline command
Components 20
Inputs and entrypoints
- Requirement document
- Pipeline command
scripts/run_pipeline.py - Codex skill
.agents/skills/requirement-review/SKILL.md - Parse command
scripts/parse_document.py - Review command
scripts/generate_review.py
Requirement analysis
- Parsed Markdown
src/diagram_generator/document_parser.py - Document parser
src/diagram_generator/document_parser.py - Workflow orchestrator
src/diagram_generator/workflow.py - Codex runner
src/diagram_generator/codex_runner.py - Review prompt
prompts/requirement_review.md - Model schema
schemas/requirement.schema.json - Requirement model
src/diagram_generator/requirement_model.py - Model validator
src/diagram_generator/requirement_model.py
Review generation
- Package generator
src/diagram_generator/review_package.py - Mermaid generator
src/diagram_generator/mermaid.py - SVG renderer
src/diagram_generator/renderer.py - Review package
src/diagram_generator/review_package.py
External tools
- Codex CLI
- Mermaid CLI
Other components
- Engineer
Connections 27
- Engineer → Requirement document: provides
README.md - Engineer → Pipeline command: runs
README.md - Pipeline command → Workflow orchestrator: invokes
scripts/run_pipeline.py - Pipeline command → Codex runner: supplies callbacks
scripts/run_pipeline.py - Requirement document → Workflow orchestrator: submits
README.md - Workflow orchestrator → Document parser: parses when needed
src/diagram_generator/workflow.py - Document parser → Parsed Markdown: converts
src/diagram_generator/document_parser.py - Workflow orchestrator → Parsed Markdown: reads
src/diagram_generator/workflow.py - Workflow orchestrator → Codex runner: requests extraction and planning
scripts/run_pipeline.py - Codex runner → Codex CLI: runs
src/diagram_generator/codex_runner.py - Codex runner → Review prompt: loads
src/diagram_generator/codex_runner.py - Codex runner → Model schema: loads
src/diagram_generator/codex_runner.py - Codex runner → Requirement model: extracts
README.md - Workflow orchestrator → Requirement model: writes
src/diagram_generator/workflow.py - Workflow orchestrator → Model validator: validates via
src/diagram_generator/workflow.py - Model validator → Model schema: checks against
src/diagram_generator/requirement_model.py - Workflow orchestrator → Package generator: generates
src/diagram_generator/workflow.py - Engineer → Codex skill: invokes
README.md - Codex skill → Parsed Markdown: analyzes
README.md - Engineer → Parse command: runs
README.md - Parse command → Document parser: calls
scripts/parse_document.py - Engineer → Review command: runs
README.md - Review command → Package generator: calls
scripts/generate_review.py - Package generator → Mermaid generator: generates source
src/diagram_generator/review_package.py - Package generator → SVG renderer: renders SVG
src/diagram_generator/review_package.py - SVG renderer → Mermaid CLI: runs
src/diagram_generator/renderer.py - Package generator → Review package: writes
README.md