Monorepo for two VS Code extensions plus an extension pack that bundles them.
| Package | ID | Domain | Status |
|---|---|---|---|
packages/minspec |
aiclarity.minspec |
minspec.dev | SDD Implement |
packages/scroogellm |
aiclarity.scroogellm |
scroogellm.com | SDD Specify (future) |
packages/shared |
@aiclarity/shared |
— | Shared classifier |
packages/extension-pack |
aiclarity.minspec-pro |
— | Bundles both |
MinSpec — complexity-adaptive spec-driven development. Classifies changes into tiers and applies proportional ceremony. One-line fix = one sentence of spec. Architecture rewrite = full treatment. Works with zero AI tools installed.
ScroogeLLM — LLM proxy that minimises token spend. Anonymises PII, caches aggressively, downgrades models when the task allows. Every token counts.
MinSpec Pro — extension pack referencing both. Unlocks spec-conformance checks that use ScroogeLLM as the inference layer.
Rules every change must preserve. See CLAUDE.md for full list.
- No AI dependency — core path makes zero AI calls.
- Tiered network consent (DR-004) — Tier 0 fully offline. No
http/fetchinpackages/minspecorpackages/shared. - No lock-in — Spec Kit-compatible markdown, no proprietary format.
- Ceremony proportional to complexity.
- User override always wins — classifier suggests, human decides.
- Harness regeneration preserves user edits (merge, not overwrite).
- All LLM calls go through proxy.
- Savings auditable — raw vs actual cost logged per request.
- PII anonymisation deterministic.
- User API keys in OS keychain only.
- Proxy binds localhost by default.
- Free-tier optimisations always active.
npm test # all packages
npm run lint
npm run build
npm run validate # frontmatter check on specs/**/*.md
# Package one extension
cd packages/minspec && npm run package # → .vsix
# Publish (requires vsce token)
cd packages/minspec && npx vsce publishspecs/<product>/ SDD artifacts (requirements, design, tasks)
docs/decisions/DR-NNN.md Architectural decisions (see INDEX.md)
docs/research/ Background research
sites/minspec.dev/ Marketing site
sites/scroogellm.com/ Marketing site
packages/ Workspaces
scripts/hooks/ Pre-commit + dispatch
Spec-driven development. Three phases per product: Specify → Plan → Implement. MinSpec is at Implement. ScroogeLLM has not started Specify.
Bug fixes follow the Bug Session Protocol — reproduce, diagnose, fix, harden. No code changes in phases 1–2.
All architectural decisions land in docs/decisions/ as DR-NNN.md.
MIT. Publisher: aiclarity.