Skip to main content

Task Breakdown: Work Import

Feature ID: work-import Status: Done (Retrospective) Last updated: 2026-05-01


Phase 1 — Detection + parsing

  • T1. parseRepositoryReference (HTTPS / SSH / slug → RepositoryTarget).
  • T2. WorksConfigImportPlanner dry-run.
  • T3. AwesomeListImportPlanner Markdown AST traversal.

Phase 2 — Application

  • T4. WorksConfigImportApplier for atomic application.
  • T5. Slug uniqueness check (case-insensitive).
  • T6. Plugin id validation against the registry.

Phase 3 — API

  • T7. POST /api/works/import/preview.
  • T8. POST /api/works/import.
  • T9. e2e tests.

Phase 4 — Web / CLI

  • T10. Import wizard UI.
  • T11. CLI work import command.

Phase 5 — Background

  • T12. Trigger.dev fan-out for Awesome-List normalisation.

Phase 6 — Docs

  • T13. User-facing doc docs/features/work-import.md.
  • T14. Cross-links in works-config spec.
  • T15. Retrospective spec/plan/tasks.

Definition of Done

  • All tasks shipped, tests pass, docs present, constitution gates verified.