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
This commit is contained in:
Joseph Magly authored and GitHub committed 2026-08-02 17:17:28 -04:00
1 parent 8f658891f2
commit afc9dad1b2
89 files changed
+4683 -1512

No files matched your search

+82 -16
View File
@@ -1,24 +1,90 @@
# Iteration 001 Plan — Architecture Alignment
**Sprint goal:** Make current-state architecture and vision alignment maintainable, testable governance assets.
## 1. Iteration Overview
## Planned Work
- **Iteration:** 001
- **Phase:** Brownfield Construction / governance alignment
- **Status:** Planned; dates and named staffing require maintainer assignment
- **Goal:** Make current-state architecture, safety traceability, maturity claims, and workload evidence maintainable automated governance assets.
1. Review and accept/amend SAD and ADR-001–005 with maintainers.
2. Reconcile canonical repository identity in package metadata and tracker configuration.
3. Add a documentation audit that detects stable/experimental/roadmap conflicts across README, FEATURES, SAD, and vision alignment.
4. Map each network-capable arsenal adapter to scope/approval tests.
5. Establish performance baselines for source ingestion and concurrent mission tasks.
6. Triage the 18 TODO/FIXME/HACK/XXX markers identified during intake.
## 2. Goals and Evaluation Criteria
## Definition of Done
| Goal | Pass condition |
| --- | --- |
| Validate baseline decisions | Maintainer review records accept/amend/supersede outcome for SAD and ADR-001–005. |
| Automate maturity consistency | CI or a documented release check detects contradictory stable/experimental/research/roadmap labels. |
| Complete adapter safety inventory | Every network-capable adapter maps to scope, approval class, credential behavior, timeout, and negative tests. |
| Establish workload evidence | Source-ingest and concurrent-mission baseline receipts state revision, command, workload, environment, samples, and percentiles. |
| Triage debt markers | Each in-scope marker is actionable, intentional, or obsolete with owner/disposition. |
- Maintainer decisions are reflected in accepted/superseded ADR status.
- CI or a documented release check validates maturity claim consistency.
- Safety-test coverage matrix has no unidentified network adapter.
- Baseline measurements include command, corpus, environment, and receipt.
- No roadmap capability is presented as current stable architecture.
## 3. Scope of Work
## Dependencies and Risks
**In scope:** SDLC artifact review; canonical repository identity decision; maturity audit design/implementation; adapter safety/test mapping; workload benchmark design/execution; debt-marker triage.
Owner validation is needed for repository identity and roadmap priority. Architecture documentation changes are non-runtime, but any resulting safety-control change requires the full security and claim gate suite.
**Out of scope:** Microservice rewrite, hosted multi-tenancy, roadmap feature implementation, unsupported stability promotion, or live offensive testing beyond authorized benchmark environments.
## 4. Task Breakdown
| ID | Task | Owner role | Dependencies | Estimate | Deliverable |
| --- | --- | --- | --- | --- | --- |
| I001-01 | Review SAD and ADR-001–005; record conditions | Architecture steward + maintainer | None | 1 day | Review log / amended ADR status |
| I001-02 | Reconcile package and canonical tracker repository identity | Release integrator | Owner decision | 0.5 day | Metadata ADR/change |
| I001-03 | Specify maturity vocabulary, sources, and conflict rules | Requirements + evaluation steward | ADR-005 | 0.5 day | Decision table/spec |
| I001-04 | Implement maturity consistency audit and seeded tests | Implementer + test engineer | I001-03 | 1–2 days | Script, tests, CI/release hook |
| I001-05 | Inventory network-capable adapters and risk metadata | Safety reviewer | Arsenal catalog | 1 day | Safety coverage matrix |
| I001-06 | Close missing scope/approval/credential/timeout tests | Implementer + safety reviewer | I001-05 | 1–3 days | Tests and adapter fixes |
| I001-07 | Define source-ingest/concurrency workloads and metrics | Test architect | NFR-11 | 0.5 day | Benchmark specification |
| I001-08 | Run baselines and retain receipts | Test engineer | I001-07 | 1 day | Versioned baseline report/receipt |
| I001-09 | Triage source/script TODO/FIXME/HACK markers | Maintainer | Code inventory | 0.5 day | Triage list / issues |
## 5. Milestones and Deliverables
1. **M1 — Baseline accepted:** Review outcomes and repository identity decision recorded.
2. **M2 — Governance automated:** Maturity audit passes valid state and fails seeded contradiction.
3. **M3 — Safety inventory complete:** No unidentified network adapter; test gaps have owners or fixes.
4. **M4 — Measurements retained:** Baseline receipts are reproducible and cited by NFR/test artifacts.
## 6. Resource Allocation
Roles may be combined, but architecture and safety review must be explicit for trust-boundary work. Capacity is not assumed; maintainers must assign names and dates before iteration start. Parallelize I001-03/I001-05/I001-07 only after I001-01 establishes the governing baseline.
## 7. Risks and Mitigations
| Risk | Mitigation |
| --- | --- |
| Owner review unavailable | Keep retrospective status explicit; do not fabricate approval; defer status promotion. |
| Adapter inventory misses dynamic paths | Derive from catalog plus runtime tool registration and seed a completeness test. |
| Benchmarks vary by host/provider | Record environment and separate deterministic/local/live outcomes. |
| Maturity rules create false positives | Use an explicit decision table, authoritative-source precedence, and seeded examples. |
## 8. Dependencies
- Upstream: accepted requirements/NFRs, SAD, ADR-003/004/005, canonical tracker config.
- External: maintainer decision on repository identity and review conditions.
- Downstream: release quality gates, construction-ready status, future capability promotion.
## 9. Testing and Validation Plan
- Run build/type/lint and affected Vitest/script suites for any implementation change.
- Seed at least one contradictory maturity label and one unclassified network adapter to prove new audits fail.
- Validate benchmark receipts by rerunning their documented command on the recorded environment or classify non-portability.
- Run `git diff --check`, AIWG citation/reference checks, and traceability/index diagnostics before closure.
## 10. Change Control
Scope changes require a recorded rationale, impact on goals/dates/risks, and maintainer approval. A request to implement a hosted/distributed/autonomous architecture exits this iteration and starts new inception/architecture work.
## 11. Review and Retrospective
At iteration close, review each pass condition, unresolved risk, and deferred measurement. Record what automation caught, false positives, missing evidence, and any required template/process updates. Dates are scheduled when maintainers assign capacity.
## References
- @.aiwg/architecture/software-architecture-doc.md — Open architecture questions and review log.
- @.aiwg/architecture/adr-003.md — Adapter safety controls.
- @.aiwg/architecture/adr-005.md — Maturity governance.
- @.aiwg/requirements/nfr-register.md — NFR-09, NFR-11, and NFR-12.
- @.aiwg/testing/test-strategy.md — Required test and measurement policy.
- @.aiwg/intake/risk-screening.md — Risks driving iteration priority.
- @package.json — Repository/package identity and scripts.
- @src/arsenal/catalog.ts — Adapter inventory source.