Init Quill

Init Quill

Register quill in the project's SDD plugin registry so the conductor can resolve quill's production-chain roles by reading only .agents/universal-plugin.json — no plugin-directory scanning at runtime. This is the lockfile pattern: resolution happens here, at setup.

Workflow

1. Locate the registry file

Look for .agents/universal-plugin.json at the project root. If it exists, read and parse it; otherwise create it with {}.

Fail closed on a corrupt file. If the file exists but contains malformed JSON, fail with an error and stop — do not overwrite it. Silently rewriting a corrupt file could destroy valid entries from other plugins; leave the file untouched and let a human repair it.

2. Determine quill's version

Read quill's own version from its plugin manifest (it ships inside the plugin, so it knows its version for free — no scan). Use it as the version stamp below.

3. Write the quill entry (rewrite-on-init migration)

Find the entry where "name": "quill" in the sdd-plugins array:

• Not found → append the canonical entry (create the array if absent).
• Found, old shape (the pre-operator scenario-advisor / implementer keys, or the legacy domains[] + shared roles/governances) → rewrite it to the squads[] shape below. The conductor never reads the old shape — migration is rewrite-on-init, not a dual-reader.
• Found, squads[] shape, stale version → rewrite when the recorded version differs from quill's own (install / upgrade / manual re-run reconciles drift here; the conductor never compares versions at runtime).

Do not reorder or reformat other entries.

Canonical entry:

{
  "name": "quill",
  "version": "<quill version>",
  "squads": [
    {
      "artifact-types": ["documentation", "guide", "tutorial", "article", "reference"],
      "roles": {
        "spec-producer": "quill-spec-writer",
        "solution-producer": null,
        "spec-judge": null,
        "impl-producer": "quill-doc-writer",
        "impl-judge": "quill-judge"
      },
      "governances": {
        "oracle-spec": null,
        "builder-spec": "quill-builder-spec",
        "builder-impl": "quill-builder-impl",
        "architect-spec": null,
        "architect-impl": null
      }
    }
  ]
}

quill serves its five documentation artifact-types with one squad. spec-judge: null degenerates to the SDD default cold judge, sdd-spec-judge, which spec-gate spawns after resolving the slot. solution-producer: null uses the SDD default. Each null governance uses the SDD default actor-gate bar.

Each squad's governances block is required. Every squad must carry a governances map (each binding may be null, but the block itself must be present). Reject a payload with a squad missing its governances block — fail with an error and do not write the file.

4. Write the updated file

Write .agents/universal-plugin.json back with the updated contents.

5. Report

Confirm:

• .agents/universal-plugin.json written (created or updated)
• quill role-map entry present under sdd-plugins, stamped with quill's version
• Domains registered: documentation, guide, tutorial, article, reference

Next step: use sdd:start-mission to scaffold a documentation spec; the conductor resolves the quill roles automatically.