Ai Configuration

AI Configuration

Claude Code and OpenCode operate at full parity — 5 agents, 5 rules, 7 skills / 9 commands. The configuration ecosystem spans global defaults, project overrides, and extension-triggered rules that auto-load without explicit invocation.

Layer Architecture

Configuration resolves in order: Global → Project → Rules (auto-loaded by extension).

~/.claude/
├── CLAUDE.md              # Behavioral constraints, standards
├── settings.json          # Permissions, hooks, env vars
├── rules/                 # Auto-loaded by file extension
│   ├── asciidoc.md
│   ├── bash-shell.md
│   ├── d2-diagrams.md
│   ├── lua-nvim.md
│   └── python.md
├── skills/                # Slash commands (/deploy, /worklog, etc.)
├── agents/                # Specialized AI agents
└── hooks/                 # ShellCheck, AsciiDoc validation, security

Project-level .claude/ directories override or extend global config. All global config stowed from dots-quantum via GNU Stow.

Agents (5)

Agent Model / Access Purpose

doc-auditor

Haiku, read-only

Audit documentation for standards compliance

adoc-linter

Haiku, read-only

Lint AsciiDoc files for attribute usage, TOC violations, xref correctness

build-fixer

Sonnet, full tools

Diagnose and fix Antora build failures

project-modularizer

Sonnet, full tools

Convert monolithic documents into STD-001 project structure

reviewer

Haiku, read-only

Review content for quality, accuracy, and completeness

Rules (5)

Rule File Scope

asciidoc.md

Auto-loaded for *.adoc — attribute enforcement, no TOC, xref format

bash-shell.md

Auto-loaded for *.sh — ShellCheck compliance, idempotency patterns

d2-diagrams.md

Auto-loaded for *.d2 — layout, styling, connection conventions

lua-nvim.md

Auto-loaded for *.lua — Neovim plugin patterns, Lua idioms

python.md

Auto-loaded for *.py — type hints, docstrings, project conventions

Rules activate automatically when editing matching file types. No explicit invocation required.

Skills (7)

Skill Status Purpose

/deploy

Active

Deploy spoke repos to Cloudflare Pages via domus-docs

/worklog

Active

Create and manage daily worklogs with section partials

/session

Active

Create collaboration session logs with commits, agents, modes

/project

Active

Manage projects per STD-001 (create, audit, add-phase, status)

/capture-idea

Active

Scaffold ideas as projects or draft documents

/save-commands

Active

Save CLI commands to quick-commands codex with context and tags

/simplify

Active

Review changed code for reuse, quality, and efficiency

OpenCode Parity

Nine commands in OpenCode mirror Claude Code skills:

Command Purpose Parity Status

audit-adoc

Lint AsciiDoc files

Ported

build-check

Run Antora build validation

Ported

cost-report

Token usage and cost tracking

Ported

deploy

Spoke deployment

Ported

worklog

Daily worklog management

Ported

session

Session log creation

Ported

project

Project management

Ported

capture-idea

Idea scaffolding

Ported

save-commands

Command capture

Ported

Full parity: 6/6 core skills ported. Three additional commands (audit-adoc, build-check, cost-report) are OpenCode-native.

Context Library

The context library provides domain-specific knowledge to AI assistants:

  • 13 CLAUDE.md files — one per spoke repo, defining component-specific invariants

  • 8 context files — domain-specific knowledge (networking, security, infrastructure)

  • 3 global baselines — behavioral constraints, CLI coaching, AsciiDoc standards

All context files stored in examples/claude/ for reference and portability.

Governing Standards

Standard Scope

STD-007

Delegation Boundary — execution requires explicit grant

STD-008

CLI Quality — verify-before/change/verify-after pattern

STD-004

AsciiDoc — attributes over literals, no inline TOC

STD-006

Secrets — never decrypt, never surface values, document paths only