Skip to content

Drivers

Loaded into kernel space via the skills: field. Drivers are not suggestions — they are law.

Drivers are constraint skills that define hard boundaries (❌ prohibitions). Like hardware drivers that translate high-level intent into low-level enforcement, constraint skills translate "write good code" into "no any type, no empty catch."

Loading Mechanism

Drivers are injected into the agent's context alongside the kernel via the skills: field in agent YAML frontmatter — the equivalent of modprobe in Linux:

yaml
# archon-demand.md frontmatter
skills:
  - archon-code-quality
  - archon-test-sync
  - archon-async-loading
  - archon-error-handling
  - archon-handoff

All Drivers

DriverOS EquivalentActivatedPurpose
code-qualityStorage driverEvery code changeFile limits, type safety, naming
test-syncFS integrity driverEvery code changeTests follow code changes
async-loadingDisplay driverUI component editsSkeleton, retry, lazy load
error-handlingNetwork driverAPI/component editsStructured error patterns
handoffIPC driverCross-boundary changesInterface contracts

Framework-Specific Drivers (Optional)

Deployed by /archon-init when a matching framework is detected:

DriverFrameworkCovers
archon-nextjs-ssrNext.jsServer Components, hydration safety
archon-react-hydrationReact, Next.jsState initialization, mutation sequencing

Deployment

During /archon-init, drivers are deployed to environment-specific paths:

EnvironmentDeploy PathPreload Support
Cursor.cursor/rules/archon-*.md or .cursor/skills/archon-*/SKILL.md✅ via skills: field
Claude Code.claude/skills/archon-*/SKILL.md✅ via skills: field
Codex.codex/skills/archon-*/SKILL.md❌ read manually
OtherProject-local skills directory❌ read manually

Evolution

Drivers evolve through a controlled lifecycle:

Discover problem → proposed-rules.md → User approval → Driver update

Stage 3.6 of /archon-demand proposes new prohibitions. They are staged in proposed-rules.md and only graduate to drivers after human approval.

Powered by AAEP (AI Architect Evolution Protocol)