@erclx/aitk 3.14.2 → 3.15.0

package/claude/.claude-plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "aitk",
   "description": "Automated governance, versioning, and discovery tools for Claude Code.",
-  "version": "3.14.2",
+  "version": "3.15.0",
   "author": {
     "name": "Eric Le",
     "url": "https://github.com/erclx"

package/claude/skills/claude-design-extract/SKILL.md

@@ -30,7 +30,7 @@ The greenfield path needs a personality paragraph to propose against, and stops
 
 Read these on both paths, skipping any that do not exist:
 
-- `CLAUDE.md`: voice, personality, spelling rules
+- `CLAUDE.md`: voice and personality
 - `.claude/REQUIREMENTS.md`: the `## Personality` paragraph, worldview, non-goals
 - `${CLAUDE_SKILL_DIR}/../../standards/markdown.md`: word, punctuation, and formatting constraints
 - The `write-human` skill: tone and sentence construction constraints

package/governance/rules/claude/511-indexes.md

@@ -0,0 +1,14 @@
+---
+description: Route index.md edits to the regeneration verb, its frontmatter contract, and the hand-edit opt-out
+paths:
+  - '**/index.md'
+---
+
+# Index standards
+
+## Generation
+
+- Do not hand-edit an `index.md` that an agent browses to pick a document. Run `aitk indexes regen` instead.
+- Preserve an `index.md`'s own frontmatter (`title`, `subtitle`). The regen walker keeps it.
+- Add `auto: false` to an `index.md`'s frontmatter to keep that folder's index hand-edited.
+- Skip `index.md` in a code folder or a scratch folder. Neither needs one.

package/governance/rules/core/065-spelling.md

@@ -0,0 +1,19 @@
+---
+description: Route .cspell/ dictionary additions to the right seeded file and keep each sorted
+paths:
+  - '.cspell/**'
+---
+
+# Spelling standards
+
+## Dictionary routing
+
+- Rewrite a typo rather than adding it. Add only a real term.
+- Add a term from a tool, library, or platform the project depends on to `.cspell/tech-stack.txt`, whether it is the dependency's own name or vocabulary from its config, API, or spec.
+- Add jargon, an acronym, a handle, or another project-specific term to `.cspell/project-terms.txt`.
+- Leave a dictionary declared `addWords: false` alone. It mirrors a closed set maintained elsewhere in the project rather than approved vocabulary, so route a word there through whatever maintains that set instead of editing the dictionary file.
+- Add a third dictionary only when cspell still flags a term neither file covers. Declare its path in `cspell.json` with `addWords: true` before adding words to it.
+
+## File shape
+
+- Keep every dictionary file sorted alphabetically.

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@erclx/aitk",
   "type": "module",
-  "version": "3.14.2",
+  "version": "3.15.0",
   "description": "Infrastructure and quality tooling for developer workflows",
   "license": "MIT",
   "bin": {

package/tooling/claude/seeds/CLAUDE.md

@@ -31,8 +31,6 @@
 ## Indexes
 
 - Check a folder's `index.md` before grepping its source or reading its files, starting with `.claude/context/` for a domain and `.claude/wireframes/` for a UI surface. It orients faster than a blind search.
-- For folders where an agent browses to pick a document, `index.md` is regenerated from each file's frontmatter. Do not hand-edit `index.md`. Code folders and scratch folders do not need one.
-- Every `index.md` carries its own frontmatter (`title`, `subtitle`) that the walker preserves. To keep a folder's `index.md` hand-edited, add `auto: false` to its frontmatter.
 
 ## Commands
 
@@ -60,11 +58,6 @@
 - `.claude/rules/`: path-scoped coding standards loaded by Claude Code on file match
 - `.claude/review/`: gitignored scratch for review and UI-test output, overwritten on each run
 
-## Spelling
-
-- When cspell flags a word, rewrite typos. Add real terms to the appropriate dictionary in `cspell.json`.
-- Keep dictionary files sorted alphabetically
-
 ## Tasks
 
 - `.claude/tasks/` is gitignored local session scratch, one file per task. Edit freely. No staging or revert before commits.