Add cc-switch-dev-workflow skill

cc-switch-dev-workflow/scripts/bootstrap_workflow_workspace.py

@@ -0,0 +1,90 @@
+#!/usr/bin/env python3
+"""Seed a target project with the workflow's standard files and directories."""
+
+from __future__ import annotations
+
+import argparse
+import json
+import shutil
+from datetime import datetime, timezone
+from pathlib import Path
+
+
+PLAYBOOK_FILES = {
+    "new-project-from-scaffold": "new-project-from-scaffold.md",
+    "existing-project-spec-backfill-and-refactor": "existing-project-spec-backfill-and-refactor.md",
+    "spec-code-alignment-gap-closure": "spec-code-alignment-gap-closure.md",
+}
+
+
+def copy_file(source: Path, target: Path, force: bool) -> str:
+    if target.exists() and not force:
+        return f"skip {target}"
+    target.parent.mkdir(parents=True, exist_ok=True)
+    shutil.copy2(source, target)
+    return f"write {target}"
+
+
+def main() -> int:
+    parser = argparse.ArgumentParser(description="Bootstrap a repo with the CC Switch workflow files.")
+    parser.add_argument("--target-dir", required=True, help="Absolute or relative project directory to seed.")
+    parser.add_argument("--playbook", required=True, choices=sorted(PLAYBOOK_FILES))
+    parser.add_argument("--force", action="store_true", help="Overwrite existing files.")
+    args = parser.parse_args()
+
+    skill_root = Path(__file__).resolve().parent.parent
+    knowledge_base = skill_root / "references" / "knowledge-base"
+    templates_root = knowledge_base / "templates"
+    playbooks_root = knowledge_base / "playbooks"
+    workflows_root = knowledge_base / "workflows"
+    target_dir = Path(args.target_dir).expanduser().resolve()
+
+    required_dirs = [
+        target_dir / ".meetings",
+        target_dir / ".research",
+        target_dir / ".plans",
+        target_dir / ".handoff",
+        target_dir / ".acceptance",
+        target_dir / ".workflow",
+        target_dir / ".decisions",
+        target_dir / "SPECS",
+    ]
+    for directory in required_dirs:
+        directory.mkdir(parents=True, exist_ok=True)
+
+    writes = []
+    template_map = {
+        templates_root / "claude-md-template.md": target_dir / "CLAUDE.md",
+        templates_root / "analysis-template.md": target_dir / "ANALYSIS.md",
+        templates_root / "todo-yaml-template.md": target_dir / "TODO.yaml",
+        templates_root / "spec-template.md": target_dir / "SPECS" / "_template.md",
+        templates_root / "tdd-plan-template.md": target_dir / ".plans" / "_tdd-plan-template.md",
+        templates_root / "agent-handoff-template.md": target_dir / ".handoff" / "_agent-handoff-template.md",
+        templates_root / "acceptance-checklist-template.md": target_dir / ".acceptance" / "_acceptance-checklist.md",
+        playbooks_root / PLAYBOOK_FILES[args.playbook]: target_dir / ".workflow" / "selected-playbook.md",
+        workflows_root / "README.md": target_dir / ".workflow" / "stage-index.md",
+        knowledge_base / "README.md": target_dir / ".workflow" / "knowledge-base-overview.md",
+    }
+
+    for source, target in template_map.items():
+        writes.append(copy_file(source, target, args.force))
+
+    manifest = {
+        "skill": "cc-switch-dev-workflow",
+        "playbook": args.playbook,
+        "generated_at": datetime.now(timezone.utc).isoformat(),
+        "target_dir": str(target_dir),
+    }
+    manifest_path = target_dir / ".workflow" / "bootstrap-manifest.json"
+    if not manifest_path.exists() or args.force:
+        manifest_path.write_text(json.dumps(manifest, indent=2, ensure_ascii=False) + "\n", encoding="utf-8")
+        writes.append(f"write {manifest_path}")
+    else:
+        writes.append(f"skip {manifest_path}")
+
+    print("\n".join(writes))
+    return 0
+
+
+if __name__ == "__main__":
+    raise SystemExit(main())