spb/tools-spboucher-ai

1# Taxonomy and governance23Two levels: 8 disciplines → 66 leaf categories (`content/categories.json`). Tools attach to **leaf** categories only; exactly one is primary (breadcrumb, "More in…" block), others may carry an explanatory `label` (e.g. DuckDB → *High-frequency financial analysis* — "Common engine for Parquet tick/bar archives").45| Discipline | Leaves |6|---|---|7| Artificial Intelligence | ai-assistants, model-providers, local-inference, model-training, agent-frameworks, coding-agents, llm-ops, embeddings-vector-search, speech-vision-multimodal |8| Software development | programming-languages, ide-editors, terminals-shells, version-control, ci-cd, testing-qa, documentation, api-development, web-frameworks |9| Infrastructure & operations | containers-virtualization, infrastructure-provisioning, reverse-proxies-web-servers, dns-domains, tunneling-remote-access, monitoring-observability, security-tools, identity-access, secrets-management, backup-recovery, cloud-hosting |10| Apple platforms & Apple Silicon | macos-automation, apple-silicon-ml, swift-development, macos-utilities, distributed-computing |11| Data engineering & databases | data-collection-crawling, search-apis, web-archiving, etl-elt, messaging-queues, relational-databases, nosql-databases, vector-databases, analytics-engines, dataframes-arrays, bi-dashboards, notebooks, data-catalogs, data-visualization, data-quality |12| Academic research | academic-discovery, citation-management, latex-typesetting, academic-writing, math-stats-tools, reproducibility, econometrics-causal-inference, hf-finance-research, market-data-apis, sec-filings, research-dissemination |13| Finance, real estate & business | financial-analysis-investing, portfolio-management, real-estate-valuation, gis-mapping, construction-estimating, open-public-data, crm-business |14| Productivity & knowledge | productivity-suites, knowledge-management, design-prototyping, collaboration-communication |1516## Tags and use cases17Free but normalized vocabularies (`tags.kind = tag | use_case`), kebab-case. Tags are nouns (`vector-search`), use cases are verb phrases (`analyze-intraday-data`). Both are searchable at weight B and filterable (`/tools?tag=…`, `/tools?use=…`). Admin → Tools lists counts; merge synonyms by editing records (there is no separate tag table UI by design: tags are derived from records).1819## Governance20- Adding a leaf: edit `content/categories.json`, document it here, run `pnpm content:import`. Removing a leaf requires moving its tools first (FK is RESTRICT).21- Keep leaves broad enough to hold ≥ 5 tools; prefer labels over new leaves for nuance.22- Known tension (from the content audit): full-text search engines (Meilisearch, Typesense, Elasticsearch) sit under *vector-databases*; ORMs under *web-frameworks*; object storage under *backup-recovery*. Candidate leaves for the next revision: `search-engines`, `orm-data-access`, `object-storage`.23- The taxonomy owner is the site editor; changes are recorded in the audit log through imports.24