Directory structure

DevSnips/
├── library/                          CANONICAL — all UI resources
│   ├── React/
│   │   ├── Components/<Family>/<variant>/
│   │   ├── Sections/<Family>/<direction>/
│   │   ├── Templates/<template>/     (Vite/TS projects)
│   │   ├── DESIGN_TOKENS.md          token docs (non-resource)
│   │   └── index.html                gallery page (non-resource)
│   ├── Tailwind/
│   │   ├── Components/<Family>/<variant>/          (2-level; Buttons uses 3-level groups)
│   │   ├── Sections/<Category>/<style>/            (single-concept)
│   │   ├── Sections/<Category>/<section>/<style>/  (multi-concept)
│   │   ├── Templates/<template>/
│   │   ├── Components/STYLE_TOKENS.md
│   │   └── index.html
│   └── Vanilla/
│       ├── Components/<Family>/<variant>/          (incl. legacy Navigation sub-families)
│       ├── Sections/<Family>/<variant>/            (neo-brutalist sections)
│       ├── Templates/<template>/                   (code under pages/)
│       ├── Components/tokens.css + DESIGN_TOKENS.md
│       └── Sections/sections-index.html, sections-showcase.html
│
├── snippets-index.json               GENERATED — the machine-readable registry
├── index.html                        root tech landing page
│
├── cli/                              the npm package `devsnips`
│   ├── package.json                  name devsnips, bin → src/index.js, node >=18
│   ├── src/index.js                  entry + command dispatch
│   ├── src/commands/add.js           `add` implementation
│   ├── src/commands/init.js          `init` implementation
│   ├── src/registry/resolver.js      registry fetch + path resolution
│   ├── src/install/downloader.js     file selection + download
│   ├── src/install/writer.js         destination + safe writes
│   ├── src/devsnips/{config,agents,context}.js   project context
│   ├── src/utils/{paths,errors}.js   path safety + error formatting
│   └── test/*.test.js                node:assert suites (no framework)
│
├── agents/
│   ├── skills/devsnips/
│   │   ├── SKILL.md                  published agent skill (v1.0.1)
│   │   └── references/               cli_reference.md, registry_schema.md,
│   │                                 accessibility_responsive_checklist.md
│   └── resources/                    repository-side deep agent docs
│       ├── architecture.md, resources.md, cli.md, indexing.md,
│       ├── qa.md, workflows.md, conventions.md
│       ├── frameworks/{react,tailwind,vanilla}.md
│       └── indexes/*.json            GENERATED — specialized indexes
│
├── scripts/
│   ├── tooling/validators/           validate.py, deep_check.py,
│   │                                 check_md_links.py, check_agent_doc_paths.py
│   ├── tooling/indexing/             rebuild_index.py, build_resource_indexes.py,
│   │                                 validate_indexes.py
│   ├── tooling/tests/                stdlib unittest suite for the tooling scripts
│   ├── tooling/generators/           Tailwind section builders
│   ├── tooling/utilities/            one-off migration/repair scripts
│   └── qa/resources/                 qa_vanilla.py + Playwright harnesses
│
├── docs/                             contributor + platform documentation (this tree)
│   └── …                             see docs/index.md for the map
│
├── integrations/mcp/                 read-only MCP server (`devsnips-mcp`)
├── reports/                          audit reports
└── .github/
    ├── PULL_REQUEST_TEMPLATE.md      PR template
    └── workflows/ci.yml              CI: validators, index drift, doc links, CLI tests
 
Generated and NOT committed (absent from a clean checkout):
└── devsnips/                         CLI `init` output, created in a user project