Files
Joseph Magly afc9dad1b2 chore(aiwg): adopt shared BT6 maintainer workflow (#148)
* docs(policy): allow low-impact contributor courtesy cleanup

* chore(aiwg): migrate to shared BT6 maintainer plugin

* chore: reconcile delivery validation
2026-08-02 17:17:28 -04:00
..

BT6 Maintainer Plugin

Cross-repository maintenance for BT6 research and support tooling. The plugin provides queue audit, pull-request audit, external-provider assessment, issue stewardship, and conservative merge-train workflows that adapt to each repository's configured tracker, delivery policy, validation commands, and research/data risk surfaces.

What this is

A marketplace delivery wrapper whose payload is the bt6-maintainer addon. It generalizes the proven T3MP3ST maintainer workflow for BT6 codebases without assuming a particular repository, tracker host, language, or application stack.

The core is read-only by default. Comments, labels, issue closure, reviews, merges, releases, and other tracker mutations require explicit operator authorization after the exact target repository and current PR head SHA have been verified.

Layout

.aiwg/plugins/bt6-maintainer/
├── manifest.json          # Bundle metadata (validated by aiwg)
├── README.md              # This file
└── payload/
    ├── manifest.json      # Portable addon payload
    ├── config/            # Repository profile schema
    ├── agents/
    ├── skills/
    ├── rules/
    ├── capabilities/
    ├── templates/
    └── provenance/

Usage

On AIWG 2026.7.24 or newer, place the wrapper under the consuming repository's .aiwg/plugins/ directory and deploy it directly:

consumer_root=/absolute/path/to/consumer
mkdir -p "$consumer_root/.aiwg/plugins/bt6-maintainer"
cp -R .aiwg/plugins/bt6-maintainer/. \
  "$consumer_root/.aiwg/plugins/bt6-maintainer/"
cd "$consumer_root"
aiwg use bt6-maintainer

Direct Git installation of a standalone repository that contains its wrapper at .aiwg/plugins/<id>/ is tracked by AIWG #1997. Until that lands, pin and copy the wrapper or extract a packaged provider archive rather than accepting an unknown zero-artifact install.

Create .aiwg/bt6-maintainer.yaml in a consuming repository using payload/templates/bt6-repository-profile.yaml as the starting point. When the file is absent, the skills derive safe read-only defaults from git and .aiwg/aiwg.config; they must stop rather than guess when tracker authority or the canonical repository is ambiguous.

Inspect health:

aiwg doctor --project-local

AIWG #1998 currently prevents reliable automated removal of freshly deployed namespaced skill files. Inspect provider paths and preserve the registry record needed for recovery; do not use --force without verifying exact ownership.

Packaging status

The wrapper follows AIWG's project-local plugin schema and contains an addon payload under payload/. AIWG 2026.7.24 validates, packages, and directly deploys the wrapper. Remaining lifecycle gaps are:

  • #1996 — legacy install-plugin --source crashes;
  • #1997 — aiwg install does not discover nested standalone wrappers and reports zero-artifact success;
  • #1998 — immediate deploy/remove misclassifies generated skill files as mutated.

Validate the wrapper and smoke-test its payload:

npm run check
npm run test:smoke

The smoke test deploys the payload as a project-local addon in an isolated temporary repository for provider parity. Direct wrapper deployment is also covered during adoption; automated removal remains outside the passing smoke gate until #1998 is resolved.

Supported repository families

  • Research acquisition, corpus, citation, and provenance tools.
  • Knowledge-base, indexing, search, and synthesis services.
  • Analyst and support utilities with local and hosted model integrations.
  • CLI, API, web, and MCP tools that share backend/frontend contracts.
  • Libraries and automation repositories with similar issue/PR operations.

Provider support

  • Claude: full addon deployment (agents, skills, and guardrail rule).
  • Codex: full deployment through AIWG's shared Agent Skills surface plus agent TOMLs and guardrail rule on AIWG 2026.7.24 or newer.

Source and license

This work is derived from the T3MP3ST project-local maintainer addon at commit b192577b5462d2f7388e91c83b4cb2874ab99c03. See payload/provenance/SOURCE.md. The source and this derivative are licensed under AGPL-3.0.