kubit-validating-design

aniftyco 的头像作者 aniftyco

在对 sculpture/、packages/core/ 或 docs/ 进行任何更改后使用。用于验证类型编译和文档是否同步。

📖 中文导读:在对 sculpture/、packages/core/ 或 docs/ 进行任何更改后使用。用于验证类型编译和文档是否同步。 以下正文为该技能的原始 SKILL.md 内容(英文),上方安装命令可直接使用。

name: kubit-validating-design description: Use after any change to skeleton/, packages/core/, or docs/. Use to verify types compile and documentation is synchronized.

Validating Kubit Design Changes

Overview

After any change, verify types compile and docs are synchronized.

When to Use

  • After modifying skeleton/ files
  • After changing packages/core/ types
  • After updating docs/
  • Before considering a task complete

Validation Checklist

After ANY change:
[ ] tsc --noEmit passes in skeleton/
[ ] SPEC.md updated if API changed
[ ] SKELETON_APP.md updated if structure changed
[ ] CLAUDE.md updated if docs/ changed

Type Validation

Run from skeleton/ directory:

cd skeleton && npx tsc --noEmit

Common failures:

  • Missing type in packages/core/ for new skeleton usage
  • Import path typo
  • Decorator usage not matching type signature

Documentation Sync

If you changed... Also update...
skeleton/ structure docs/SKELETON_APP.md
API in packages/core/ docs/SPEC.md
Any file in docs/ .claude/CLAUDE.md
Test expectations docs/TEST_PLAN.md

Quick Verification Commands

# Type check
cd skeleton && npx tsc --noEmit

# List skeleton structure (compare to SKELETON_APP.md)
find skeleton -type f -name "*.ts" -o -name "*.tsx" | sort

Red Flags

  • Added to skeleton without adding types → tsc will fail
  • Changed API without updating SPEC → spec drift
  • Modified docs/ without updating CLAUDE.md → agent confusion
  • New pattern not in SKELETON_APP.md → incomplete documentation