docs: ArghDA vision, architecture & roadmap#1
Merged
Conversation
Adds docs/arghda-vision.adoc — the wider plan for ArghDA as the estate's visual proof-wiring / wiring-diagram tool, complementing the existing MVP spec (arghda-spec.adoc). Covers: - The hard boundary: ArghDA organises/visualises/communicates proofs; Agda proves (directly or via Echidna). It never proves anything. - The motivating pain mined from echo-types and absolute-zero (orphan modules, hidden postulates, invisible dependency order, drifting status tables, refuted-route re-walks, merge drift). - Three-layer architecture: Rust arghda-core (engine) + AffineScript arghda-studio (the visual tool, → typed-wasm/Deno-ESM) + arghda-panll (PanLL embedding), with a decision record. - The honest AffineScript feasibility position and the static-SVG/HTML resolution for v1 (pure renderers sidestep the broken interactive path; interactive canvas deferred with ArghDA as the forcing function). - The single richly-tagged proof-node graph data model (status x soundness x dependency x glyph x multi-register narrative). - The full feature set: take-from / visualise / put-back. - The communication model adapted from nextgen-language-evangeliser (RAW/FOLDED/GLYPHED registers, Makaton-style glyphs, 5-slot no-shame narrative, audience-parameterised, honest-scope labelling). - Integration seams: Echidna (Zig API service #3), TypeLL obligations, HAR programmatic stage, Groove discovery, kategoria + ideas-to-alphas. - RSR-compliant shape for the proposed arghda-studio repo and the arghda-core work needed to finish the spec. - A six-phase roadmap and an open-decisions/risks register. Planning artefact only; no engine or proof code changed. Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_019GiSiEfgZCte35dyykgBHs
hyperpolymath
marked this pull request as ready for review
June 18, 2026 11:50
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
What this is
A planning artefact —
docs/arghda-vision.adoc— that plans out ArghDA as the estate's visual proof-wiring / wiring-diagram tool, complementing the existing MVP spec (docs/arghda-spec.adoc). No engine or proof code is touched.It was synthesised from a read-only survey of
arghda-core,rsr-template-repo/standards,kategoria,ideas-to-alphas,typell,nextgen-typing,panll,affinescript,developer-ecosystem,hybrid-automation-router,echo-types,absolute-zero, andnextgen-language-evangeliser.Key decisions captured
arghda-coreengine + a new AffineScriptarghda-studiovisual tool (→ typed-wasm / Deno-ESM) + a laterarghda-panllPanLL embedding.All.agda/Smoke.agda, sync labels, emit ledgers & session-arcs, export CI gates).nextgen-language-evangeliser: RAW/FOLDED/GLYPHED registers, Makaton-style glyphs, a 5-slot no-shame narrative, audience-parameterised, honest-scope labelling.ProofObligations (:7800); HAR for the "proofs go programmatic" stage; Groove discovery for PanLL;kategoria's composition lattice +ideas-to-alphas' graduation pipeline as proof-state sources.arghda-studiorepo, thearghda-corework needed to finish the spec, a six-phase roadmap, and an open-decisions/risks register.Status
Draft, for review. This is the plan, not the build — it sets up the next phases (finishing the engine, scaffolding
arghda-studio).🤖 Generated with Claude Code
https://claude.ai/code/session_019GiSiEfgZCte35dyykgBHs
Generated by Claude Code