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:
# archon-demand.md frontmatter
skills:
- archon-code-quality
- archon-test-sync
- archon-async-loading
- archon-error-handling
- archon-handoffAll Drivers
| Driver | OS Equivalent | Activated | Purpose |
|---|---|---|---|
| code-quality | Storage driver | Every code change | File limits, type safety, naming |
| test-sync | FS integrity driver | Every code change | Tests follow code changes |
| async-loading | Display driver | UI component edits | Skeleton, retry, lazy load |
| error-handling | Network driver | API/component edits | Structured error patterns |
| handoff | IPC driver | Cross-boundary changes | Interface contracts |
Framework-Specific Drivers (Optional)
Deployed by /archon-init when a matching framework is detected:
| Driver | Framework | Covers |
|---|---|---|
archon-nextjs-ssr | Next.js | Server Components, hydration safety |
archon-react-hydration | React, Next.js | State initialization, mutation sequencing |
Deployment
During /archon-init, drivers are deployed to environment-specific paths:
| Environment | Deploy Path | Preload 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 |
| Other | Project-local skills directory | ❌ read manually |
Evolution
Drivers evolve through a controlled lifecycle:
Discover problem → proposed-rules.md → User approval → Driver updateStage 3.6 of /archon-demand proposes new prohibitions. They are staged in proposed-rules.md and only graduate to drivers after human approval.