naqsha architecture

Naqsha Repository Map

the skill, the render pipeline, the gates, the distribution

14 nodes16 edges4 groups
1 / 4

Skill surface

A coding agent loads the skill contract, then runs one CLI command on a small JSON file.

Coding agentreads the skillSkill contracttyped JSON rulesCLI commandssix commands, JSON receiptsIR validatoractionable diagnosticsIR fixernormalizes and repairsFormat importflowchart and sequenceLayout enginedeterministic scene modelHTML composerinlines CSS and SVGViewer runtimetour, diff, searchOffline HTMLsingle file, no networkinstall.shone-command skill installnaqsha-clipublished packageTagged releaseversioned source bundleTest harnessesunit, acceptance, interaction
Legend

Every command returns a JSON receipt; a non-zero exit is never success.

The artifact is one file: no server, no network, no downloaded fonts.

The toolbar exports SVG, PNG, WebP and JPEG, and copies the source JSON.

The installer rewrites the skill root and verifies one real render.