Files
open-reuse/workplans/OPEN-WP-0004-integration-portfolio-registration.md
tegwick a7c0c910fe docs(workplans): add OPEN-WP-0003 and OPEN-WP-0004
OPEN-WP-0003: CLI validator for Integration Definition schema and index checks.
OPEN-WP-0004: Portfolio survey and registration of additional integrations.
2026-06-24 18:16:42 +02:00

2.4 KiB
Raw Blame History

id, type, title, domain, repo, status, owner, topic_slug, created, updated
id type title domain repo status owner topic_slug created updated
OPEN-WP-0004 workplan Integration portfolio registration infotech open-reuse ready codex infotech 2026-06-24 2026-06-24

Integration portfolio registration

Grow registry/indexes/integrations.yaml beyond the markitect-quarkdown reference entry. Survey the portfolio for proven OSS integrations, coordinate definition authoring in consuming repositories, and register discovery rows in open-reuse.

Design decisions

  • Source of truth: Integration definitions live in consuming repos; open-reuse holds the discovery index only (per PRD open question 7).
  • Entry bar: Only integrations that have proven value in practice — open-reuse does not register experiments or planned work.
  • Dependency: Prefer open-reuse validate from OPEN-WP-0003 for final verification; manual checklist is acceptable until that workplan completes.

Survey portfolio candidates

id: OPEN-WP-0004-T01
status: todo
priority: high

Scan the local repo portfolio (reuse-surface local-repo-roster.yaml, domain INTENT.md files, and existing *.integration.yaml files) for proven integrations not yet indexed. Produce a short candidate list with owner repo, upstream project, reuse mode estimate, and registration readiness (ready / needs-definition / needs-boundary-work).

Prioritize and assign targets

id: OPEN-WP-0004-T02
status: todo
priority: high

Select 23 candidates for registration in this workplan cycle. Record the selection and rationale in the task result. Defer remaining candidates to backlog with explicit blockers.

Author integration definitions

id: OPEN-WP-0004-T03
status: todo
priority: high

For each selected candidate, ensure a conforming Integration Definition exists in the consuming repo at integration/<id>.integration.yaml using templates/integration-entry.template.yaml. Complete at minimum: upstream, reuse classification, boundary, validation harness, and maintainers. Coordinate PRs in owning repos where definitions are missing.

Expand registry index

id: OPEN-WP-0004-T04
status: todo
priority: medium

Add index rows to registry/indexes/integrations.yaml for each registered integration. Update registry/README.md reference section. Run open-reuse validate (or manual checklist) and confirm all new rows pass promotion gates for registered or active status.