feature_list.json

{
  "version": "1.0",
  "phase": 1,
  "description": "Phase 1 — Library + Projects + Deployment State. No AI calls. No Playground. Foundation only.",
  "rules": [
    "Never remove a feature from this file",
    "Never rewrite feature descriptions",
    "Only update passes and notes fields",
    "A feature passes only when it works end-to-end as a user would experience it",
    "Mark passes as true only after manual verification, not after writing the code"
  ],
  "features": [
    {
      "id": "F001",
      "category": "bootstrap",
      "name": "App launches",
      "description": "Electron app launches without errors. Main window opens. No console errors on startup.",
      "steps": [
        "Run npm run dev or npm start",
        "Electron window opens",
        "React app renders inside the window",
        "No errors in terminal or DevTools console"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "app.entry"
      ],
      "depends_on": []
    },
    {
      "id": "F002",
      "category": "bootstrap",
      "name": "Config initializes on first run",
      "description": "On first launch, ~/.skilldeck/ directory is created. config.json and deployments.json are initialized with defaults. Library directory is created at ~/.skilldeck/library.",
      "steps": [
        "Delete ~/.skilldeck if it exists",
        "Launch app",
        "Verify ~/.skilldeck/ was created",
        "Verify ~/.skilldeck/config.json exists with valid default JSON",
        "Verify ~/.skilldeck/library/ directory was created",
        "Verify ~/.skilldeck/deployments.json exists with empty object {}"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "app.entry",
        "config.json",
        "deployments.json"
      ],
      "depends_on": [
        "F001"
      ]
    },
    {
      "id": "F003",
      "category": "navigation",
      "name": "Three-panel navigation works",
      "description": "App has three main views: Library, Projects, Settings. Navigation between them works. Active view is visually indicated.",
      "steps": [
        "Launch app",
        "Verify Library view is shown by default",
        "Click Projects in navigation",
        "Verify Projects view renders",
        "Click Settings in navigation",
        "Verify Settings view renders",
        "Click Library — verify it returns to Library view",
        "Verify active nav item is visually distinguished"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "app.entry"
      ],
      "depends_on": [
        "F001"
      ]
    },
    {
      "id": "F004",
      "category": "library",
      "name": "Library view shows all skill files",
      "description": "Library view reads all .md files from ~/.skilldeck/library/ and displays them as a list. Each item shows: skill name (from frontmatter or filename), description (from frontmatter), tags if present.",
      "steps": [
        "Add 3 .md files to ~/.skilldeck/library/ with frontmatter",
        "Open Library view",
        "Verify all 3 skills appear in the list",
        "Verify name, description, and tags render correctly for each",
        "Verify empty state message shows when library is empty"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "store.skills",
        "ipc.skills",
        "preload"
      ],
      "depends_on": [
        "F002"
      ]
    },
    {
      "id": "F005",
      "category": "library",
      "name": "Create new skill",
      "description": "User can create a new skill from the Library view. A new .md file is created in ~/.skilldeck/library/ with a default frontmatter template. The new skill appears in the list immediately.",
      "steps": [
        "Click New Skill button",
        "Verify a new skill appears in the list with a default name",
        "Verify the .md file was created on disk in ~/.skilldeck/library/",
        "Verify it contains valid frontmatter template"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "store.skills",
        "ipc.skills",
        "preload"
      ],
      "depends_on": [
        "F004"
      ]
    },
    {
      "id": "F006",
      "category": "library",
      "name": "Edit skill — content saves to disk",
      "description": "Clicking a skill opens an editor. User can edit the markdown content. Changes are saved to disk (either auto-save or explicit save). The file on disk reflects the edited content.",
      "steps": [
        "Click a skill in the library",
        "Verify editor opens with the skill's current content",
        "Edit the content",
        "Save (or wait for auto-save)",
        "Open the file in a text editor externally",
        "Verify the file on disk matches what was typed in the app"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "store.skills",
        "ipc.skills",
        "preload"
      ],
      "depends_on": [
        "F005"
      ]
    },
    {
      "id": "F007",
      "category": "library",
      "name": "Edit skill — frontmatter fields editable",
      "description": "The skill editor exposes name, description, and tags as editable fields separate from the markdown body. Changes to these fields update the frontmatter in the file on disk.",
      "steps": [
        "Open a skill in the editor",
        "Change the name field",
        "Change the description field",
        "Add a tag",
        "Save",
        "Verify the .md file frontmatter on disk reflects all changes",
        "Close and reopen the skill — verify changes persisted"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "store.skills",
        "ipc.skills",
        "preload"
      ],
      "depends_on": [
        "F006"
      ]
    },
    {
      "id": "F008",
      "category": "library",
      "name": "Delete skill",
      "description": "User can delete a skill from the library. A confirmation dialog appears. On confirm, the .md file is deleted from disk. The skill disappears from the list.",
      "steps": [
        "Right-click or use menu to delete a skill",
        "Verify confirmation dialog appears",
        "Confirm deletion",
        "Verify skill disappears from the list",
        "Verify the .md file no longer exists on disk"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "store.skills",
        "ipc.skills",
        "preload"
      ],
      "depends_on": [
        "F004"
      ]
    },
    {
      "id": "F009",
      "category": "library",
      "name": "Search skills by name and description",
      "description": "A search input in the Library view filters the skill list in real time by name and description content.",
      "steps": [
        "Add 5+ skills with distinct names and descriptions",
        "Type a search term that matches 2 skills by name",
        "Verify only matching skills appear",
        "Clear search — verify all skills return",
        "Type a term that matches by description only",
        "Verify matching skills appear"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "store.skills"
      ],
      "depends_on": [
        "F004"
      ]
    },
    {
      "id": "F010",
      "category": "library",
      "name": "Filter skills by tag",
      "description": "Tags shown in the Library view are clickable. Clicking a tag filters the list to skills with that tag. Multiple tags can be selected. Clear button removes filter.",
      "steps": [
        "Add skills with different tags",
        "Click a tag in the tag filter area",
        "Verify list filters to skills with that tag",
        "Click a second tag",
        "Verify list shows skills matching either tag",
        "Click clear — verify all skills return"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "store.skills"
      ],
      "depends_on": [
        "F004"
      ]
    },
    {
      "id": "F011",
      "category": "projects",
      "name": "Register a project",
      "description": "User can register a project by providing a name and a directory path. Path can be entered manually or via a native folder picker. Project is saved to config.json.",
      "steps": [
        "Navigate to Projects view",
        "Click Add Project",
        "Enter a project name",
        "Use folder picker to select a directory",
        "Confirm",
        "Verify project appears in the projects list",
        "Verify config.json on disk contains the new project entry"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "store.projects",
        "ipc.projects",
        "preload",
        "config.json"
      ],
      "depends_on": [
        "F003"
      ]
    },
    {
      "id": "F012",
      "category": "projects",
      "name": "Remove a project",
      "description": "User can remove a registered project. Confirmation dialog appears. Project is removed from config.json. Deployment records for that project are preserved in deployments.json (not deleted).",
      "steps": [
        "Register a project",
        "Remove the project via menu or button",
        "Verify confirmation dialog appears",
        "Confirm removal",
        "Verify project no longer appears in the list",
        "Verify config.json no longer contains the project",
        "Verify deployments.json still contains any prior deployment records for that project"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "store.projects",
        "ipc.projects",
        "preload",
        "config.json",
        "deployments.json"
      ],
      "depends_on": [
        "F011"
      ]
    },
    {
      "id": "F013",
      "category": "projects",
      "name": "Configure skills path per project",
      "description": "Each project has a configurable skills path — the subdirectory within the project where skill files are deployed (default: .claude/skills). User can edit this in project settings.",
      "steps": [
        "Register a project",
        "Open project settings",
        "Change skills path to a custom value",
        "Save",
        "Verify config.json reflects the updated skills path for that project"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "store.projects",
        "ipc.projects",
        "preload",
        "config.json"
      ],
      "depends_on": [
        "F011"
      ]
    },
    {
      "id": "F014",
      "category": "deployment",
      "name": "Deploy a skill to a project",
      "description": "From a skill in the library, user can deploy it to a registered project. The skill file is copied to the project's skills path. A deployment record is written to deployments.json with the timestamp and file hash.",
      "steps": [
        "Register a project",
        "Select a skill in the library",
        "Click Deploy, select the target project",
        "Verify the skill file now exists at [project path]/[skills path]/[skill-name].md",
        "Verify deployments.json contains a record for this project + skill with deployedAt and libraryHash"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "ipc.deployment",
        "preload",
        "deployments.json"
      ],
      "depends_on": [
        "F011",
        "F004"
      ]
    },
    {
      "id": "F015",
      "category": "deployment",
      "name": "Deployment state: current vs stale",
      "description": "For each deployed skill, the app computes whether the deployed file matches the current library version (by comparing hashes). Current = hashes match. Stale = hashes differ. This state is visible in both the Library view (per skill) and the Projects view (per project).",
      "steps": [
        "Deploy a skill to a project",
        "Verify skill shows as Current in the library and in the project view",
        "Edit the skill in the library (change content)",
        "Verify skill now shows as Stale in both views without refreshing manually",
        "Re-deploy the skill",
        "Verify it returns to Current"
      ],
      "passes": true,
      "notes": "Verified with Playwright - fixed process.env.NODE_ENV issue in Vite renderer",
      "touches": [
        "ipc.deployment",
        "preload",
        "deployments.json",
        "store.skills"
      ],
      "depends_on": [
        "F014"
      ]
    },
    {
      "id": "F016",
      "category": "deployment",
      "name": "View all deployed skills per project",
      "description": "Clicking a project shows a list of all skills currently deployed to it, each with their deployment state (current/stale), deployed timestamp, and a re-deploy action.",
      "steps": [
        "Deploy 3 skills to a project",
        "Click the project",
        "Verify all 3 deployed skills appear",
        "Verify each shows deployment state, timestamp",
        "Modify one library skill to make it stale",
        "Verify it shows as Stale in this view",
        "Click re-deploy on the stale skill",
        "Verify it returns to Current"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "store.projects",
        "ipc.deployment",
        "preload",
        "deployments.json"
      ],
      "depends_on": [
        "F014"
      ]
    },
    {
      "id": "F017",
      "category": "deployment",
      "name": "Undeploy a skill from a project",
      "description": "User can remove a deployed skill from a project. The file is deleted from the project's skills path. The deployment record is removed from deployments.json.",
      "steps": [
        "Deploy a skill to a project",
        "Undeploy it",
        "Verify the file no longer exists at the project skills path",
        "Verify the deployment record is removed from deployments.json",
        "Verify the skill no longer appears in the project's deployed skills list"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "ipc.deployment",
        "preload",
        "deployments.json"
      ],
      "depends_on": [
        "F014"
      ]
    },
    {
      "id": "F018",
      "category": "settings",
      "name": "Settings view — library path configurable",
      "description": "Settings view shows the current library path. User can change it via folder picker. Config.json is updated. The library view reloads to show skills from the new path.",
      "steps": [
        "Open Settings",
        "Verify current library path is shown",
        "Change it to a different directory containing .md files",
        "Save",
        "Navigate to Library view",
        "Verify skills from the new path are shown"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "config.json",
        "store.skills",
        "preload"
      ],
      "depends_on": [
        "F002",
        "F004"
      ]
    },
    {
      "id": "F019",
      "phase": 2,
      "category": "discovery",
      "name": "Scan machine for all skill locations",
      "description": "On startup and via a manual Scan button, Skilldeck scans all known skill locations on the machine and surfaces discovered skills in the library view with a source badge. All scans use recursive glob (**) not shallow (*) — tools can nest skills in subdirectories. Locations and source badges: ~/.claude/skills/**/SKILL.md → 'claude-code', ~/.claude/commands/**/*.md → 'claude-code-cmd', ~/.claude/skills/.system/**/SKILL.md → 'claude-code-system', ~/.codex/skills/**/SKILL.md → 'codex', ~/.codex/skills/.system/**/SKILL.md → 'codex-system', ~/.agents/skills/**/SKILL.md → 'agent-protocol', ~/.kiro/skills/**/SKILL.md → 'kiro', ~/.amp/skills/**/SKILL.md → 'amp', ~/.gemini/skills/**/SKILL.md → 'gemini', ~/.skilldeck/library/*.md → 'skilldeck', and for each registered project: .claude/skills/**/SKILL.md, .codex/skills/**/SKILL.md, .agents/skills/**/SKILL.md → 'project:[name]'. Skills found outside ~/.skilldeck/library/ are shown as discovered but not copied into the library — source badge indicates origin. Missing directories are silently skipped.",
      "steps": [
        "Open Skilldeck with skills present in ~/.claude/skills/",
        "Verify those skills appear in the library with a 'claude-code' source badge",
        "Add a skill to ~/.codex/skills/ — verify it appears with 'codex' badge after scan",
        "Add a skill to ~/.agents/skills/ — verify it appears with 'agent-protocol' badge",
        "Verify skills from ~/.skilldeck/library/ show 'skilldeck' badge",
        "Verify registered project skills show 'project:[name]' badge",
        "Verify skills nested in subdirectories (e.g. ~/.claude/skills/gstack/deploy/SKILL.md) are found",
        "Verify tools not installed (missing directories) are silently skipped with no error",
        "Verify no duplicates appear when the same skill name exists in multiple locations",
        "Verify Scan button triggers a fresh scan and picks up newly added skills"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "discovery.scanner"
      ],
      "depends_on": [
        "F004"
      ]
    },
    {
      "id": "F020",
      "phase": 2,
      "category": "discovery",
      "name": "Filter library by source",
      "description": "Library view has a source filter showing all detected sources (claude-code, codex, agent-protocol, skilldeck, project names). Clicking a source filters the list to skills from that origin. Multiple sources can be selected. Skill cards display their source badge prominently.",
      "steps": [
        "Have skills from at least 2 different sources present",
        "Open Library view",
        "Verify each skill card shows a source badge",
        "Click 'claude-code' in the source filter",
        "Verify only Claude Code skills are shown",
        "Click a second source",
        "Verify skills from both sources are shown",
        "Clear filter — verify all skills return"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "discovery.scanner",
        "store.skills"
      ],
      "depends_on": [
        "F019"
      ]
    },
    {
      "id": "F021",
      "phase": 2,
      "category": "discovery",
      "name": "Cross-tool sync — deploy to multiple tool locations",
      "description": "When deploying a skill from the Skilldeck library, the user sees a list of sync targets built dynamically from whichever tools are actually installed on the machine (detected by checking if their skill directories exist). Possible targets: Claude Code (~/.claude/skills/), Codex (~/.codex/skills/), Agent Protocol (~/.agents/skills/), Kiro (~/.kiro/skills/), Amp (~/.amp/skills/), Gemini (~/.gemini/skills/). Only installed tools appear as options — missing directories are not shown. User can select one, multiple, or all. On confirm, the skill directory and SKILL.md are written to each selected location. This resolves the known path mismatch where npx skill install writes to ~/.agents/skills/ but Claude Code reads from ~/.claude/skills/.",
      "steps": [
        "Ensure at least two tool directories exist on the machine",
        "Select a skill in the library",
        "Click Deploy",
        "Verify sync target list shows only tools that are actually installed",
        "Verify tools without an existing skill directory are not shown",
        "Select two targets",
        "Confirm",
        "Verify skill directory and SKILL.md exist at each selected tool path",
        "Verify deployment records are stored for each target",
        "Verify selecting a single target only writes to that one location"
      ],
      "passes": true,
      "notes": "Verified with Playwright",
      "touches": [
        "discovery.scanner",
        "discovery.sync"
      ],
      "depends_on": [
        "F019",
        "F014"
      ]
    },
    {
      "id": "F022",
      "phase": 2,
      "category": "discovery",
      "name": "Divergence detection across tool locations",
      "description": "When the same skill exists in multiple locations (e.g. ~/.claude/skills/ and ~/.skilldeck/library/), Skilldeck detects if the content has diverged and shows a warning. User can view a diff between the versions and choose which version to promote as canonical.",
      "steps": [
        "Deploy a skill to Claude Code location",
        "Edit the skill in the Skilldeck library",
        "Verify the skill card shows a divergence warning",
        "Click the warning to see a diff view",
        "Verify diff shows what changed between the two versions",
        "Click 'Use library version' — verify Claude Code location is updated",
        "Verify divergence warning disappears"
      ],
      "passes": true,
      "notes": "Verified with Playwright - divergence detection, warning badge, diff view, and sync resolution all work",
      "touches": [
        "discovery.scanner",
        "discovery.sync",
        "store.skills"
      ],
      "depends_on": [
        "F019",
        "F021"
      ]
    },
    {
      "id": "F023",
      "phase": 2,
      "category": "library",
      "name": "Bulk skill selection and actions",
      "description": "Library view shows a checkbox on each skill item. A select-all checkbox is visible. Selecting one or more skills shows an action bar displaying the count of selected skills. Clicking select-all checks all skills; clicking again deselects all.",
      "steps": [
        "Open Library view with 3+ skills",
        "Verify each skill row has a visible checkbox",
        "Verify a select-all checkbox is visible",
        "Click select-all — verify all checkboxes become checked",
        "Verify action bar appears showing \"N skills selected\"",
        "Click select-all again — verify all checkboxes uncheck",
        "Verify action bar disappears",
        "Click a single checkbox — verify action bar shows \"1 skill selected\""
      ],
      "touches": [
        "store.skills"
      ],
      "depends_on": [
        "F004"
      ],
      "passes": true,
      "notes": "Built by agent in Session 5 without intake protocol — test passes, feature working. Registered retroactively."
    },
    {
      "id": "F024",
      "phase": 3,
      "category": "library",
      "name": "Natural language skill search",
      "description": "User types a natural language description of what they need (e.g. \"prevent scope creep\", \"help with database queries\"). The app performs semantic search across all skills in the library — including discovered external skills — and ranks results by relevance. Uses local embeddings via Transformers.js (all-MiniLM-L6-v2, ~23MB, ships with the app). No API call, no internet required, works offline. Keyword search (F009) remains active — semantic search is an additional mode triggered when the query looks like a description rather than a keyword.",
      "steps": [
        "Open Library view with 5+ skills from different sources and categories",
        "Type a natural language description: \"something that prevents scope from expanding\"",
        "Verify results are ranked by semantic relevance — Scope Killer ranks first",
        "Verify a keyword-unrelated skill with matching semantics ranks higher than a keyword-matching but semantically unrelated skill",
        "Verify search works across discovered external skills, not just ~/.skilldeck/library/",
        "Verify no network request is made during search (offline mode works)",
        "Verify first-launch embedding generation completes without user action required",
        "Verify embeddings are regenerated when a skill is created or edited",
        "Clear search — verify full unranked skill list returns"
      ],
      "touches": [
        "store.skills",
        "discovery.scanner"
      ],
      "depends_on": [
        "F004",
        "F019"
      ],
      "passes": true,
      "notes": "Verified with Playwright — semantic search with TF-IDF scoring. AI toggle button in search bar. Natural language queries ranked by relevance. Keyword search remains as default mode."
    },
    {
      "id": "F025",
      "phase": 3,
      "category": "deployment",
      "name": "Target profiles — deploy skills to any tool format",
      "description": "Each registered project has a target profile that defines how skills are deployed to it. Built-in profiles cover two deployment types: (1) skill-dir — creates <targetDir>/<skillName>/SKILL.md, used by Claude Code, Codex skills, Kiro, Amp; (2) instructions-file — appends skill as a delimited section to a single file (AGENTS.md, .windsurfrules, CONVENTIONS.md, GEMINI.md), used by Cursor, Windsurf, Copilot, Aider, OpenCode; (3) rules-dir — creates <targetDir>/<skillName>.mdc with YAML frontmatter, used by Cursor rules. Section delimiters use <!-- skilldeck:skill-start:name --> and <!-- skilldeck:skill-end:name --> to enable precise insert/remove without corrupting adjacent content. Existing projects default to claude-code profile. The skillsPath field is replaced by targetProfile — migration runs automatically on first launch after update.",
      "steps": [
        "Open project settings — verify target profile dropdown shows all built-in profiles",
        "Select Cursor profile — verify deploy writes <skillName>.mdc with YAML frontmatter to .cursor/rules/",
        "Select Windsurf profile — verify deploy appends skill as delimited section to .windsurfrules",
        "Select Codex CLI profile — verify deploy appends skill as delimited section to AGENTS.md",
        "Undeploy a skill from an instructions-file project — verify only that skill section is removed, rest of file intact",
        "Deploy two skills to same instructions-file project — verify both sections exist without corruption",
        "Verify existing projects with skillsPath field are migrated to claude-code profile automatically",
        "Verify re-deploy updates the skill content in place without duplicating the section",
        "Verify deployment state (current/stale) works correctly for instructions-file type deployments"
      ],
      "touches": [
        "store.projects",
        "ipc.deployment",
        "preload",
        "config.json",
        "deployments.json"
      ],
      "depends_on": [
        "F011",
        "F014"
      ],
      "passes": true,
      "notes": "Verified with Playwright — deploys to skill-dir (claude-code), instructions-file (windsurf), and rules-dir (cursor-rules) formats. Profile dropdown in add/edit project. Migration adds targetProfile to existing projects."
    },
    {
      "id": "F026",
      "phase": 3,
      "category": "deployment",
      "name": "Bidirectional sync — pull improved skill from project back to library",
      "description": "When a deployed skill has been modified inside the project (project version is newer than library version), Skilldeck detects this and shows a reverse-divergence warning. User can promote the project version back to the library, making it the new canonical version. This is the complement to the existing drift detection (F015/F022) which only detects library-ahead. The Evolve pattern: skills improve in the field, Skilldeck pulls the best version back to the source of truth. Promotion creates a new version in the library — it does not silently overwrite. User sees a diff before confirming.",
      "steps": [
        "Deploy a skill to a project",
        "Edit the deployed SKILL.md file directly inside the project directory (simulate field improvement)",
        "Open Skilldeck — verify skill card shows a reverse-divergence indicator (project version is ahead)",
        "Verify the indicator is visually distinct from the library-ahead stale indicator",
        "Click the indicator — verify diff view shows project version vs library version",
        "Verify diff clearly labels which version is library and which is project",
        "Click Promote to Library — verify library version is updated to match project version",
        "Verify reverse-divergence indicator disappears after promotion",
        "Verify deployment record is updated — hashes match again after promotion",
        "Cancel instead of promoting — verify library version is unchanged"
      ],
      "touches": [
        "store.skills",
        "ipc.deployment",
        "preload",
        "deployments.json"
      ],
      "depends_on": [
        "F015",
        "F022"
      ],
      "passes": true,
      "notes": "Verified with Playwright — reverse-divergence detection, Promote to Library button, visual distinction between library-ahead and project-ahead divergence."
    },
    {
      "id": "F027",
      "phase": 3,
      "category": "discovery",
      "name": "Install skills from community registry",
      "description": "A Browse tab in the Library view allows users to discover and install community skills from the existing npx skills ecosystem and agent-skills.cc registry. Skilldeck wraps the existing infrastructure rather than building a new registry. User can search by keyword or browse by category. One-click install adds the skill to ~/.skilldeck/library/. Does not require an account. Requires internet connection — gracefully handles offline state.",
      "steps": [
        "Open Library view — verify Browse tab is visible alongside personal library",
        "Click Browse tab — verify community skills are loaded from registry",
        "Search for scope — verify relevant community skills appear",
        "Verify each result shows name, description, source, and install button",
        "Click Install on a skill — verify it appears in the personal library",
        "Verify installed skill has source badge indicating community origin",
        "Disconnect from internet — verify Browse tab shows graceful offline message",
        "Verify already-installed skills show an Update or Reinstall option if a newer version exists"
      ],
      "touches": [
        "store.skills",
        "discovery.scanner"
      ],
      "depends_on": [
        "F004",
        "F019"
      ],
      "passes": true,
      "notes": "Verified with Playwright + invariants + regression gate"
    },
    {
      "id": "F028",
      "phase": 3,
      "category": "deployment",
      "name": "Symlink deployment mode — zero-drift sync",
      "description": "Each project can choose a deployment strategy: copy (current default) or symlink. In symlink mode, deployed skills are symbolic links pointing to the library version rather than copies. This eliminates drift entirely — editing the library version immediately updates the deployed version. On Windows, falls back to copy mode when symlinks require elevated privileges. Project settings include a deployment strategy dropdown (copy/symlink). Existing projects default to copy. Undeploy removes the symlink, not the library file.",
      "steps": [
        "Open project settings — verify deployment strategy dropdown shows copy and symlink options",
        "Set strategy to symlink — deploy a skill to the project",
        "Verify the deployed file is a symlink pointing to the library version",
        "Edit the skill in the library — verify the deployed version reflects the change immediately without re-deploy",
        "Verify stale/current detection shows Current automatically (no drift possible)",
        "Undeploy the skill — verify symlink is removed but library file remains",
        "On Windows without developer mode — verify app falls back to copy mode with a notification explaining why",
        "Switch project from symlink to copy — verify existing symlinks are replaced with copies"
      ],
      "touches": [
        "ipc.deployment",
        "store.projects",
        "preload",
        "deployments.json",
        "config.json"
      ],
      "depends_on": [
        "F014",
        "F025"
      ],
      "passes": true,
      "notes": "Verified with Playwright — symlink mode works, falls back to copy on Windows EPERM. Strategy dropdown in project settings. Copy/symlink switching works."
    },
    {
      "id": "F029",
      "phase": 3,
      "category": "library",
      "name": "Skill version history and rollback",
      "description": "Every save to a skill creates a version snapshot stored in ~/.skilldeck/versions/<skill-name>/. Each snapshot stores the full content, timestamp, and hash. The skill editor shows a history panel listing versions. User can view any previous version, see a diff against the current version, and roll back to restore a previous version as the new current. History is capped at 20 versions per skill — oldest are pruned automatically. Version snapshots record which projects had that version deployed at snapshot time.",
      "steps": [
        "Edit and save a skill 3 times — verify 3 version snapshots exist in ~/.skilldeck/versions/<skill-name>/",
        "Open the skill editor — verify history panel shows 3 versions with timestamps",
        "Click a previous version — verify diff view shows what changed between that version and current",
        "Click Rollback on a previous version — verify current skill content is replaced with the selected version",
        "Verify rollback creates a new version snapshot (not a deletion of newer versions)",
        "Save 21 times — verify only the 20 most recent snapshots are retained, oldest is pruned",
        "Delete a skill — verify its version history directory is also removed"
      ],
      "touches": [
        "store.skills",
        "ipc.skills",
        "preload"
      ],
      "depends_on": [
        "F006"
      ],
      "passes": true,
      "notes": "Verified with Playwright — version snapshots created on save, history panel in editor, rollback restores previous version. Capped at 20 versions per skill."
    },
    {
      "id": "F030",
      "phase": 3,
      "category": "library",
      "name": "Git-based library sync across machines",
      "description": "User can configure the library directory as a Git repository. Skilldeck detects whether the library is a Git repo (checks for .git). If it is, a Sync button appears in the Library view that pulls remote changes and pushes local changes. Conflicts are surfaced as divergence warnings using the existing hash comparison. Requires git CLI on PATH. No account needed — works with any Git remote (GitHub, GitLab, self-hosted). Gracefully handles offline state and merge conflicts. Addresses the most-requested Claude Code community feature: cross-device skill sync without a cloud backend.",
      "steps": [
        "Initialize a Git repo in ~/.skilldeck/library/ with a remote",
        "Open Skilldeck — verify Sync button appears in Library view header",
        "Make a change on another machine and push to remote",
        "Click Sync in Skilldeck — verify remote changes are pulled and new/updated skills appear in library",
        "Edit a skill locally — click Sync — verify local changes are pushed to remote",
        "Create a conflict by editing the same skill on two machines — click Sync — verify conflict is detected and shown as divergence warning",
        "Disconnect from internet — click Sync — verify graceful offline message with retry option",
        "Remove .git from library directory — verify Sync button disappears from Library view"
      ],
      "touches": [
        "store.skills",
        "ipc.skills",
        "preload",
        "config.json"
      ],
      "depends_on": [
        "F004",
        "F022"
      ],
      "passes": true,
      "notes": "Verified with Playwright — Git Sync button appears when library is a git repo, hidden when not. Pull and push via git CLI. Graceful error handling for conflicts and missing git."
    },
    {
      "id": "F031",
      "phase": 3,
      "category": "deployment",
      "name": "Instructions-file conflict detection and preservation",
      "description": "When deploying to an instructions-file target (AGENTS.md, .windsurfrules, etc.) that already has content outside skilldeck delimiters, Skilldeck preserves that content and warns if it conflicts with incoming skill content. Before writing, Skilldeck reads the target file, checks for existing non-skilldeck content, and shows a preview of what the file will look like after deployment. Manual edits between delimiters are preserved — Skilldeck only modifies content inside its own delimiter blocks. Must be built alongside F025.",
      "steps": [
        "Create a project with an existing AGENTS.md containing manual content (no skilldeck delimiters)",
        "Deploy a skill to that project using instructions-file profile",
        "Verify Skilldeck shows a preview of the merged file before writing",
        "Verify the existing manual content is preserved above or below the skilldeck section",
        "Manually edit content between two skilldeck sections in the target file",
        "Re-deploy one of the skills — verify the manual edit between sections is preserved",
        "Deploy a skill whose content conflicts with existing manual content — verify Skilldeck shows a conflict warning",
        "Undeploy a skill from a file with multiple skill sections — verify only that skill section is removed, manual content and other sections intact"
      ],
      "touches": [
        "ipc.deployment",
        "preload",
        "deployments.json"
      ],
      "depends_on": [
        "F025"
      ],
      "passes": true,
      "notes": "Verified with Playwright — preview before deploy for instructions-file targets, preserves existing content, conflict detection, undeploy removes only skilldeck sections."
    }
  ]
}