Skip to content

Add data-modeling-principles reference + schema-review skill (v0.4.0) - #16

Merged
cultron merged 3 commits into
mainfrom
proposal/data-modeling-principles
Aug 9, 2026
Merged

cultron merged 3 commits into
mainfrom
proposal/data-modeling-principles

Conversation

@cultron

@cultron cultron commented Aug 9, 2026

Copy link
Copy Markdown
Contributor

Extracts the DB-engineering rigor into a reusable reference and adds a database-architect review skill, so schema quality is consistent across the CLI/Claude Code plugin and (via the neutral bundle, mavric#57) the in-app AI harness.

Changes

  • references/data-modeling-principles.md (new) — normalization/3NF, interactions-as-events (not counters), junction entities, indexing strategy, scale/Big-O (N+1, cardinality, pagination, read/write tradeoffs), and a design review checklist. Written in correct .apsorc v2 format (text/scopeBy/indexes/unique/nullable).
  • skills/schema-review/SKILL.md (new, category: data) — audit/harden an existing schema; composes the principles reference; outputs prioritized findings + exact .apsorc fixes.
  • skills/schema-designer/SKILL.md — now composes the principles reference; links schema-review.
  • taxonomy.md + plugin README.md — register schema-review (data bucket).
  • Version bump 0.3.3 → 0.4.0 (minor; new skill) in plugin.json + marketplace.json.

Content is generic DB-design guidance + the public .apsorc format — no proprietary/internal content.

cultron and others added 3 commits August 8, 2026 19:11
…chema-designer composes them

DRAFT for review — do not publish until content-reviewed (public repo).
- references/data-modeling-principles.md: ported DB-engineering rigor (3NF, event-vs-counter, indexing/Big-O, review checklist), in correct .apsorc v2 format.
- skills/schema-review/SKILL.md (category: data): audit/harden an existing schema; composes the principles.
- schema-designer: references the principles + links schema-review.

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…EADME

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
…+ data-modeling-principles)

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@cultron
cultron merged commit 6f71334 into main Aug 9, 2026
1 check passed
@cultron
cultron deleted the proposal/data-modeling-principles branch August 9, 2026 00:45
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant