Define skill artifact roles in bundle layout

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

Author: oceanusXXD

src/code2skill/domain/artifacts.py

@@ -1,5 +1,6 @@
 from __future__ import annotations
 
+from collections.abc import Sequence
 from dataclasses import dataclass
 from pathlib import Path
 
@@ -49,3 +50,26 @@ def from_repo_root(
             state_dir=state_dir,
             state_path=state_dir / "analysis-state.json",
         )
+
+    def partition_bundle_paths(
+        self,
+        paths: Sequence[Path | str],
+    ) -> tuple[list[Path], list[Path]]:
+        final_products: list[Path] = []
+        intermediates: list[Path] = []
+        for path in paths:
+            resolved = self._resolve_bundle_path(path)
+            if self._is_final_product_path(resolved):
+                final_products.append(resolved)
+                continue
+            intermediates.append(resolved)
+        return final_products, intermediates
+
+    def _resolve_bundle_path(self, path: Path | str) -> Path:
+        candidate = Path(path).expanduser()
+        if candidate.is_absolute():
+            return candidate.resolve()
+        return (self.root / candidate).resolve()
+
+    def _is_final_product_path(self, path: Path) -> bool:
+        return path.suffix == ".md" and path.parent == self.skills_dir.resolve()

tests/test_workflow_requests.py

@@ -44,3 +44,30 @@ def test_adapt_request_resolves_source_dir_from_repo_root(tmp_path: Path) -> Non
 
     assert request.source_dir == (repo_path / "generated-skills").resolve()
     assert request.destination_root == repo_path.resolve()
+
+
+def test_artifact_layout_partitions_final_skill_products_from_intermediates(tmp_path: Path) -> None:
+    repo_path = tmp_path / "repo"
+    repo_path.mkdir()
+
+    layout = ArtifactLayout.from_repo_root(repo_path)
+
+    final_products, intermediates = layout.partition_bundle_paths(
+        [
+            "project-summary.md",
+            "skill-plan.json",
+            "skills/index.md",
+            "skills/backend.md",
+            "state/analysis-state.json",
+        ]
+    )
+
+    assert final_products == [
+        layout.skills_dir / "index.md",
+        layout.skills_dir / "backend.md",
+    ]
+    assert intermediates == [
+        layout.project_summary_path,
+        layout.skill_plan_path,
+        layout.state_path,
+    ]