SuperDomestique enables progressively autonymous AI software delivery by combining AI-led execution with deterministic governance, explicit engineering constraints and verifiable evidence.
It works from a tracker, moves work through specification, implementation, review, testing, and delivery, and returns unresolved decisions to a person. The aim is simple: make an agentic workload safe to stop watching, one step at a time.
SuperDomestiqueis the project currently implemented and distributed asfaff. Thefaffrepository, skills, plugin and CLI commands retain their existing names while the project evolves.
The delivery system turns intent into shipped work. It helps order a backlog, prepare specifications, build changes, review them, and deliver the result. The tracker remains the place where people set direction and see what happened.
Commissaire is the governance system. It checks the evidence produced by a run, applies deterministic rules at named gates, and stops or parks work when the available evidence is not enough to continue.
Both are part of the current faff repository and distribution. Commissaire
is a logical code boundary today, not a separate service or security boundary.
Autonomy is assigned per workload. A team can keep sensitive work at L1 while letting routine, well-covered work run at L3 on the same board.
| Level | Working relationship | Current position |
|---|---|---|
| L1 | You do the engineering; SuperDomestique helps plan and specify it. | Available |
| L2 | An agent builds one change and waits for approval at the major gates. | Available |
| L3 | An agent drains eligible work unattended; ambiguity is parked for a person. | Current unattended path |
| L4 | A run is intended to proceed without scheduled supervision. | Preview; mechanisms exist, external proof is incomplete |
The levels guide explains the controls and evidence behind each level. The public trust-claim audit records what is enforced, what has been observed, and what remains unproven.
/plugin marketplace add shftwst/faff
/plugin install faff@faff
SuperDomestique currently supports macOS and Linux with Node 20 or later. Native Windows is not supported; use WSL2.
Claude Code is the primary supported harness. Codex has completed an interactive prep-to-merge run with material limitations, and selected read-only producer calls are experimental. Codex unattended L3 and L4 paths are not currently supported. pi.dev is planned, with no implementation work scheduled.
The harness support guide gives the capability matrix, current limitations, and evidence behind each status.
- Run
/faff-onboardto connect the repository and tracker. - Run
/faff-jotto capture new work, or start from an existing ticket. - Run
/faff-wtfto see what is ready and what is stuck. - Run
/faff-prep ISSUE-XXto prepare a specification. - Run
/faff-graft ISSUE-XXto build the change with approval gates.
When the team is ready to try unattended work, mark a narrow, low-risk set of
tickets as eligible and run /faff-beep-boop. Anything the system cannot call
is parked for review.
- The delivery system explains the tracker-led path from intent to delivery.
- Commissaire explains the governance boundary and what its checks can prove.
- Walkthroughs show the first interactive flows.
- Adopting by change class explains how to hand off low-risk work before widening the scope.
- Evidence points to current audits, run records, and known gaps.
- CLI reference documents the
faffcommands.
SuperDomestique is the product. Commissaire is its governance system. faff
remains the plugin, CLI, repository, configuration prefix, and source-level
name. The language guide records the
rule for contributors.
The nlspec format used by faffter-dark-nlspec is inspired by
NLSpec-Spec by TG-Techie. No code
from that project is used.
This project is licensed under Apache-2.0 and will remain Apache-2.0. It is
distributed as the faff plugin and CLI and presented as SuperDomestique; the
same licence covers the work under every name. The code in this repository will
not be relicensed to source-available or more-restrictive terms. Contributions
are accepted inbound = outbound under the same licence, attested per commit by a
Developer Certificate of Origin sign-off
(see CONTRIBUTING). This commitment is recorded in
ADR 0105.
The names SuperDomestique and Commissaire identify this project. Both first appeared publicly on 2026-08-07, reached the README and the documentation site on 2026-08-08, and were adopted as the project's names in ADR 0096 on 2026-08-08. Apache-2.0 §6 grants no trademark rights, so these names remain the project's regardless of forks of the code. No registration is claimed.