AI-config

Management portal for the ai-config project — Talbot’s unified AI tool configuration system.

Project: \\wsl$\Ubuntu-24.04\home\ta\ai-config\README.md WSL path: /home/ta/ai-config/

What It Is

Single source of truth for all AI tool configurations across WSL and Windows. Edit in ai-config/, commit, and a post-commit hook deploys to all targets automatically.

Tools managed:

Claude Code — CLAUDE.md, settings.json, mcp.json, keybindings.json, commands/ (skills)
Cursor IDE — .cursor/rules/ (Markdown rule files)
Gemini (AntiGravity) — antigravity/skills/

Key Architecture Decisions

AGENTS.md as SSOT for ongoing projects: For projects using multiple AI tools (Claude Code + Cursor + Gemini), AGENTS.md at project root is the universal AI context source. CLAUDE.md and GEMINI.md are thin wrappers that reference it. Existing projects with substantial CLAUDE.md files keep them as interim SSOT until migration is warranted.

Global CLAUDE.md points at SSOT docs, doesn’t embed them: To keep CLAUDE.md lean, bulk rule content lives in KB SSOT docs and CLAUDE.md carries only identity + hard rules + pointers. Agent self-testing methodology → AI-Testing-Standards (Core/AI/AI-Testing-Standards.md); dev standards + WSL/cache gotchas → GlobalDevRules. (ai-config-rules-upgrade Phase 1, 2026-07-06.)

Skill creation → Dashboard update: After creating or deleting any skill, update D:\FSS\KB\Core\AI\Skills\DASHBOARD.md. This is mandatory — tracked in global ~/.claude/CLAUDE.md.

Skill file locations:

User skills: ~/.claude/skills/[name]/SKILL.md
Commands (slash): ~/.claude/commands/[name].md (source in ai-config/claude/commands/)
Plugin skills: installed via Claude Code plugin system

Multi-LLM config pattern:

ai-config/
├── claude/         → ~/.claude/ (WSL) + Windows
├── cursor/rules/   → monorepo/.cursor/rules/
└── antigravity/    → Gemini IDE skills

Ongoing Maintenance

Task	When	How
Skills Dashboard update	After any skill create/delete	Edit `Core/AI/Skills/DASHBOARD.md`
Deploy config changes	After any edit in `ai-config/`	`cd ~/ai-config && git commit -m "..." && ./deploy.sh`
Sync CLAUDE.md	Source is `ai-config/claude/CLAUDE.md`; deployed to `~/.claude/CLAUDE.md`	via deploy.sh
Cursor rules sync	Source is `ai-config/cursor/rules/`; deployed to `monorepo/.cursor/rules/`	via deploy.sh

Status, Plan & Upgrades (SSOT in repo)

This is an ongoing project (AI dept). To avoid duplication, live state and plans live in the repo, not here:

State: ~/ai-config/STATUS.md
Long-term plan: ~/ai-config/ROADMAP.md
Future ideas: ~/ai-config/UPGRADES.md
History: ~/ai-config/CHANGELOG.md

Rules architecture (as of 2026-07-06, ai-config-rules-upgrade all 4 phases done, project closed 2026-07-07): AGENTS.md is the universal SSOT of global rules; deploy.sh concatenates it into the deployed CLAUDE.md (WSL + Windows); bulk content lives in KB SSOT docs pointed at from AGENTS.md; dept work loads a charter chain, not the monolith. Closure log: Core/AI/Logs/2026-07-07_ai-config-rules-upgrade-project-closure.md.

Registry: Ongoing Projects.

KB-OS Context System — what the tools configured here are for. ai-config installs and versions the mechanisms (hooks, skills, qmd config, CLAUDE.md chain); the Context System doc maps how they supply context to agents & humans. Change a mechanism here; document its purpose there.
Skills Dashboard — full skill inventory
AI-Testing-Standards — SSOT for agent self-testing (referenced by global CLAUDE.md)
Claude-Code — Claude Code setup and configuration
Cursor — Cursor IDE setup
Tools-and-Platforms — Gemini, AntiGravity, and other AI tools

AI-config

What It Is

Key Architecture Decisions

Ongoing Maintenance

Status, Plan & Upgrades (SSOT in repo)

Related