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
1 parent 8f658891f2
commit afc9dad1b2
@@ -0,0 +1,114 @@
+# 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:
+
+```bash
+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:
+```bash
+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](https://git.integrolabs.net/roctinam/aiwg/issues/1996) — legacy
+  `install-plugin --source` crashes;
+- [#1997](https://git.integrolabs.net/roctinam/aiwg/issues/1997) — `aiwg install`
+  does not discover nested standalone wrappers and reports zero-artifact success;
+- [#1998](https://git.integrolabs.net/roctinam/aiwg/issues/1998) — immediate
+  deploy/remove misclassifies generated skill files as mutated.
+
+Validate the wrapper and smoke-test its payload:
+
+```bash
+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.