cadence-skill-installer 0.2.31 → 0.2.33

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cadence-skill-installer",
-  "version": "0.2.31",
+  "version": "0.2.33",
   "description": "Install the Cadence skill into supported AI tool skill directories.",
   "repository": "https://github.com/snowdamiz/cadence",
   "private": false,

package/skill/SKILL.md

@@ -66,7 +66,7 @@ description: Structured project operating system for end-to-end greenfield or br
 
 ## Prerequisite Gate (Conditional)
 1. Invoke `skills/prerequisite-gate/SKILL.md` only when `route.skill_name` is `prerequisite-gate`.
-2. If `route.skill_name` is not `prerequisite-gate` (for example `brownfield-intake`, `brownfield-documenter`, `ideator`, or `researcher`), skip prerequisite gate and follow the active route instead.
+2. If `route.skill_name` is not `prerequisite-gate` (for example `brownfield-intake`, `brownfield-documenter`, `ideator`, `researcher`, or `planner`), skip prerequisite gate and follow the active route instead.
 
 ## Project Mode Intake Gate (Conditional)
 1. Invoke `skills/brownfield-intake/SKILL.md` only when `route.skill_name` is `brownfield-intake`.
@@ -107,6 +107,12 @@ description: Structured project operating system for end-to-end greenfield or br
 2. Enforce one research pass per conversation so context stays bounded.
 3. When the researcher flow reports additional passes remain (`handoff_required=true`), end with this exact line: `Start a new chat and say "continue research".`
 4. Continue routing to researcher on subsequent chats until workflow reports the research task complete.
+5. For greenfield projects, when research completes and route advances to `planner`, invoke `skills/planner/SKILL.md` in the next routed conversation.
+
+## Planner Flow
+1. If the workflow route is `planner`, invoke `skills/planner/SKILL.md`.
+2. Planner is greenfield-only and should not run for brownfield routes.
+3. Keep planner output at milestone/phase level in `.cadence/cadence.json` and defer waves/tasks decomposition to a later planning subskill.
 
 ## Ideation Update Flow
 1. If the user wants to modify or discuss existing ideation, invoke `skills/ideation-updater/SKILL.md`.

package/skill/agents/openai.yaml

@@ -14,4 +14,4 @@ interface:
     For each successful subskill conversation, run scripts/finalize-skill-checkpoint.py from PROJECT_ROOT with
     that subskill's --scope/--checkpoint and --paths ., allow status=no_changes, and treat checkpoint/push
     failures as blocking.
-    Use the exact handoff lines in SKILL.md for ideator, brownfield-documenter, and researcher transitions.
+    Use the exact handoff lines in SKILL.md for ideator, brownfield-documenter, researcher, and planner transitions.

package/skill/assets/cadence.json

@@ -10,7 +10,7 @@
         "brownfield-documentation-completed": false
     },
     "workflow": {
-        "schema_version": 5,
+        "schema_version": 6,
         "plan": [
             {
                 "id": "milestone-foundation",
@@ -86,6 +86,16 @@
                                             "skill_path": "skills/researcher/SKILL.md",
                                             "reason": "Ideation research agenda has not been completed yet."
                                         }
+                                    },
+                                    {
+                                        "id": "task-roadmap-planning",
+                                        "kind": "task",
+                                        "title": "Plan project roadmap",
+                                        "route": {
+                                            "skill_name": "planner",
+                                            "skill_path": "skills/planner/SKILL.md",
+                                            "reason": "Project roadmap planning has not been completed yet."
+                                        }
                                     }
                                 ]
                             }
@@ -135,5 +145,16 @@
             "handoff_required": false,
             "handoff_message": "Start a new chat and say \"continue research\"."
         }
+    },
+    "planning": {
+        "version": 1,
+        "status": "pending",
+        "detail_level": "",
+        "decomposition_pending": true,
+        "created_at": "",
+        "updated_at": "",
+        "summary": "",
+        "assumptions": [],
+        "milestones": []
     }
 }

package/skill/config/commit-conventions.json

@@ -133,6 +133,12 @@
             "checkpoints": {
                 "research-pass-recorded": "persist one ideation research pass"
             }
+        },
+        "planner": {
+            "description": "Greenfield roadmap planning persistence",
+            "checkpoints": {
+                "plan-created": "persist milestone and phase roadmap plan"
+            }
         }
     }
 }

package/skill/scripts/finalize-skill-checkpoint.py

@@ -88,6 +88,8 @@ def parse_status_paths(status_output: str) -> list[str]:
         line = raw_line.rstrip("\n")
         if len(line) < 4:
             continue
+        if line.startswith("!! "):
+            continue
 
         path_part = line[3:]
         if " -> " in path_part:

package/skill/scripts/git-checkpoint.py

@@ -154,12 +154,28 @@ def ensure_no_pre_staged_changes(repo_root: Path) -> None:
         raise CheckpointError("STAGED_CHANGES_PRESENT")
 
 
+def path_is_tracked(repo_root: Path, pathspec: str) -> bool:
+    result = run_git(["ls-files", "--error-unmatch", "--", pathspec], repo_root)
+    return result.returncode == 0
+
+
+def path_is_ignored(repo_root: Path, pathspec: str) -> bool:
+    result = run_git(["check-ignore", "--quiet", "--", pathspec], repo_root)
+    if result.returncode == 0:
+        return True
+    if result.returncode == 1:
+        return False
+    raise CheckpointError(format_git_error("GIT_CHECK_IGNORE_FAILED", result))
+
+
 def path_exists_or_tracked(repo_root: Path, pathspec: str) -> bool:
-    if (repo_root / pathspec).exists():
+    if path_is_tracked(repo_root, pathspec):
         return True
 
-    result = run_git(["ls-files", "--error-unmatch", "--", pathspec], repo_root)
-    return result.returncode == 0
+    if not (repo_root / pathspec).exists():
+        return False
+
+    return not path_is_ignored(repo_root, pathspec)
 
 
 def stage_paths(repo_root: Path, paths: list[str]) -> None:
@@ -167,7 +183,7 @@ def stage_paths(repo_root: Path, paths: list[str]) -> None:
     if not valid_paths:
         return
 
-    result = run_git(["add", "--", *valid_paths], repo_root)
+    result = run_git(["add", "-f", "--", *valid_paths], repo_root)
     if result.returncode != 0:
         raise CheckpointError(format_git_error("GIT_ADD_FAILED", result))